Server Side Includes

Server Side Includes - включения на стороне сервера. SSI представляет механизм включения одних документов внутрь других. Чем-то это схоже с фреймами по функциональному назначению, но есть существенные отличия. Во-первых, включать в один HTML-документ можно любой файл с HTML-кодом, совершенно не обязательно, чтобы он(HTML-код) представлял собой законченный HTML-документ. Например, у вас часть таблицы может быть в одном файле, часть в другом, а еще часть в третьем. Во-вторых, включать можно программы, которые, в свою очередь, могут связываться с базами данных, вызывать внутри себя другие программы и выдавать какие-либо отчеты и таблицы. Естественно, что эти программы выдают на STDOUT( поток стандартного вывода, для не программистов это экран монитора с командной строкой ) HTML-код, который затем и включается внутрь нашего исходного HTML-документа. И в третьих, SSI поддерживают переменные и элементарные инструкции языка программирования: if, elif и else. Server Side Includes работают следующим образом. У вас на сервере находится html-файл с командами SSI.

<p align=justify> Веб-студия ITSoft состоит из молодых специалистов, работающих в области информационных технологий более пяти лет. Мы занимаемся веб-дизайном, разработкой программного обеспечения, предоставляем услуги хостинга и создания локальных сетей.

Когда броузер клиента запрашивает у веб-сервера этот документ, то веб-сервер, прежде чем отдать его броузеру проверяет его на наличие SSI-команд. Когда веб-сервер встретит  он запустит программу /cgi-bin/head.pl и передаст ей параметр name=О нас. Программа head.pl выдаст HTML-код с заголовком для нашего HTML-документа, в котором будет содержаться меню и название раздела. О том, как писать такие программы вы узнаете в третей части книги. Когда веб-сервер натолкнется на , то он просто включит HTML-код из файла /include/footer.inc в наш HTML-документ.
Там, собственно, хранится код завершающий любую HTML-страницу нашего веб-сайта. Таким образом, SSI позволяет избежать избыточности. Общий код для всех HTML-страниц нашего сайта хранится в одном месте. Теперь, если нам захочется добавить пункт меню или поменять что-либо еще, то нам не придется бегать по всему сайту и изменять каждый файл отдельно. Достаточно будет внести изменения в один файл. Для того чтобы начать экспериментировать с SSI-командами надо внести изменения в файл httpd.conf и перезапустить веб-сервер Apache. Найдите и раскомментируйте следующие две строчки в файле httpd.conf. Они указывают веб-серверу, что файлы с расширением shtml надо обрабатывать прежде, чем выдавать пользователю.

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

Если вы собираетесь повсеместно использовать SSI, то добавьте еще и такую строчку. У нас SSI-команды присутствуют в большинстве HTML-документов, поэтому на нашем веб-сервере такая строчка присутствует в файле httpd.conf

AddHandler server-parsed .html

HTML-код для включения в HTML-документы обычно хранится в файлах с расширением inc. Включите и для этих файлов обработку SSI-директив. Это позволит делать рекурсивную обработку SSI-директив. Если в файле footer.inc будет SSI-директива, то она будет обработана.

AddHandler server-parsed .inc

Еще может потребоваться добавить опцию Includes в следующий раздел.

<Directory /> Options FollowSymLinks Indexes MultiViews Includes AllowOverride All </Directory>

На нашем сервере под управлением FreeBSD такая опция стоит. У меня дома на Windows98 ее нет и SSI работают. Возможно тут дело в различных версиях Apache.

Теперь перезапустите веб-сервер. Давайте рассмотрим SSI еще на одном примере, заодно разберем одну из самых распространенных структур организации HTML-документов. На большинстве сайтов, документы состоят из трех частей: заголовок, тело и завершающая часть. Для эксперимента создайте директорию на вашем веб-сайте и назовите ее ssi. В этой директории создайте head.inc со следующим содержанием:

<html> <body>

<table bgcolor=#0000FF width=600 height=100> <tr><td> Здесь будет заголовок и главное меню нашего вебсайта </table>

<table width=600 height=200> <tr><td width=120 bgcolor=#CCCCCC> Левое меню<br> пункт1<br> пункт2<br> пункт3<br> пункт4<br> пункт5<br> <td>

