SSI

2000 г

SSI

SSI расшифровывается как Server Side Include. SSI - это набор команд, позволяющий включить в страницу информацию, недоступную средствами HTML, такую как вывод программ, значения переменных окружения и статистику по файлам (размер, дата создания и др.). Все это и более позволяют делать CGI-скрипты, но зачем писать целый скрипт для получения размера файла, если можно воспользоваться SSI?:)

SSI работает очень просто: при получении запроса на документ, содержащий SSI-директивы, http-сервер обрабатывает документ, выполняет все SSI-директивы, а получившийся в результате документ возвращает клиенту. Http-сервер не проверяет автоматически все документы на наличие SSI-директив, а только те, которые относятся к типу, указанному в настройках сервера.

Для указания http-серверу, какие документы считать содержащими SSI-директивы, в srm.conf, находящемся в /etc/httpd/conf надо раскомментировать следующие строки:

AddType text/html .shtml AddHandler server-parsed .shtml

После этого все документы с расширением .shtml будут проверяться на SSI-директивы. Но удобнее будет определить чтобы все .html-файлы могли содержать SSI. Это делается добавление в srm.conf следующих строчек:

AddType text/html .html # не обязательно, т.к. он и так описан. AddHandler server-parsed .html

Теперь надо разрешить выполнение SSI в каталоге, в котором лежат твои файла. Найди в access.conf описание каталога, в котором лежат твои html'ы и добавь в его Options директиву Includes:

#было так Options Indexes #стало так Options Indexes Includes

Если твой каталог не прописан, его надо прописать. Почитай доку по Apache, чтоб узнать как это делается.:) А если у тебя нет возможности изменять srm.conf или access.conf, т.е. ты не root, тогда за пивом, а потом к админу.:)

SSI-директивы включаются в html-код в виде коментариев, но определенного формата:

Использовать можно следующие SSI-директивы:

echo var

Используется для вывода значения переменной окружения.

Твой IP -  Твой броузер -  Мой сервер -  Ты пришел со страницы -  

А вот вывод:

