Html змінні оточення. Windows та Denwer

Коли браузер запитує від веб-сервера документ, він також надсилає на сервер технічну інформацію про певні параметри браузера та операційної системи. Веб-сервер одночасно з документом повертає деякі свої характеристики. Таким чином, браузер та веб-сервер обмінюються даними, які називаються змінні оточення. Ці змінні можна використовувати у своїх цілях та відображати їх на веб-сторінці.

При використанні SSI загальний синтаксис виведення певної змінної оточення буде наступним.

Деякі змінні з їх описом наведено в табл. 1. Зауважте, що всі імена пишуться великими символами. Хоча ця умова й необов'язково, саме така форма запису є традиційною та усталеною.

Табл. 1. Список змінних оточення

Змінна	Опис
DOCUMENT_ROOT	Шлях до кореневої папки сайту. Для локального веб-сервера значення може набувати вигляду z:/home/сайт/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..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	Запит, який вказаний в адресному рядку після знака запитання (?). Зазвичай пишеться у формі «змінна = значення», де змінні поділяються між собою амперсандом (&). ?
REMOTE_ADDR	IP-адреса відвідувача сайту.
REQUEST_METHOD	Метод надсилання даних на сервер. За промовчанням застосовується метод GET.
REQUEST_URI	Адреса запитуваного документа. Відлік ведеться від кореня сайту, тобто..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

SSI

Шлях до кореневої папки сайту:

В результаті виконання прикладу буде виведено наступний рядок: Шлях до кореневої папки сайту: /home/сайт/www.

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

Приклад 2. Використання phpinfo()

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

Мал. 1. Apache Environment

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

Приклад 3. Висновок змінних оточення

\n \n \n \n"; print "

\n"; foreach ($_SERVER як $a => $b) print " \n"; print "

\n"; print "

\n\n"; ?>

Безпосередньо перед запуском сценарію сервер передає йому певні змінні оточення з інформацією. У певних змінних містяться деякі заголовки, але не всі (отримати всі заголовки не можна).

HTTP_ACCEPT- У цій змінній перераховані всі MIME-типи даних, які можна сприйняти браузером. Рядок */* означає, що браузер розуміє будь-який тип.

HTTP_ACCEPT= */*

HTTP_REFERER- Ця змінна представляє відомості про сторінку, на якій користувач потрапив на дану. Цю змінну можна використовувати, наприклад, для відстеження переміщення користувача на вашому сайті, а потім переглядати найбільш популярні маршрути.

HTTP_REFERER= http://www.spravkaweb.ru/

HTTP_COOKIE- У цій змінній зберігаються всі Cookies в URL-кодуванні.

HTTP_COOKIE=

HTTP_USER_AGENT- Ідентифікує браузер користувача. Для встановлення типу браузера потрібно перевірити цей рядок на наявність слів: якщо браузер - Internet Explorer, то буде присутній підрядок MSIE, а якщо є лише слово Mozilla, то це Netscape.

HTTP_USER_AGENT= Mozilla/4.0 (compatible; MSIE 5.0; Windows NT 4.0)

У вас Internet Explorer

HTTP_HOST- Містить доменне ім'я Web-сервера, на якому запустився сценарій. Цю змінну досить зручно використовувати, наприклад, для генерації повного шляху, який потрібно заголовку Location, щоб не прив'язуватися до конкретного сервера.

HTTP_HOST= www.spravkaweb.ru

HTTP_FROM- Адреса електронної пошти користувача, який направив запит.

HTTP_FROM=

SERVER_NAME- Доменне ім'я або IP-адреса сервера.

SERVER_NAME= www.spravkaweb.ru

SERVER_SOFTWARE- Ім'я та версія програми-сервера, що відповідає на запит клієнта.

SERVER_SOFTWARE= Apache/1.3.33 (Unix) mod_jk/1.2.8 mod_auth_passthrough/1.8 mod_log_bytes/1.2mod_bwlimited/1.4 FrontPage/5.0.2.2635 mod_ssl/2.8.22 OpenSSL/0.9.7

SERVER_PORT- Ця змінна містить порт сервера, до якого звернувся браузер користувача. Зазвичай це 80. Змінна також може застосовуватися для формування параметра заголовка Location.

SERVER_PORT= 80

