Работа с SSI
Материал из "ИНСИС": Ответы на часто задаваемые вопросы
SSI (Server Side Includes) — технология, позволяющая удобно «собирать» веб-страницы из частей, вставлять в них результаты выполнения CGI-скриптов и придавать страницам элементы динамики.
Содержание |
Как подключить услугу
Для того чтобы подключить SSl CGI для вашего домена войдите в панель управления - Хостинг - Администрирование. Перейдите в раздел Редактирование домена.
Затем поставьте галочки напротив SSl CGI.
Какие файлы обрабатываются как SSI. Как добавить свои файлы
По умолчанию веб-сервер проверяет на предмет наличия SSI-инструкций только файлы с расширением *.shtml. Например, поместите SSI-команды в файл index.shtml, и они сразу будут работать. Если есть необходимость проверять на наличие SSI другие файлы, соответствующие расширения для проверки можно добавить, поместив в файл .htaccess следующую инструкцию:
AddHandler server-parsed .ext
.ext — расширение файлов, которые должны проверяться на наличие в них SSI. Не рекомендуется добавлять расширения .html и .htm, так как в этом случае сервер будет проверять все html-файлы на предмет наличия SSI-вставок. Это может привести к совершенно бессмысленной нагрузке на сервер.
Как работает и для чего используется SSI
Технологию SSI начинающие пользователи в основном могут использовать для двух целей: для «склейки» страницы из частей html-кода и для запуска скриптов с целью размещения результатов их работы на создаваемой html-странице. В первом случае с диска сервера читаются соответствующие файлы и вставляются в код страницы, откуда был вызван SSI-код. Во втором случае веб-сервер, найдя SSI-инструкцию, запускает скрипт, размещенный на диске и вставляет в итоговую страницу результат выполнения скрипта.
Подробнее:
«Склейка» страницы из частей html-кода. Используется для того, чтобы не дублировать в множестве веб-страниц один и тот же html-код. Например, можно вынести весь дизайн в SSI-включения, которые подключать в конкретном html-файле, где будет содержаться только текст конкретной страницы.
Пример:
Поместим в файл header.inc «заголовок» веб-страницы (элементы дизайна, меню, нужные ссылки и другие элементы, которые присутствуют на всех страницах), а в файл footer.inc поместим нижнюю часть веб-страницы (завершающую часть дизайна). Далее создадим файл с именем index.shtml, который будет выглядеть так:
<!--#include file="header.inc"-->
А здесь будет основной текст страницы
<!--#include file="footer.inc"-->;
Предполагается, что в файлы-включения мы поместили html-код хотя бы вроде начальных/конечных тэгов <html>, <head>, <body> и так далее. В результате пользователь получит страницу, в которую будет сначала включено содержимое файла header.inc, далее слова «А здесь будет основной текст страницы» и затем содержимое файла footer.inc.
Такое использование SSI удобно с точки зрения отсутствия необходимости все время вставлять во вновь создаваемые страницы один и тот же html-код, а также с точки зрения удобства изменения основных элементов сайта — меняем в одном месте html-код, который сразу меняется на всех страницах по всему сайту.
Таким образом можно разместить на странице практически любую функциональность, которая доступна для написания на языке perl.
Например, у вас есть скрипт-счетчик, который показывает сколько посетителей заходило на вашу страницу, и находится он по адресу /cgi-bin/count.pl. Включим результат его работы в веб-страницу. Для этого в коде html-страницы разместим такой SSI-код:
<!--#include virtual="/cgi-bin/count.pl"-->
В итоге на странице, которую увидит пользователь будет размещен счетчик, который вывел скрипт /cgi-bin/count.pl.
Возможные ошибки при использовании SSI
Если при использовании SSI-команд на своих html-страницах вы увидели сообщение "[anerror occured while processing this directive]", это свидетельствует о возникновении ошибки при обработке SSI-инструкции веб-сервером.
Возможные причины возникновения такой ошибки:
- неверно задан путь к включаемому файлу/скрипту — такой файл не существует.
- неверно работает cgi-скрипт, который вы пытаетесь вставить в страницу.
Еще по теме
- Полный список команд SSI — сервер httpd.apache.org, англ. язык.
