Что такое SSI

Включение механизма Server-Side Includes

AddType text/html .shtml<br>
AddHandler server-parsed .shtml

AddHandler server-parsed .html

Options +Includes

Базовые директивы

<!--#element attribute=value attribute=value ... -->

• config - контролирует различные аспекты сканирования. Его атрибутами могут быть:
  
  
  
  1. errmsg - устанавливает сообщение, выводящееся при возникновении ошибки; в большинстве случаев целесообразно установить в пустую строку;
     

     Это стандартная ошибка при запуске скрипта, которого нет:
     <!--#exec cgi="/cgi-bin/nonexistence.pl"-->
     А теперь заменим сообщение об ошибке и повторим:
     <!--#config errmsg="Ошибка, пишите <a href=mailto:dh@null.ru>автору ошибки</a>"-->
     <!--#exec cgi="/cgi-bin/nonexistence.pl"--> <BR>
     Вывод:
     Это стандартная ошибка, возникающая при запуске скрипта, которого нет:
     [an error occurred while processing this directive]
     А теперь заменим сообщение об ошибке и повторим:
     Ошибка, пишите автору ошибки
     

     
     
  2. sizefmt - устанавливает формат, в котором будет выводиться размер файла. Формат соответствует передаваемому библиотечной функции strftime; Директива config sizefmt изменяет формат вывода размера файла.
     

     Размер файла этой страницы в килобайтах:
     <!--#config sizefmt="abbrev"-->
     <!--#fsize file="ssi.shtml"--> <BR>
     Размер файла этой страницы в байтах:
     <!--#config sizefmt="bytes"-->
     <!--#fsize file="ssi.shtml"--> <BR>
     Вывод:
     Размер файла этой страницы в килобайтах: 12k
     Размер файла этой страницы в байтах: 12,463

     
     
  3. timefmt - меняет формат вывода даты и времени.
     

     Время модификации файла этой страницы в секундах с 01.01.1970:
     <!--#config timefmt="%s"-->
     <!--#flastmod file="ssi.shtml"--> <BR>
     Время модификации файла этой страницы в читабельном виде:
     <!--#config timefmt="%d.%m.%Y %H:%M:%S"-->
     <!--#flastmod file="ssi.shtml"--> <BR>
     
     Вывод:
     Время модификации файла этой страницы в секундах с 01.01.1970: 961590693
     Время модификации файла этой страницы в читабельном виде: 21.06.2000 16:31:33

     
     
  
  Параметры, используемые в 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

  
  
  
• echo - выводит значение установленной переменной SSI. Допустимым атрибутом является var.
  

  Твой IP - <!--#echo var="REMOTE_ADDR"--> <BR>
  Твой броузер - <!--#echo var="HTTP_USER_AGENT"--> <BR>
  Мой сервер - <!--#echo var="SERVER_NAME"--> <BR>
  Ты пришел со страницы - <!--#echo var="HTTP_REFERER"--> <BR>
  

  
  
• fsize - выводит размер файла в определенном с помощью sizefmt формате. Допустимые атрибуты:
  
• file - определяет путь к файлу, относительно сканируемого документа;
  
• virtual - определяет стандартный кодированный URL, относительно сканируемого документа, или, при наличии в начале слеша (/) - относительно корня документов узла.
  
• flastmod - выводит дату последней модификации файла в определенном с помощью timefmt формате. Атрибуты аналогичны атрибутам fsize.
  
• include - включает текст другого документа или файла в сканируемый файл. К включаемому файлу применяются все установленные правила ограничения доступа. Если для каталога, из которого включается файл, установлена опция IncludesNOEXEC, и включение данного документа привело бы к запуску программы, то документ не включается, и выводится сообщение об ошибке. CGI сценарии вызываются, как обычно с помощью URL, который может содержать кодированную строку запроса (query string). Положение файла указывается с помощью атрибутов:
  
  
  
  • file - указывает путь, относительно сканируемого документа; путь не может содержать ../ и не может быть абсолютным путем; всегда предпочтительнее использовать атрибут virtual;
    
  • virtual - содержит кодированный URL, относительный или абсолютный; URL не может содержать имя протокола или имя хоста, и может содержать строку запроса.
    
  
  
• printenv - выводит содержимое переменных окружения. Вызывается без параметров.
  
• set - устанавливает значение переменной. Ее атрибутами являются var, определяющий имя переменной, и value, определяющий ее значение.
  

Переменные включения

• DATE_GMT - текущее время по Гринвичу;
  
• DATE_LOCAL - текущее локальное (для сервера) время;
  
• DOCUMENT_NAME - имя файла (без каталогов) документа, запрошенного пользователем;
  
• DOCUMENT_URI - декодированный URL запрошенного пользователем документа;
  
• LAST_MODIFIED - дата последней модификации документа, запрошенного пользователем. То есть во вложенном SSI эта переменная будет содержать имя "главного" документа, а не вложенного.
  

Подстановка переменных

<!--#if expr="$a = $test" -->

<!--#set var="Zed" value="${a}bc_${abc}" -->

Условные операторы

<!--#if expr="test_condition" -->
<!--#elif expr="test_condition" -->
<!--#else -->
<!--#endif -->

• string - истинно, если string не пуста;
  
• string1 = string2
  
• string1 != string2
  
• string1 < string2
  
• string1 <= string2
  
• string1 > string2
  
• string1 >= string2
  

• ( test_condition ) - истинно, если test_condition истинно;
  
• ! test_condition - истинно, если test_condition ложно;
  
• test_condition1 && test_condition2 - истинно, если как test_condition1, так и test_condition2 истинны;
  
• test_condition1 || test_condition2 - истинно, если хотя бы test_condition1 или test_condition2 истинно.
  
• "=" и "!=" имеют больший приоритет, чем "&&" и "||", а "!" имеет наивысший приоритет.