SERVER_PROTOCOL- Змінна містить ім'я та версію інформаційного протоколу, використаного для запиту.

SERVER_PROTOCOL= HTTP/1.0

REMOTE_ADDR- Ця змінна містить IP-адресу (або доменне ім'я) вузла користувача, на якому було запущено браузер.

REMOTE_ADDR= 212.94.114.177

REMOTE_PORT- Порт, який закріплюється за браузером користувача, щоб отримати відповідь сервера.

REMOTE_PORT= 4277

REMOTE_USER- Ідентифікаційне ім'я користувача, що надсилає запит.

REMOTE_USER=

SCRIPT_NAME- Містить ім'я файлу, що містить цей сценарій. Цю змінну зручно використовувати для формування заголовка Location при переадресації він (self-redirect), і навіть підставлення значення атрибута action тега

на сторінці, яку викликає сценарій під час запуску без параметрів (щоб не прив'язуватися до конкретного імені сценарію).

SCRIPT_NAME=/pril.php

DOCUMENT_ROOT- Кореневий каталог дерева Web-документів.

DOCUMENT_ROOT=/home/spravka/public_html

REQUEST_METHOD- Метод, який застосовує користувач під час передачі даних. Слід зауважити, що грамотно складений сценарій повинен сам визначати на основі цієї змінної, який метод задіяний користувач, і приймати дані з відповідного джерела, а не розраховувати, що передача здійснюватиметься, наприклад, лише методом POST.

REQUEST_METHOD= GET

QUERY_STRING- Містить параметри, які в URL вказані після знака запитання. Нагадаємо, що вони доступні як за методом GET, так і за методом POST (якщо в останньому випадку вони були визначені в атрибуті action тега ).

QUERY_STRING= ss=getenv

PATH_INFO- Містить додаткову інформацію про шлях.

PATH_INFO=

PATH_TRANSLATED- Та сама інформація, що й у змінній PATH_INFO з префіксом, що задає шлях до кореневого каталогу дерева Web-документів.

PATH_TRANSLATED=

CONTENT_TYPE- Медіа тип даних запиту.

CONTENT_TYPE=

CONTENT_LENGTH- Повертає кількість байт даних, надісланих користувачем. Цю змінну необхідно аналізувати, якщо ви займаєтеся прийомом та обробкою POST-форми.

GATEWAY_INTERFACE- версія CGI, яку використовує сервер.

GATEWAY_INTERFACE= CGI/1.1

Змінні оточення

Змінні оточення:

echo "Ви прийшли з: ".getenv("HTTP_REFERER")."
";
$br=getenv("HTTP_USER_AGENT");
if(strpos($br,"MSIE")!==false) echo "У вас Internet Explorer
";
else echo "У вас Netscape або ін.
";
echo "Ваш IP: ".getenv("REMOTE_ADDR")."
";
echo "Ось параметри у рядку браузера: ".getenv("QUERY_STRING");
?>

Це короткий how-to для реалізації конфігурації PHP-сервісу, залежного від оточення, в якому він запущений. Я буду радий, якщо хтось підкаже більш витончене рішення або виправить у дрібницях.

Основна ідея

Запускати сервіс, мікросервіси та залежні програми в рамках однієї екосистеми, що конфігурується за допомогою змінних оточення.

Проблема

У цій статті багато разів повторюється «змінні оточення».
З коробки php-fpm ігнорує глобальні змінні оточення (getenv function), тоді як php cli їх може отримувати.

Передісторія

Цей розділ можна пропустити, якщо ви вже працювали.

На даний момент я працюю над проектом, написаним на ZF2. Для конфігурації проекту використовувалися конфіг-файли для різних оточень. Це породжує велику кількість дублікатів конфігурації у репозиторії проекту приблизно такого виду:

session.global.php
session.local.php.dist
session.unittest.php.dist
db.global.php
db.local.php.dist
db.unittest.php.dist

Ці дублікати доводиться постійно синхронізувати один з одним. Крім того, вони зберігають певну php-логіку в собі, що породжує дублювання коду.

Отже, проект тепер враховує оточення, але...

Поки розробка велася на робочих машинках, проект читав файл і все працювало. Але коли я розгорнув тестове середовище, виявилося, що якщо задати системні змінні оточення, php-fpm їх ігнорує. Різні рецепти з гугла та StackOverflow зводилися до тієї чи іншої автоматизації використання двох відомих способів:

1. Передача змінних через nginx параметром fastcgi_param SOMEENV test;
2. Установкою змінних у форматі env конфігурації пулу робочих процесів php-fpm .

І перший, і другий варіант зручні для якихось особливих ситуацій. Але якщо мислити в парадигмі «конфігурувати середовище, а не додаток», то подібні способи виявляються набагато важче, ніж просто покласти.env файл в папку з проектом. Але оркестратор, CI-система або просто системний адміністратор не повинен знати деталі реалізації проекту, це не витончено.

Пропонований спосіб вирішення

Скомбінувавши різні рецепти з мережі, я намацав наступне робоче рішення.
Тестувалося під Centos 7, PHP 5.6.14.

1. Відкрити /etc/php.ini - Замінити variables_order = "GPCS" на variables_order = "EGPCS" # Після цього PHP додасть у глобальний простір змінні оточення # http://php.net/manual/ru/ini.core.php #ini.variables-order 2. Відкрити /etc/php-fpm.d/www.conf, не плутати з /etc/php-fpm.conf (у різних системах може бути в різному місці, це конфіг www-пула процесів для php-fpm. - Додати (або замінити, якщо раптом є): clear_env = no # вимкнути очищення глобальних змінних для воркерів 3. Встановити необхідні змінні оточення в /etc/environment (стандартний синтаксис A=B) 4. ln -fs / etc/environment /etc/sysconfig/php-fpm # тепер конфіг змінних оточення сервісу php-fpm буде просто посиланням на глобальний конфіг 5. systemctl daemon-reload && service php-fpm restart

Той самий підхід з симлінком, теоретично, застосуємо і до інших сервісів.

Плюси запропонованого рішення:
- Змінні, що зберігаються в /etc/environment, доступні різним програмам. Можна викликати echo $MYSQL_HOST у shell або getenv("MYSQL_HOST") у php.
- Змінні оточення, які явно не задані /etc/environment, не потраплять у php-fpm. Це дозволяє за допомогою оркестратора контролювати оточення ззовні ізольованої системи, в якій працює сервіс.

Мінуси:
- На жаль, у php-fpm я не знайшов працюючої команди для reload за аналогією з nginx, так що у разі зміни /etc/environment обов'язково потрібно робити systemctl daemon-reload && service php-fpm restart.

Важливо: якщо ваш додаток працює не в ізольованому середовищі (сервер, віртуалка, контейнер), визначення змінних оточення може непередбачено вплинути на сусідні сервіси в системі через збіги імен у глобальному просторі.

Змінні оточення

Змінні оточення в PHP

HTTP_ACCEPT

У цій змінній перераховані всі MIME-типи даних, які можна сприйняти браузером. Рядок */* означає, що браузер розуміє будь-який тип.

HTTP_ACCEPT= image/gif, image/x-xbitmap, image/jpeg, image/pjpeg, application/x-shockwave-flash, application/vnd.ms-excel, application/msword, */*

HTTP_REFERER

Ця змінна представляє відомості про сторінку, на якій користувач потрапив на дану. Цю змінну можна використовувати, наприклад, для відстеження переміщення користувача на вашому сайті, а потім переглядати найбільш популярні маршрути.

HTTP_REFERER= http://www.spravkaweb.ru/php/pril/

HTTP_COOKIE

У цій змінній зберігаються всі Cookies в URL-кодуванні.

HTTP_COOKIE=hotlog=1; ZDEDebuggerPresent=php,phtml,php3; b = b; PHPSESSID=16805922a9258cda274316e60f649cf8

HTTP_USER_AGENT

Ідентифікує браузер користувача. Для встановлення типу браузера потрібно перевірити цей рядок на наявність слів: якщо браузер - Internet Explorer, то буде присутній підрядок MSIE, а якщо є лише слово Mozilla, то це Netscape.

Наприклад:

HTTP_USER_AGENT = Mozilla / 4.0 (компітальний; MSIE 6.0; Windows NT 5.1; SV1; MyIE2; Maxthon)

HTTP_HOST

Містить доменне ім'я Web-сервера, де запустився сценарій. Цю змінну досить зручно використовувати, наприклад, для генерації повного шляху, який потрібно заголовку Location, щоб не прив'язуватися до конкретного сервера.

HTTP_HOST = www.spravkaweb.ru

HTTP_FROM

Адреса електронної пошти користувача, який надіслав запит.

SERVER_NAME

Доменне ім'я або IP-адреса сервера.

SERVER_NAME= www.spravkaweb.ru

SERVER_SOFTWARE

Ім'я та версія програми-сервера, що відповідає на запит клієнта.

SERVER_PORT

Ця змінна містить порт сервера, до якого звернувся браузер користувача. Зазвичай це 80. Змінна також може застосовуватися для формування параметра заголовка Location.

SERVER_PROTOCOL

Змінна містить ім'я та версію інформаційного протоколу, використаного для запиту.

SERVER_PROTOCOL=HTTP/1.1

REMOTE_ADDR

Ця змінна містить IP-адресу (або доменне ім'я) вузла користувача, на якому було запущено браузер.

REMOTE_PORT

Порт, який закріплюється за браузером користувача, щоб отримати відповідь сервера.

REMOTE_USER

Ідентифікаційне ім'я користувача, що надсилає запит.

SCRIPT_NAME

Містить ім'я файлу, що містить цей сценарій. Цю змінну зручно використовувати для формування заголовка Location при переадресації він (self-redirect), і навіть підставлення значення атрибута action тега на сторінці, яку викликає сценарій під час запуску без параметрів (щоб не прив'язуватися до конкретного імені сценарію).

DOCUMENT_ROOT

Кореневий каталог дерева Web-документів.

REQUEST_METHOD

Метод, який застосовує користувач під час передачі даних. Слід зауважити, що грамотно складений сценарій повинен сам визначати на основі цієї змінної, який метод задіяний користувач, і приймати дані з відповідного джерела, а не розраховувати, що передача здійснюватиметься, наприклад, лише методом POST.

QUERY_STRING

Містить параметри, які в URL вказані після знака запитання. Нагадаємо, що вони доступні як за методом GET, так і за методом POST (якщо в останньому випадку вони були визначені в атрибуті action тега ).

PATH_INFO

Містить додаткову інформацію про шлях.

PATH_TRANSLATED

Та ж інформація, що й у змінній PATH_INFOз префіксом, який задає шлях до кореневого каталогу дерева Web-документів.

CONTENT_TYPE

Медіа тип даних запиту.

CONTENT_LENGTH

Повертає кількість байт даних, надісланих користувачем. Цю змінну необхідно аналізувати, якщо ви займаєтеся прийомом та обробкою POST-форми.

GATEWAY_INTERFACE

Версія CGI, яку використовує сервер.

Приклад використання змінних оточення

Змінні оточення

Змінні оточення в PHP

HTTP_ACCEPT

HTTP_ACCEPT= image/gif, image/x-xbitmap, image/jpeg, image/pjpeg, application/x-shockwave-flash, application/vnd.ms-excel, application/msword, */*

HTTP_REFERER

HTTP_REFERER= http://www.spravkaweb.ru/php/pril/

HTTP_COOKIE

У цій змінній зберігаються всі Cookies в URL-кодуванні.

HTTP_COOKIE=hotlog=1; ZDEDebuggerPresent=php,phtml,php3; b = b; PHPSESSID=16805922a9258cda274316e60f649cf8

HTTP_USER_AGENT

Наприклад:

HTTP_USER_AGENT = Mozilla / 4.0 (компітальний; MSIE 6.0; Windows NT 5.1; SV1; MyIE2; Maxthon)

HTTP_HOST

HTTP_HOST = www.spravkaweb.ru

HTTP_FROM

Адреса електронної пошти користувача, який надіслав запит.

SERVER_NAME

Доменне ім'я або IP-адреса сервера.

SERVER_NAME= www.spravkaweb.ru

SERVER_SOFTWARE

Ім'я та версія програми-сервера, що відповідає на запит клієнта.

SERVER_PORT

SERVER_PROTOCOL

Змінна містить ім'я та версію інформаційного протоколу, використаного для запиту.

SERVER_PROTOCOL=HTTP/1.1

REMOTE_ADDR

Ця змінна містить IP-адресу (або доменне ім'я) вузла користувача, на якому було запущено браузер.

REMOTE_PORT

Порт, який закріплюється за браузером користувача, щоб отримати відповідь сервера.

REMOTE_USER

Ідентифікаційне ім'я користувача, що надсилає запит.

SCRIPT_NAME

DOCUMENT_ROOT

Кореневий каталог дерева Web-документів.

REQUEST_METHOD

QUERY_STRING

PATH_INFO

Містить додаткову інформацію про шлях.

PATH_TRANSLATED

CONTENT_TYPE

Медіа тип даних запиту.

CONTENT_LENGTH

GATEWAY_INTERFACE

Версія CGI, яку використовує сервер.

Приклад використання змінних оточення

Змінні оточення

Змінні оточення:

echo "Ви прийшли з: ".getenv("HTTP_REFERER")."
";

$br=getenv("HTTP_USER_AGENT");

if(strpos($br,"MSIE")!==false) echo "У вас Internet Explorer
";

else echo "У вас Netscape або ін.
";

echo "Ваш IP: ".getenv("REMOTE_ADDR")."
";

echo "Ось параметри у рядку браузера: ".getenv("QUERY_STRING");

З книги Мистецтво програмування для Unix автора Реймонд Ерік Стівен

З книги Програмування мовою Ruby [Ідеологія мови, теорія та практика застосування] автора Фултон Хел

З книги HTML 5, CSS 3 та Web 2.0. Розробка сучасних веб-сайтів. автора Дронов Володимир

З книги Розробка програм у середовищі Linux. Друге видання автора Джонсон Майкл До.

10.4. Змінні оточення Коли запускається якась Unix-програма, доступне їй середовище включає набір зв'язків "ім'я-значення" (як імена, так і значення є рядками). Деякі з них встановлюються користувачем вручну, інші – системою під час

З книги Firebird КЕРІВНИЦТВО РОЗРОБНИКА БАЗ ДАНИХ автора Боррі Хелен

10.4.1. Існує безліч широко відомих змінних оточення, значення яких програма може отримати при запуску з оболонки Unix. Дані змінні (особливо НОМЕ) часто потрібно оцінити до зчитування локального файлу

З книги Linux програмування у прикладах автора Роббінс Арнольд

10.4.2. Користувальницькі змінні оточення Незважаючи на те, що програми можуть вільно інтерпретувати змінні оточення за межами певного системою набору, в даний час фактичне використання такої можливості досить незвичайне.

З книги автора

10.4.3. Коли використовувати змінні оточення Спільним для користувацьких і системних змінних оточення є те, що вони містять дані, зберігання яких у великій кількості конфігураційних файлів було б стомлюючим. І вкрай стомлюючим

З книги автора

14.4. Змінні оточення Іноді необхідно звертатися до змінних оточення, які є сполучною ланкою між програмою та зовнішнім світом. Змінні оточення - це просто мітки, пов'язані з деяким текстом (зазвичай невеликим); у них зберігаються, наприклад, шляхи до

З книги автора

Функції та змінні. Локальні змінні Оголошені функції раніше створюють всередині свого тіла власні змінні. Це звані локальні змінні. Такі змінні доступні лише усередині тіла функції, у якому вони оголошені. При завершенні виконання

З книги автора

22.3.3. Змінні оточення У програмах, що працюють з можливостями setuid або setgid, потрібно виявляти особливу обережність із установками оточення. Ці змінні визначаються користувачем, що активізував програму, тим самим відкривається шлях для атак. Найочевидніша атака

З книги автора

Змінні оточення Змінні оточення – глобальні установки системи, які використовуються при початковому завантаженні операційної системи. У Windows, Linux та більшості систем UNIX сервер Firebird розпізнає і використовує деякі змінні оточення, якщо вони

З книги автора

Де встановлюються змінні оточення Windows Тип змінних оточення і спосіб їх встановлення змінюється від однієї версії Windows до іншої. У табл. 3.1 показані типи (якщо застосовні) та способи встановлення значень змінним оточення. Таблиця 3.1. Установки змінних оточення для

З книги автора

Розділ 2 Аргументи, опції та змінні оточення Першим завданням будь-якої програми зазвичай є інтерпретація опцій та аргументів командного рядка. Цей розділ розглядає, як програми С (і С++) отримують аргументи свого командного рядка, описує стандартні