Суперглобальная переменная $_SERVER
Переменная $_SERVER — это массив, содержащий информацию, такую как заголовки, пути и местоположения скриптов. Записи в этом массиве создаются веб-сервером.
Рассмотрим на примере как использовать суперглобальную переменную $_SERVER:
Пример
"; echo $_SERVER['SERVER_NAME']; echo "
"; echo $_SERVER['HTTP_HOST']; echo "
"; echo $_SERVER['HTTP_REFERER']; echo "
"; echo $_SERVER['HTTP_USER_AGENT']; echo "
"; echo $_SERVER['SCRIPT_NAME']; ?> В приведенном выше коде мы использовали элементы $_SERVER для получения некоторой информации. Получаем имя текущего файла, над которым мы работаем с помощью элемента PHP_SELF . Затем получаем имя сервера, используемое в настоящее время с использованием элемента SERVER_NAME . А затем получаем имя хоста через HTTP_HOST . HTTP_REFERER — адрес страницы (если есть), с которой браузер пользователя перешёл на эту страницу.
Рассмотрим описание значений глобального массива $_SERVER с примерами.
Параметры сервера
| Элемент | Описание |
|---|---|
| $_SERVER[‘SERVER_NAME’] | Имя хоста, обычно совпадает с доменом (например, wm-school.ru) |
| $_SERVER[‘GATEWAY_INTERFACE’] | Версия Common Gateway Interface (CGI), которую использует сервер (CGI/1.1) |
| $_SERVER[‘SERVER_SOFTWARE’] | Название и версия сервера (Apache/2.4.7) |
| $_SERVER[‘SERVER_SIGNATURE’] | Версия сервера и имя виртуального хоста, обычно пуста |
| $_SERVER[‘SERVER_PROTOCOL’] | Имя и версия используемого HTTP протокола (HTTP/1.1) |
| $_SERVER[‘SERVER_ADDR’] | IP-адрес сервера (127.0.0.1) |
| $_SERVER[‘SERVER_PORT’] | Порт сервера (80) |
| $_SERVER[‘SERVER_ADMIN’] | Значение из директивы конфигурационного файла Apache. На хостингах указывают контактный e-mail. |
Параметры соединения
| Элемент | Описание |
|---|---|
| $_SERVER[‘HTTP_HOST’] | Имя сервера, как правило, совпадает с доменом (например, wm-school.ru) |
| $_SERVER[‘HTTP_PORT’] | Порт подключения (80) |
| $_SERVER[‘REMOTE_ADDR’] | IP-адрес, с которого пользователь просматривает текущую страницу (64.246.37.238) |
| $_SERVER[‘REMOTE_HOST’] | Удаленный хост, с которого пользователь просматривает текущую страницу |
| $_SERVER[‘REMOTE_PORT’] | Порт на удаленной машине, который используется для связи с веб-сервером |
| $_SERVER[‘REQUEST_SCHEME’] | Схема запроса (http) |
| $_SERVER[‘REQUEST_METHOD’] | Метод запроса к странице (GET, POST, PUT) |
| $_SERVER[‘REQUEST_TIME’] | Время запроса к серверу в Unix timestamp (1537962596) |
| $_SERVER[‘REQUEST_TIME_FLOAT’] | Время запроса к серверу с точностью до микросекунд (1537962596.892) |
Пути на сервере
| Элемент | Описание |
|---|---|
| $_SERVER[‘DOCUMENT_ROOT’] | Директория корня сайта, в которой выполняется текущий скрипт (например, /wm-school.ru/scripts) |
| $_SERVER[‘CONTEXT_DOCUMENT_ROOT’] | Появился в Apache2, то же самое что и DOCUMENT_ROOT |
| $_SERVER[‘PATH_INFO’] | Содержит путь, содержащийся после имени скрипта (Например для адреса https://wm-school.ru/index.php/123 значение будет следующим: /123) |
| $_SERVER[‘ORIG_PATH_INFO’] | Исходное значение переменной PATH_INFO перед обработкой PHP |
| $_SERVER[‘SCRIPT_NAME’] | Путь и имя выполняемого скрипта (/index.php) |
| $_SERVER[‘PHP_SELF’] | Путь к исполняемому скрипту относительно корня сайта, обычно равен SCRIPT_NAME (/index.php) |
| $_SERVER[‘SCRIPT_FILENAME’] | Абсолютный путь к исполняемому скрипту (/wm-school.ru/public_html/index.php) |
| $_SERVER[‘PATH’] | /usr/local/bin:/usr/bin:/bin |
Авторизация на .htpasswd
| Элемент | Описание |
|---|---|
| $_SERVER[‘AUTH_TYPE’] | Метод HTTP аутентификации (например, Basic) |
| $_SERVER[‘REMOTE_USER’] и $_SERVER[‘PHP_AUTH_USER’] | Логин пользователя |
| $_SERVER[‘PHP_AUTH_PW’] | Пароль |
HTTPS
Данные переменные появляются при HTTPS соединении:
$_SERVER[‘HTTPS’], $_SERVER[‘HTTP_X_HTTPS’], $_SERVER[‘REDIRECT_HTTPS’]
URL
Значения в примерах приведены для адреса https://wm-school.ru/index.php?page=1&exercise=2
Заголовки браузера
| Элемент | Описание |
|---|---|
| $_SERVER[‘HTTP_USER_AGENT’] | Браузер и операционную система, открышие данную страницу (например, Mozilla/5.0 (Windows NT 6.1) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/69.0.3497.100 Safari/537.36) |
| $_SERVER[‘HTTP_COOKIE’] | Куки браузера в виде строки: ключ=значение; ключ=значение;. Данные доступны в переменной $_COOKIE (_ym_uid=xxx; _ym_d=xxx; PHPSESSID=xxx;) |
| $_SERVER[‘HTTP_REFERER’] | Адрес страницы, с которой браузер пользователя перешёл на текущую страницу (https://wm-school.ru/index.php) |
| $_SERVER[‘HTTP_ACCEPT’] | Содержимое заголовка Accept из текущего запроса (text/html, application/xhtml+xml, application/xml;q=0.9, image/webp, image/apng, */*; q=0.8) |
| $_SERVER[‘HTTP_ACCEPT_ENCODING’] | HTTP заголовок переданный клиентом, говорящий о том какие алгоритмы сжатия он может понять (gzip, deflate) |
| $_SERVER[‘HTTP_ACCEPT_LANGUAGE’] | Содержимое заголовка Accept-Language (ru-RU,ru; q=0.9,en-US; q=0.8,en; q=0.7) |
| $_SERVER[‘HTTP_ACCEPT_CHARSET’] | Предпочтения клиента относительно кодировки (utf-8, iso-8859-1) |
| $_SERVER[‘HTTP_CACHE_CONTROL’] | max-age=0 |
| $_SERVER[‘HTTP_UPGRADE_ INSECURE_REQUESTS’] | Браузер отправляет этот заголовок со значением 1, выражающий предпочтение клиента для зашифрованного ответа |
Дамп переменной $_SERVER
Для тестирования, значения массива $_SERVER для разных клиентов можно скидывать в лог-файл:
file_put_contents(__DIR__ . '/server.log', print_r($_SERVER, true) . PHP_EOL, FILE_APPEND);
$_SERVER
$_SERVER is an array containing information such as headers, paths, and script locations. The entries in this array are created by the web server, therefore there is no guarantee that every web server will provide any of these; servers may omit some, or provide others not listed here. However, most of these variables are accounted for in the » CGI/1.1 specification, and are likely to be defined.
Note: When running PHP on the command line most of these entries will not be available or have any meaning.
In addition to the elements listed below, PHP will create additional elements with values from request headers. These entries will be named HTTP_ followed by the header name, capitalized and with underscores instead of hyphens. For example, the Accept-Language header would be available as $_SERVER[‘HTTP_ACCEPT_LANGUAGE’] .
Indices
‘ PHP_SELF ‘ The filename of the currently executing script, relative to the document root. For instance, $_SERVER[‘PHP_SELF’] in a script at the address http://example.com/foo/bar.php would be /foo/bar.php . The __FILE__ constant contains the full path and filename of the current (i.e. included) file. If PHP is running as a command-line processor this variable contains the script name. ‘argv’ Array of arguments passed to the script. When the script is run on the command line, this gives C-style access to the command line parameters. When called via the GET method, this will contain the query string. ‘argc’ Contains the number of command line parameters passed to the script (if run on the command line). ‘ GATEWAY_INTERFACE ‘ What revision of the CGI specification the server is using; e.g. ‘CGI/1.1’ . ‘ SERVER_ADDR ‘ The IP address of the server under which the current script is executing. ‘ SERVER_NAME ‘ The name of the server host under which the current script is executing. If the script is running on a virtual host, this will be the value defined for that virtual host.
Note: Under Apache 2, UseCanonicalName = On and ServerName must be set. Otherwise, this value reflects the hostname supplied by the client, which can be spoofed. It is not safe to rely on this value in security-dependent contexts.
‘ SERVER_SOFTWARE ‘ Server identification string, given in the headers when responding to requests. ‘ SERVER_PROTOCOL ‘ Name and revision of the information protocol via which the page was requested; e.g. ‘HTTP/1.0’ ; ‘ REQUEST_METHOD ‘ Which request method was used to access the page; e.g. ‘GET’ , ‘HEAD’ , ‘POST’ , ‘PUT’ .
Note:
PHP script is terminated after sending headers (it means after producing any output without output buffering) if the request method was HEAD .
‘ REQUEST_TIME ‘ The timestamp of the start of the request. ‘ REQUEST_TIME_FLOAT ‘ The timestamp of the start of the request, with microsecond precision. ‘ QUERY_STRING ‘ The query string, if any, via which the page was accessed. ‘ DOCUMENT_ROOT ‘ The document root directory under which the current script is executing, as defined in the server’s configuration file. ‘ HTTPS ‘ Set to a non-empty value if the script was queried through the HTTPS protocol. ‘ REMOTE_ADDR ‘ The IP address from which the user is viewing the current page. ‘ REMOTE_HOST ‘ The Host name from which the user is viewing the current page. The reverse dns lookup is based on the REMOTE_ADDR of the user.
Note: The web server must be configured to create this variable. For example in Apache HostnameLookups On must be set inside httpd.conf for it to exist. See also gethostbyaddr() .
‘ REMOTE_PORT ‘ The port being used on the user’s machine to communicate with the web server. ‘ REMOTE_USER ‘ The authenticated user. ‘ REDIRECT_REMOTE_USER ‘ The authenticated user if the request is internally redirected. ‘ SCRIPT_FILENAME ‘
The absolute pathname of the currently executing script.
Note:
If a script is executed with the CLI, as a relative path, such as file.php or ../file.php , $_SERVER[‘SCRIPT_FILENAME’] will contain the relative path specified by the user.
‘ SERVER_ADMIN ‘ The value given to the SERVER_ADMIN (for Apache) directive in the web server configuration file. If the script is running on a virtual host, this will be the value defined for that virtual host. ‘ SERVER_PORT ‘ The port on the server machine being used by the web server for communication. For default setups, this will be ’80’ ; using SSL, for instance, will change this to whatever your defined secure HTTP port is.
Note: Under Apache 2, UseCanonicalName = On , as well as UseCanonicalPhysicalPort = On must be set in order to get the physical (real) port, otherwise, this value can be spoofed, and it may or may not return the physical port value. It is not safe to rely on this value in security-dependent contexts.
‘ SERVER_SIGNATURE ‘ String containing the server version and virtual host name which are added to server-generated pages, if enabled. ‘ PATH_TRANSLATED ‘ Filesystem- (not document root-) based path to the current script, after the server has done any virtual-to-real mapping.
Note: Apache 2 users may use AcceptPathInfo = On inside httpd.conf to define PATH_INFO .
‘ SCRIPT_NAME ‘ Contains the current script’s path. This is useful for pages which need to point to themselves. The __FILE__ constant contains the full path and filename of the current (i.e. included) file. ‘ REQUEST_URI ‘ The URI which was given in order to access this page; for instance, ‘ /index.html ‘. ‘ PHP_AUTH_DIGEST ‘ When doing Digest HTTP authentication this variable is set to the ‘Authorization’ header sent by the client (which you should then use to make the appropriate validation). ‘ PHP_AUTH_USER ‘ When doing HTTP authentication this variable is set to the username provided by the user. ‘ PHP_AUTH_PW ‘ When doing HTTP authentication this variable is set to the password provided by the user. ‘ AUTH_TYPE ‘ When doing HTTP authentication this variable is set to the authentication type. ‘ PATH_INFO ‘ Contains any client-provided pathname information trailing the actual script filename but preceding the query string, if available. For instance, if the current script was accessed via the URI http://www.example.com/php/path_info.php/some/stuff?foo=bar , then $_SERVER[‘PATH_INFO’] would contain /some/stuff . ‘ ORIG_PATH_INFO ‘ Original version of ‘ PATH_INFO ‘ before processed by PHP.
Examples
Example #1 $_SERVER example