SSI вставки на стороне сервера

<!--#set var="IMG" value="/0-img/diz/kozak-4.png"-->
<!--#echo var="IMG"-->
<link rel="canonical" href="https://<!--#echo var="SERVER_NAME" --><!--#echo var="REQUEST_URI" -->">
<!--#include virtual="/0-res/SSI/hed-only-rykami.htm"-->

Что может SSI?

• позволяет включать в текст страницы другие SSI-страницы,
• вызывать внешние CGI-скрипты,
• реализовывать условные операции (if/else),
• работать с переменными и т. п. (Хранить переменные можно в отдельном файле :fellow:)
• делать запросы в базу данных

Примеры использования SSI:

1. Вставка содержимого из другого файла:

<!--#include virtual="/aa-resurs/vstavku/header.htm"-->

1.2 Вывод служебной информации

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

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

2. Директивы SSI:

3. Условия в SSI:

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

3.1 Примеры условий по url:

Пример 1

<!--#if expr='v("DOCUMENT_NAME")=~/about.html/'-->
<a class="active" href="#">
<!--#else -->
<a href="about.html">
<!--#endif -->
About</a>

Пример 2

<!--#if expr="%{DOCUMENT_URI} =~ /product/"-->
Product path
<!--#else-->
Some other path
<!--#endif-->

3.3 Примеры условий по сравнению переменных:

Допустим переменная  GOROD равняется значению Киев
(<!--#set var="GOROD" value="Киев" -->)

пример 1:
<!--#if expr='v("GOROD")=~/nonnn/'--> //если перем. "GOROD" не равна значению "Киев"
Нет такого города    //сделается вывод этой строки
<!--#else -->  //а если значение другое чем "nonnn"
<!--#echo var="GOROD" --> //тогда сделать вывод переменной "GOROD"
<!--#endif --> //конец условия

пример 2:
<!--#if expr='v("GOROD") = "Киев"' -->  //если перем. "GOROD" равна "Киев"
<!--#else-->
<!--#echo var="GOROD" -->    //сделается вывод этой переменной. Можно любое слово
<!--#endif -->//конец условия

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

3.3. Если откуда-то пришел:

<!--#if expr='-R "10.0.0.0/8"' -->
from local net
<!--#else -->
from somewhere else
<!--#endif -->

3.4. Если переменная содержит:

В приведенном ниже примере будет напечатано «foo is bar», если для переменной foo установлено значение «bar».

<!--#if expr='v("foo") = "bar"' -->
<!--#else-->
foo is bar
<!--#endif -->

 Вывод рандомного текста:

Описание:

1 строка. Делаем конфиг временни для вывода только секунд.

2 строка. Пременной RND присваиваем текущую секунду
3. строка. Выводим в нужном месте эту секунду.

<!--#config timefmt="%S"-->
<!--#set var="RND" value="$DATE_LOCAL"-->
получаем число текущей секунды : <!--#echo var="RND"-->

Или через переменную которая сравнивает по числу:

<!--#config timefmt="%S" -->
<!--#set var="rand" value="$DATE_LOCAL" -->
<!--#if expr="$rand = /00/" -->
<!--#include virtual="rand_content_0.txt" -->
<!--#elif expr="$rand = /01/" -->
<!--#include virtual="rand_content_1.txt" -->
<!--#elif expr="$rand = /02/" -->
<!--#include virtual="rand_content_2.txt" -->
<!--#elif expr="$rand = /03/" -->
<!--#include virtual="rand_content_3.txt" -->
<!--#else -->
<!--#include virtual="fall_back_content.txt" -->
<!--#endif --> 

 Вывод содержимого для печати с браузера:

Ссылка на верстю для печати:
<a href="<!--#echo var="DOCUMENT_URI" -->?print ">Print this page</a> 

И сама часть текста для печати:
<!--#if expr="$QUERY_STRING = 'print'" -->
<p>Текст на печать</p>
<!--#else -->
<p>Текст на экране</p>
<!--#endif -->

Все примеры условных выражений:

*:belay:   "=" и "!=" имеют больший приоритет, чем "&&" и "||", а "!" имеет наивысший приоритет.

4. Вывод размера файла:

<!--#config sizefmt="abbrev"--><!--#fsize file="proba.html"--> 
Выводит размер файла в килобайтах: (17k)
<!--#config sizefmt="bytes"--><!--#fsize file="proba.html"--> 
Выводит размер файла в байтах (17,076)

5. Вывод даты и последней модификации файла или страницы где размещен сам код:

// document
<a href=pricelst.doc>Скачать Прайс</a>
<!--#config timefmt="%d.%m.%y" -->
(MS Word 6.0/95, <!--#flastmod virtual="pricelst.doc" -->)

// stranica
<!--#config timefmt="%G-%m-%d" -->
<p>Эта страница модифицирована: <!--#echo var="LAST_MODIFIED"--></p>

5.1 Выводим дату в Нужном формате:

Cтандартный вывод даты в SSI:

<!--#echo var="DATE_LOCAL" -->
или
<!--#echo var="DATE_GMT" -->

//пишем переменную
<!--#config timefmt="%G" -->
<!--#set var="YEAR" value="$DATE_LOCAL"-->

//В нужном месте вставляем
<!--#echo var="YEAR"-->

//Получение дня недели

<!--#config timefmt="%u" -->
<!--#set var="NUM_DAY" value="$DATE_LOCAL"-->
<!--#if expr="$NUM_DAY=1" -->
<!--#set var="DAY" value="понедельник" -->
<!--#elif expr="$NUM_DAY=2" -->
<!--#set var="DAY" value="вторник" -->
<!--#elif expr="$NUM_DAY=3" -->
<!--#set var="DAY" value="среда" -->
<!--#elif expr="$NUM_DAY=4" -->
<!--#set var="DAY" value="четверг" -->
<!--#elif expr="$NUM_DAY=5" -->
<!--#set var="DAY" value="пятница" -->
<!--#elif expr="$NUM_DAY=6" -->
<!--#set var="DAY" value="суббота" -->
<!--#else -->
<!--#set var="DAY" value="воскресенье" -->
<!--#endif -->

//Получение числа

<!--#config timefmt="%e" -->
<!--#set var="DATE" value="$DATE_LOCAL"-->

//Получение названия месяца

<!--#config timefmt="%m" -->
<!--#set var="NUM_MONTH" value="$DATE_LOCAL"-->
<!--#if expr="$NUM_MONTH=01" -->
<!--#set var="MONTH" value="января" -->
<!--#elif expr="$NUM_MONTH=02" -->
<!--#set var="MONTH" value="февраля" -->
<!--#elif expr="$NUM_MONTH=03" -->
<!--#set var="MONTH" value="марта" -->
<!--#elif expr="$NUM_MONTH=04" -->
<!--#set var="MONTH" value="апреля" -->
<!--#elif expr="$NUM_MONTH=05" -->
<!--#set var="MONTH" value="мая" -->
<!--#elif expr="$NUM_MONTH=06" -->
<!--#set var="MONTH" value="июня" -->
<!--#elif expr="$NUM_MONTH=07" -->
<!--#set var="MONTH" value="июля" -->
<!--#elif expr="$NUM_MONTH=08" -->
<!--#set var="MONTH" value="августа" -->
<!--#elif expr="$NUM_MONTH=09" -->
<!--#set var="MONTH" value="сентября" -->
<!--#elif expr="$NUM_MONTH=10" -->
<!--#set var="MONTH" value="октября" -->
<!--#elif expr="$NUM_MONTH=11" -->
<!--#set var="MONTH" value="ноября" -->
<!--#else -->
<!--#set var="MONTH" value="декабря" -->
<!--#endif -->

//Получение года

<!--#config timefmt="%G" -->
<!--#set var="YEAR" value="$DATE_LOCAL"-->

//Собственно вывод получившейся строки
<!--#echo var="DAY" -->
<!--#echo var="DATE" -->
<!--#echo var="MONTH" -->
<!--#echo var="YEAR"--> 

6. Отдельная часть кода для нужного браузера

<!--#if expr="$HTTP_USER_AGENT=/Mozilla\/4/ || $HTTP_USER_AGENT=/Mozilla\/5/" -->
Если версия браузера не ни же 4 или 5, то вывести вариант дизайна, использующий, например, DHTML
<!--#else -->
Здесь вывести простой дизайн
<!--#endif -->

7. Подсветить меню нанужной странице:

8. Как в SSI вставить фрейм?

<html>
<head>
...
<!--#include virtual="frame.html" -->
</head>
<body>
...
</body>
</html>

// Содержимое frame.html  :

<!--#if expr="$QUERY_STRING!=done && $HTTP_REFERER!=/your_domain\.ru/" -->
<frameset rows="150,*">
<frame name="NAVIGATION" src="/navigation.html">
<frame name="CONTENT" src="<!--#echo var="DOCUMENT_URI" -->?done">
</frameset>
<!--#endif -->

9.1  Параметр cmd
Запускает указанную командную строку с использованием локального интерпретатора.

<!--#exec cmd="команда"-->
Например, строка <!--#exec cmd="/usr/bin/date" --> исполняет Unix-команду date.

9.2 Параметр cgi

Выполняет CGI-программу и результат её выполнения вставляет в указанное место. В качестве параметра указывается адрес программы.

<!--#exec cgi="URL"-->

Использование директивы exec

<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>SSI</title>
</head>
<body>
<p>Всего прочитало эту страницу <!--#exec cgi="/counter.pl"-->
человек.</p>
</body>
</html>

В данном примере запускается программа counter.pl, написанная на Perl, которая подсчитывает число посетителей данной страницы и записывает его в файл или в базу данных. После этого результат отображается в месте, где стоит строка <!--#exec cgi="/counter.pl"-->.

10. Обработка формы в SSI:

Сама форма и сообщение о умпешной отправки находится в одном файле - contact.htm

<!--#if expr="$QUERY_STRING = 'submitted'" -->
<p>Спасибо Ваше письмо отправлено.</p>
<!--#else -->
<form method="post" action="feedback.php">
<input type="hidden" name="redirect" value="contact.shtml?submitted" />
.......
</form>
<!--#endif-->

11. Вывод разного содержимого для разных USER:

<!--#if expr="$REMOTE_USER = 'user1'" -->
Welcome user1, you will now be redirected to your personal page.
To access your page directly <a href="user1/page.shtml">click here</a>.
<!--#elif expr="$REMOTE_USER = 'user2'" -->
Welcome user2, you will now be redirected to your personal page.
To access your page directly <a href="user2/page.shtml">click here</a>.
<!--#else -->
Should you BE here? Problems email con@dom.com
<!--#endif --> 

* Параметр errmsg устанавливает сообщение, отображаемое при возникновении ошибок. По умолчанию выводится текст [an error occurred while processing this directive], но вы можете поменять его на свой, да ещё написав по-русски. Синтаксис следующий.

<!--#config errmsg="Сообщение об ошибке"-->

источники:

- модуль - Apache Module mod_include

- Все команды w3.org
- Википедия

- htmlbook.ru