Переменные окружения

24.09.2011

Влад Мержевич

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

При использовании SSI общий синтаксис вывода определенной переменной окружения будет следующий.

Некоторые переменные с их описанием перечислены в табл. 1. Заметьте, что все имена пишутся заглавными символами. Хотя это условие и необязательно, именно такая форма записи является традиционной и устоявшейся.

Табл. 1. Список переменных окружения
Переменная	Описание
DOCUMENT_ROOT	Путь к корневой папке сайта. Для локального веб-сервера значение может принимать вид z:/home/htmlbook.ru/www, а в других случаях зависит от операционной системы сервера и используемого программного обеспечения.
GATEWAY_INTERFACE	Версия CGI (Common Gateway Interface, общий шлюзовый интерфейс). Значение обычно равно CGI/1.1.
HTTP_ACCEPT	Типы файлов, которые способен принять браузер. В качестве значения возвращается список поддерживаемых MIME-типов разделенных между собой запятой, например: text/html, application/xhtml+xml.
HTTP_CONNECTION	Тип соединения браузера с веб-сервером. Так, значение keep-alive означает, что браузер поддерживает постоянное соединение с сервером. При этом в течение одного сеанса соединения разрешено делать несколько запросов. Повторного соединения в таком случае уже не происходит.
HTTP_HOST	Доменное имя сайта. Обычно различают имена с префиксом www (www.htmlbook.ru) и без него (htmlbook.ru). Переменная вернёт тот адрес сайта, который указан в адресной строке браузера.
HTTP_REFERER	Адрес страницы, с которой пользователь перешел на данный сайт, он еще называется реферер.
HTTP_USER_AGENT	Идентификатор используемого браузера и операционной системы. В качестве значения возвращается строка, содержащая ключевые слова. Например, следующая строка Mozilla/5.0 (Windows NT 6.1; WOW64; rv:6.0.2) Gecko/20100101 Firefox/6.0.2 говорит, что пользователь использует браузер Firefox 6.0.2 под операционной системой Windows 7.
QUERY_STRING	Запрос, который указан в адресной строке после вопросительного знака (?). Обычно пишется в форме «переменная=значение», где переменные разделяются между собой амперсандом (&). Так, при написании адреса http://htmlbook.ru/?id=5&slv=34 будет возвращено значение id=5&slv=34.
REMOTE_ADDR	IP-адрес посетителя сайта.
REQUEST_METHOD	Метод отправки данных на сервер. По умолчанию применяется метод GET.
REQUEST_URI	Адрес запрашиваемого документа. Отсчёт ведётся от корня сайта, т.е. для полного адреса http://htmlbook.ru/1.html вернется значение 1.html.
SERVER_ADDR	IP-адрес компьютера, на котором размещается сайт.
SERVER_ADMIN	Адрес электронной почты администратора сайта.
SERVER_NAME	Имя сервера.
SERVER_PORT	Порт, по которому ожидается получение данных.
SERVER_PROTOCOL	Протокол для получения и отправки данных. Значение обычно равно HTTP/1.1.
SERVER_SOFTWARE	Программное обеспечение установленное на сервере. Для веб-сервера Apache возвращается номер версии (Apache/2.2.4), а также версия PHP (PHP/5.3.3).

В примере 1 показано использование переменных окружения для отображения на веб-странице требуемой информации.

Пример 1. Вывод значения переменной DOCUMENT_ROOT

<!DOCTYPE html>
<html>
 <head>
  <meta charset="utf-8">
  <title>SSI</title>
 </head>
 <body>
  <p>Путь к корневой папке сайта: <!--#echo var="DOCUMENT_ROOT"--></p>
 </body>
</html>

В результате выполнения примера будет выведена следующая строка : Путь к корневой папке сайта: /home/htmlbook.ru/www.

Значения переменных окружения можно посмотреть с помощью программы на PHP, используя функцию phpinfo(), как показано в примере 2.

Пример 2. Использование phpinfo()

<?php
  phpinfo();
?>

В результате выполнения программы будет выведена таблица с разными параметрами, в том числе и переменными окружения в разделе «Apache Environment» (рис. 1).

Рис. 1. Apache Environment

Также можно написать программу на PHP, которая будет выводить все переменные окружения в виде таблицы (пример 3)..

Пример 3. Вывод переменных окружения

<?php
 print "<!DOCTYPE html>\n<html>\n<head><title></title></head>\n<body>\n";
 print "<table border=1>\n";
 foreach ($_SERVER as $a => $b) print "<tr><td>$a</td><td>$b</td></tr>\n";
 print "</table>\n";
 print "</body>\n</html>\n";
?>

SSI