Директивы SSI

Приведем список основных директив (инструкций) SSI.

#config errmsg

Задает текст сообщения об ошибке. Этот текст выводится на страницу, когда происходит ошибка запуска скрипта, синтаксическая ошибка директивы SSI, запрашивается не существующий файл. По умолчанию выводится текст: "[an error occurred while processing this directive]". Пример:

<!--#config errmsg="В ходе выполения директивы произошла ошибка" -->

Этот пример при возникновении ошибки выводит соответствующее сообщение.

#config sizefmt

Эта директива определяет формат выдачи размера файла (в байтах или в аббревиатуре байтов, килобайтов или мегабайтов). Используется вместе с директивой определения размера файла #fsize file. Пример:

Size of file.txt:
<!--#config sizefmt="abbrev" -->
<!--#fsize file="file.txt" -->
<!--#config sizefmt="bytes" -->
(<!--#fsize file="file.txt" -->)

Этот пример выводит сообщение в виде: Size of file.txt: 37K (38,249)

#config timefmt

Определяет формат выдачи даты последнего обновления файла (команда #flastmod file). Пример:

<!--#config timefmt="%d.%m.%Y %T" -->
Last modified:
<!--#flastmod file="file.txt" -->

Эти директивы выводят дату последнего изменения файла file.txt в виде: Last modified: 05.04.2005 15:11:13. Подробнее о всех видах формата времени описано здесь.

#exec cgi

Эта директива запускает указанный скрипт и вставляет в документ текст выдачи скрипта. Пример:

<!--exec cgi="cgi-bin/script.cgi" -->

#exec cmd

Запускает команду и вставляет в документ текст выдачи этой команды. Пример:

<!--exec cmd="date.txt" -->

#flastmod file

Выводит дату последнего изменения файла. Формат даты определяется инструкцией #config datefmt. Пример:

Last modified:
<!--#flastmod file="file.txt" -->

Этот пример выводит строчку вида: Last modified: Tuesday, 05-Apr-2005 15:11:13.

#fsize file

Выводит размер файла. Формат значения (в байтах или килобайтах) задается инструкцией #config sizefmt. Можно указывать путь к файлу. Пример:

<!--#fsize file="src/file.txt" -->

Этот код выводит размер файла file.txt.

#include file

Вставляет файл из текущей директории. Пример:

<!--#include file="file.txt" -->

Загрузка содержимое файла file.txt.

#include virtual

Эта команда позволяет вставлять файл из другой папки. Пример:

<!--#include virtual="src/file.txt" -->

Этот код вставляет содержимое файла file.txt из директории src. Указываются относительные пути к файлу.

#printenv

Выводит названия и значения всех переменных окружения (environment variable). Пример:

<!--#printenv -->

Список переменных окружения можно посмотреть здесь.