Все SSI-директивы имеют следующую семантику  Создайте index.html:

 Основное содержание HTML-документа. 

И footer.inc:

</table>

<table bgcolor=#0000FF width=600> <tr><td> Здесь будет завершающая часть HTML-документа, обычно это реклама </table>

</body> </html>

В результате, при запросе этого документа, веб-сервер выдаст:

<html> <body>

<table bgcolor=#0000FF width=600 height=100> <tr><td> Здесь будет заголовок и главное меню нашего вебсайта </table>

<table width=600 height=200> <tr><td width=120 bgcolor=#CCCCCC> Левое меню<br> пункт1<br> пункт2<br> пункт3<br> пункт4<br> пункт5<br> <td>

Основное содержание HTML-документа. </table>

<table bgcolor=#0000FF width=600> <tr><td> Здесь будет завершающая часть HTML-документа, обычно это реклама </table>

</body> </html>

Это одно из самых основных применений SSI. Теперь давайте рассмотрим использование переменных и условных операторов. Команда  выводит все переменные окружения, которые доступны по умолчанию. Ниже приведен результат действия этой команды на моем домашнем компьютере.

COMSPEC=C:\WINDOWS\COMMAND.COM DOCUMENT_ROOT=c:/projects/www/web-tehnolog HTTP_ACCEPT=*/* HTTP_ACCEPT_ENCODING=gzip, deflate HTTP_ACCEPT_LANGUAGE=ru HTTP_CONNECTION=Keep-Alive HTTP_COOKIE=testparam=testvalue HTTP_HOST=web.ru HTTP_USER_AGENT=Mozilla/4.0 (compatible; MSIE 5.0; Windows 98; DigExt) PATH=C:\Program Files\Apache Group\Apache;C:\WINDOWS;C:\WINDOWS\COMMAND; C:\ARCH;C:\JDK12\BIN;C:\PROGRA~1\ULTRAE~1 REMOTE_ADDR=127.0.0.1 REMOTE_PORT=1546 SCRIPT_FILENAME=c:/projects/www/web-tehnolog/chapter6.html SERVER_ADDR=127.0.0.1 SERVER_ADMIN=igor@itsoft.ru SERVER_NAME=web.ru SERVER_PORT=80 SERVER_SIGNATURE=Apache/1.3.12 Server at web.ru Port 80

SERVER_SOFTWARE=Apache/1.3.12 (Win32) WINDIR=C:\WINDOWS GATEWAY_INTERFACE=CGI/1.1 SERVER_PROTOCOL=HTTP/1.1 REQUEST_METHOD=GET QUERY_STRING= REQUEST_URI=/chapter6.html SCRIPT_NAME=/chapter6.html DATE_LOCAL=Monday, 26-Feb-2001 19:26:02 Московское время (зима) DATE_GMT=Monday, 26-Feb-2001 16:26:02 GMT LAST_MODIFIED=Monday, 26-Feb-2001 19:25:58 Московское время (зима) DOCUMENT_URI=/chapter6.html DOCUMENT_PATH_INFO= DOCUMENT_NAME=chapter6.html

Для того чтобы вывести значение отдельной переменной дайте команду . Например,  выдаст Monday, 26-Feb-2001 19:25:58 Московское время (зима).

Также вы можете определять и использовать свои собственные переменные. В файл index.html, который мы рассматривали выше, вставьте самой первой строкой . В head.inc добавьте следующую строчку <title></title> после команды <html> и где идут слова "здесь будет заголовок" вставьте <h1></h1>

В результате у вас должно получится для index.html

  Основное содержание HTML-документа. 

и

<html> <title></title> <body>

<table bgcolor=#0000FF width=600 height=100> <tr><td><h1></h1> главное меню нашего веб-сайта </table>

<table width=600 height=200> <tr><td width=120 bgcolor=#CCCCCC> Левое меню<br> пункт1<br> пункт2<br> пункт3<br> пункт4<br> пункт5<br> <td>

Таким образом можно передавать параметры во включаемые куски HTML-кода.

Дурным стилем сайтостроительства считается наличие в документе гиперссылок на этот же документ. Ссылаться на самого себя неразумно - пользователь от нажатия на гиперссылку ожидает, что загрузится другая страница, а также такого рода ссылки доставляют большие неудобства пользователям каналов с низкой пропускной способностью. Такие ссылки на себя часто получаются при включении колонтитулов. Для того чтобы избежать таких ссылок, оформляйте каждый пункт меню в колонтитулах следующим образом:

Пример для графического меню с подсветкой:

<a href=/about.html onMouseOut="MM_swapImgRestore()" onMouseOver="MM_swapImage('about','','/about2.gif',0)" ><img src=/about1.gif width=212 height=38 border=0 name=about ></a >

Данный SSI-код используется на сайте .

Другой не менее важный SSI-код применяется для организации версии страниц для печати. Версия страницы сайта для печати отличается от обычной страницы отсутствием колонститулов, навигации, баннеров и прочей лишней информации. Рассмотрим, как организована версия для печати на примере сайта .

===Файл /include/head.inc === <html> <head> <title></title> <meta http-equiv="Content-Type" content="text/html; charset=windows-1251"> <link rel=stylesheet href=/styles.css> </head>

<body bgcolor=FFFFFF text=474C54 link=566A89 vlink=96A7C1 leftmargin=0 topmargin=0 marginwidth=0 marginheight=0> <basefont face=Arial>

 ...здесь навигационный блок, графика, Flash-анимация и т.д. ...

<p > <a href=?for_printing=1&> Версия для печати </a></p> 

При нажатии на гиперссылку "версия для печати" страница, на которой находится пользователь, перегружается.

Но поскольку в строке запроса присутствует параметр for_printing, то лишний HTML-код не включается на страницу. Обратите внимание . Это строка запроса CGI-параметров. В обычном случае, у вас никаких параметров, кроме for_printing нет, но когда появляются на сайте CGI-модули, то появляются и дополнительные параметры. Забегая вперед расскажу, как делать "Версию для печати" В CGI-программе. Пока веб-сервер Apache не может обрабатывать на SSI-директивы вывод CGI-программ. Такую возможность обещают в новых версиях Apache. У CGI-программистов есть два пути либо самим разобрать SSI-директивы в файле head.inc либо, что значительно проще, создать ручками файл phead.inc и подключать его в CGI-программах.

Условные операторы записываются следующим образом:

      

Для примера приведу SSI-код для вывода времени последней модификации документа в приемлемом виде. Как вы уже видели, команда  выдает совершенно не приемлемую строчку - Monday, 26-Feb-2001 19:25:58 Московское время (зима), для размещения ее на солидном веб-сайте. Нам бы хотелось получить что-нибудь, вроде 26 Февраля 2001 года. Для этого существует команда config с параметром timefmt, которая задает формат вывода даты. Например, в нашем случае нам требуется следующий вариант , тогда результат  будет 26 February 2001. Но это пока все равно не то, что бы нам хотелось. Для определения месяца мы воспользуемся условными операторами. Вот, как будет выглядеть этот код:

                          

Соответственно, чтобы получить дату в формате 26 Февраля 2001.

  

Вот полный список значение параметра 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

Далее приведены несколько полезных SSI-директив. Допустим, вы распространяете какие-либо утилиты и выкладываете ссылки на файлы для скачивания. Например, такие ссылки вы найдете на сайте . Для удобства пользователей неплохо было бы указать размер файла и иногда, дату его последней модификации. Каждый раз после выкладывания на сервер новых версий файла, модифицировать самому ручками все размеры и даты долго и мучительно. Server Side Includes приходят на помощь.

<a href=0.gif>Прозрачный gif-файл</a><br> Дата модификации: <br> Размер:  байта<br>

Дата модификации: 12 February 2002

Размер: 43 байта

Если у вас файлы больших размеров, то информацию лучше выводить в килобайтах.

Для этого установите формат вывода размера файла следующим образом.



При возникновение какой-либо ошибки, например, при попытки включить в HTML-документ файл, которого не существует веб-сервер выдаст следующее сообщение:

[an error occurred while processing this directive]

Сообщение не слишком информативно и пугает пользователя, не так ли? Давайте изменим сообщение об ошибке следующей SSI-директивой



Теперь сообщение об ошибке вылядит так:

На сервере произошла ошибка связанная с SSI, пожалуйста, напишите .

Содержание раздела