Твой IP - 38.107.179.229 Твой броузер - CCBot/1.0 (+http://www.commoncrawl.org/bot.html) Мой сервер - citforum.oldbank.com Ты пришел со страницы - (none)

include file include virtual

Включает в html-файл в месте, где идет вызов SSI, содержимое указанного файла. Отличие include file от include virtual в том, что в первом случает используется файл, находящийся в том же каталоге, что и html-файл, во втором случает указывается путь к файлу относительно текущего каталога. Если с помощью include file или include virtual включается cgi-скрипт, то в содержимое страницы попадет вывод cgi-скрипта, а не его содержание.

fsize file

Вставляет размер указанного файла.

Размер файла этой страницы:  

Вывод:

Размер файла этой страницы: 12K

flastmod file

Вставляет время последней модификации указанного файла.

Время последней модификации файла этой страницы:  

Вывод:

Время последней модификации файла этой страницы: Monday, 29-Dec-2003 00:00:00 EET

exec cmd exec cgi

Запускает внешнюю программу (exec cmd) или cgi-скрипт (exec cgi) и вставляет в содержимое страницы вывод.

config errmsg config sizefmt config timefmt

Изменяет различный параметры конфигурации SSI. config errmsg изменяет стандартное собщение об ошибке на введенное пользователем. Сообщение об ошибке возникает при неправильном выполнении SSI-директивы, например при отсутствии cgi-скрипта, который ты пытаешься запустить.

Это стандартная ошибка при запуске скрипта, которого нет:  А теперь заменим сообщение об ошибке и повторим:   

Вывод:

Это стандартная ошибка, возникающая при запуске скрипта, которого нет: [an error occurred while processing this directive] А теперь заменим сообщение об ошибке и повторим: Ошибка, пишите автору ошибки

Директива config sizefmt изменяет формат вывода размера файла.

Размер файла этой страницы в килобайтах:   Размер файла этой страницы в байтах:   

Вывод:

Размер файла этой страницы в килобайтах: 12K Размер файла этой страницы в байтах: 12,500

Директива config timefmt меняет формат вывода даты и времени.

Время модификации файла этой страницы в секундах с 01.01.1970:   Время модификации файла этой страницы в читабельном виде:   

Вывод:

Время модификации файла этой страницы в секундах с 01.01.1970: 1072648800 Время модификации файла этой страницы в читабельном виде: 29.12.2003 00:00:00

Параметры, используемые в config timefmt:

Формат	Описание	Пример
%a	Аббревиатура названия дня недели	Sun
%A	Полное название дня недели	Sunday
%b	Аббревиатура названия месяца	Jan
%B	Полное название месяца	January
%d	День месяца	01 (не 1)
%D	Дата в формате "%m/%d/%y"	01/31/90
%e	День месяца	1
%H	Часы в 24-часовом формате	13
%I	Часы в 12-часовом формате	01
%j	День года	235
%m	Номер месяца	01
%M	Минуты	03
%p	AM\|PM	AM
%r	Время в формате "%I:%M:%S %p"	11:35:46 PM
%S	Секунды	34
%s	Время в секундах с 01.01.1970	957228726
%T	Время в формате "%H:%M:%S"	14:05:34
%U	Неделя года	49
%w	Номер дня недели	5
%y	Год в формате ГГ	95
%Y	Год в формате ГГГГ	1995
%Z	Временная зона	MSK

printenv

Выводит все переменные окружения. Параметров не имеет.

Список переменных окружения: 

Вывод:

Список переменных окружения: HTTP_X_CC_ID=ccc03-01 HTTP_HOST=citforum.oldbank.com HTTP_USER_AGENT=CCBot/1.0 (+http://www.commoncrawl.org/bot.html) HTTP_ACCEPT=text/html,application/xhtml+xml,text/xml;q=0.9,text/plain;q=0.8,image/png,*/*;q=0.5 HTTP_ACCEPT_LANGUAGE=en-us,en;q=0.5 HTTP_ACCEPT_ENCODING=gzip HTTP_ACCEPT_CHARSET=ISO-8859-1,utf-8;q=0.7,*;q=0.7 HTTP_CONNECTION=close HTTP_CACHE_CONTROL=no-cache HTTP_PRAGMA=no-cache PATH=/usr/local/bin:/usr/bin:/bin SERVER_SIGNATURE=<address>Apache/2.2.14 (Ubuntu) Server at citforum.oldbank.com Port 80</address> SERVER_SOFTWARE=Apache/2.2.14 (Ubuntu) SERVER_NAME=citforum.oldbank.com SERVER_ADDR=193.41.239.6 SERVER_PORT=80 REMOTE_ADDR=38.107.179.229 DOCUMENT_ROOT=/var/www-clients/citforum.oldbank.com SERVER_ADMIN=uralow@oldbank.com SCRIPT_FILENAME=/var/www-clients/citforum.oldbank.com/internet/html/ssi.shtml REMOTE_PORT=48489 GATEWAY_INTERFACE=CGI/1.1 SERVER_PROTOCOL=HTTP/1.1 REQUEST_METHOD=GET QUERY_STRING= REQUEST_URI=/internet/html/ssi.shtml SCRIPT_NAME=/internet/html/ssi.shtml DATE_LOCAL=21.05.2012 20:10:27 DATE_GMT=21.05.2012 17:10:27 LAST_MODIFIED=29.12.2003 00:00:00 DOCUMENT_URI=/internet/html/ssi.shtml USER_NAME=ftp DOCUMENT_NAME=ssi.shtml QUERY_STRING_UNESCAPED=

set var

Устанавливает значение переменной окружения. Формат такой set var="ИМЯ_ПЕРЕМЕННОЙ" value="ЗНАЧЕНИЕ".

Значение переменной SERVER_NAME:  Сменим значение:  Значение переменной SERVER_NAME:  

Вывод:

Значение переменной SERVER_NAME:citforum.oldbank.com Сменим значение: Значение переменной SERVER_NAME: www.dhls.ru

if/else

Наличие такой команды не может не радовать...:) Применяется для управления выводом страницы по условию. Синтаксис такой:

 HTML-код, который будет выводиться, если УСЛОВИЕ1 истинно <--#elif expr="УСЛОВИЕ2" --> HTML-код, который будет выводиться, если УСЛОВИЕ1 ложно, а УСЛОВИЕ2 истинно <--#else --> HTML-код, который будет выводиться, если все условия ложны <--#endif -->

Условие - это либо строка, которая является истинной, если непустая, или набор операторов сравнения строк. Операторы могут быть =,!=,<,<=,> и >. Если вторая строка заключена в "/"(слэши), то условие истинно, если в первой строке встречается хоть одно вхождение второй строки. Можно объединять несколько операторов сравнения с помощью операторов &&(И) и ||(ИЛИ). Для группирования условий используются "()"(скобки).

Броузер:  Netscape Navigator  Internet Explorer  Неизвестный ()  

Вывод:

Броузер: Неизвестный (CCBot/1.0 (+http://www.commoncrawl.org/bot.html))

(c)Ерижоков А.А., 2000.
Использование данного документа разрешено только с согласия автора и с указанием первоисточника: DH's Linux Site