« $GLOBALS$\_GET »PHP ManualЗумовлені змінні

$_SERVER

(PHP 4 >= 4.1.0, PHP 5, PHP 7, PHP 8)

$_SERVER — Інформація про сервер та середовище виконання

Опис

Змінна $_SERVER - це масив (array), що містить таку інформацію, як заголовки, шляхи та розташування скриптів. Записи в цьому масиві створюються веб-сервером, тому немає гарантії, що кожен веб-сервер надаватиме будь-яку з цих змінних; сервери можуть опускати деякі з них або надавати інші, не вказані тут. Проте більшість із цих змінних враховано у специфікації » CGI/1.1 і, швидше за все, буде визначено.

Зауваження: При запуске PHP вкомандному рядку більшість із цих записів будуть недоступні або не матимуть жодного значення.

На додаток до наведених нижче елементів, PHP буде створювати додаткові елементи зі значеннями із заголовків запитів. У елементів буде ім'я HTTP_, За яким слідує ім'я заголовка, написане з великої літери та з підкресленням замість дефісу. Наприклад, заголовок Accept-Languageбудет доступен как$_SERVER['HTTP_ACCEPT_LANGUAGE']

Індекси

'PHP_SELF'

Ім'я файлу скрипта, який зараз виконується, щодо кореня документів. Наприклад, $_SERVER['PHP_SELF']в скрипте по адресуhttp://example.com/foo/bar.phpбудет /foo/bar.php. Константа__FILE__ містить повний шлях та ім'я файлу поточного (тобто підключеного) файлу. Якщо PHP запущено у командному рядку, ця змінна містить ім'я скрипта.

'argv'

Масив аргументів переданих скрипту. Коли скрипт запущено у командному рядку, це дає C-подібний доступ до параметрів командного рядка. Коли викликається через метод GET, цей масив міститиме рядок запиту.

'argc'

Містить кількість параметрів, переданих скрипту (якщо запуск здійснено в командному рядку).

'GATEWAY_INTERFACE'

Містить версію специфікації CGI, що використовується сервером; наприклад 'CGI/1.1' .. .

'SERVER_ADDR'

IP-адреса сервера, на якому виконується поточний скрипт.

'SERVER_NAME'

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

Зауваження: В Apache 2 необходимо установитьUseCanonicalName = OnиServerName. Інакше це значення відобразить ім'я хоста, надане клієнтом, яке можна підробити. Небезпечно покладатися на це значення в контексті, що потребує безпеки.

'SERVER_SOFTWARE'

Рядок ідентифікації сервера, вказаний у заголовках, коли відбувається відповідь на запит.

'SERVER_PROTOCOL'

Ім'я та версія інформаційного протоколу, через який було запрошено сторінку; наприклад 'HTTP/1.0'

'REQUEST_METHOD'

Який метод використали для запиту сторінки; наприклад 'GET' 'HEAD' 'POST' 'PUT'

Зауваження :

PHP-скрипт завершується після надсилання заголовків (тобто після того, як здійснюється будь-який висновок без буферизації виводу), якщо метод запиту був HEAD

'REQUEST_TIME'

Тимчасова позначка початку запиту.

'REQUEST_TIME_FLOAT'

Тимчасова позначка початку запиту з точністю до мікросекунд.

'QUERY_STRING'

Рядок запиту, якщо є, через яку було відкрито сторінку.

'DOCUMENT_ROOT'

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

'HTTPS'

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

'REMOTE_ADDR'

IP-адреса, з якої користувач переглядає поточну сторінку.

'REMOTE_HOST'

Віддалений хост, з якого користувач переглядає поточну сторінку. Зворотний пошук DNS базується на значенні змінної REMOTE_ADDR.

Зауваження: Сервер повинен бути налаштований, щоб створювати цю змінну. Наприклад, в Apache потрібна присутність директиви HostnameLookups On у файлі httpd.conf, щоб ця змінна створювалася. Дивіться також gethostbyaddr()

'REMOTE_PORT'

Порт на дистанційній машині, який використовується для зв'язку з сервером.

'REMOTE_USER'

Автентифікований користувач.

'REDIRECT_REMOTE_USER'

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

'SCRIPT_FILENAME'

Абсолютний шлях до скрипту.

Зауваження :

Якщо скрипт запускається в командному рядку (CLI), використовуючи відносний шлях, такий як file.php або ../file.php, змінна $_SERVER['SCRIPT_FILENAME'] міститиме відносний шлях, вказаний користувачем.

'SERVER_ADMIN'

Ця змінна набуває свого значення (для Apache) з директиви конфігураційного файлу сервера. Якщо скрипт запущено на віртуальному хості, це буде значення, визначене для цього віртуального хоста.

'SERVER_PORT'

Порт на комп'ютері сервера, який використовує сервер для з'єднання. Для установок за замовчуванням, значення буде '80'; використовуючи SSL, наприклад, це значення буде таким, яке налаштовано для з'єднань безпечного HTTP.

Зауваження: Щоб отримати фізичний (реальний) порт в Apache 2, необхідно встановити UseCanonicalName = OnиUseCanonicalPhysicalPort = On, інакше це значення може бути підмінено і не повернути реальне значення фізичного порту. Покладатися на це значення є небезпечним у контексті додатків, що потребують посиленої безпеки.

'SERVER_SIGNATURE'

Рядок, що містить версію сервера та ім'я віртуального хоста, які додаються до сторінок, що генеруються сервером, якщо включено.

'PATH_TRANSLATED'

Шлях файлової системи (не document root) до поточного скрипту після того, як сервер виконав відображення virtual-to-real.

Зауваження: Користувачі Apache 2 можуть використовувати директиву. AcceptPathInfo = On у конфігураційному файлі httpd.conf для завдання змінної PATH_INFO.

'SCRIPT_NAME'

Містить шлях до поточного виконуваного скрипту. Це корисно для сторінок, які повинні вказувати на себе. Константа __FILE__ містить повний шлях та ім'я поточного (тобто включеного) файлу.

'REQUEST_URI'

URI, який було надано для доступу до цієї сторінки. Наприклад, '/index.md'.

'PHP_AUTH_DIGEST'

При виконанні аутентифікації HTTP Digest цій змінній надається заголовок 'Authorization', надісланий клієнтом (який потім слід використовувати для проведення відповідної перевірки).

'PHP_AUTH_USER'

При виконанні HTTP-автентифікації цієї змінної надається ім'я користувача, надане користувачем.

'PHP_AUTH_PW'

При виконанні HTTP-автентифікації цієї змінної надається пароль, наданий користувачем.

'AUTH_TYPE'

При виконанні HTTP-автентифікації цій змінній надається тип автентифікації, який використовується.

'PATH_INFO'

Містить будь-який наданий користувачем шлях, що міститься після імені скрипта, але до рядка запиту, якщо він є. Наприклад, якщо поточний скрипт запрошений на URL http://www.example.com/php/path\_info.php/some/stuff?foo=bar, то змінна $_SERVER['PATH_INFO'] міститиме /some/stuff

'ORIG_PATH_INFO'

Вихідне значення змінної 'PATH_INFO' перед обробкою PHP.

Приклади

Приклад #1 Приклад використання $_SERVER

Loading...

Висновок наведеного прикладу буде схожим на:

www.example.com

Примітки

Зауваження :

Це «суперглобальна» чи автоматична глобальна змінна. Це просто означає, що вона доступна у всіх контекстах скрипту. Немає необхідності виконувати global $variable; для доступу до неї всередині методу чи функції.

Дивіться також