server.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: a124543dd3f6b1e5567b07420d23899e582514dc Maintainer: mproshchuk Status: ready -->
<refentry role="variable" xml:id="reserved.variables.server" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
 <refnamediv>
  <refname>$_SERVER</refname>

  <refpurpose>Інформація про серверне та виконавче середовище</refpurpose>
 </refnamediv>
 
 <refsect1 role="description">
  &reftitle.description;
  <para>
   Змінна <varname>$_SERVER</varname> — це масив, що містить таку інформацію як
   заголовки, шляхи та розташування скриптів. Записи в цьому масиві створює
   вебсервер. Немає гарантії, що кожен вебсервер буде надавати всі ці записи;
   Деякі дані може бути опущено або надано інші, незазначені в списку, який
   наведено нижче. Тим не менш, більша частина цих даних описані в
   <link xlink:href="&url.rfc;3875">специфікації CGI/1.1</link> і, ймовірно,
   будуть визначені.
  </para>

  <note>
   <simpara>
    Під час виконання PHP в <link linkend="features.commandline">командному
    рядку</link> більшість з цих записів не доступні або мають інше значення.
   </simpara>
  </note>
  <para>
   Разом з елементами, описаними нижче, PHP створює додаткові елементи зі
   значеннями заголовків запиту. Ці елементи матимуть ключі з назвою, що
   складається з <literal>HTTP_</literal> та назви заголовка великими буквами та
   підкресленнями замість дефісів. Наприклад, заголовок
   <literal>Accept-Language</literal> буде доступний як
   <code>$_SERVER['HTTP_ACCEPT_LANGUAGE']</code>.
  </para>
 </refsect1>

 <refsect1 role="indices">
  &reftitle.indices;

  <para>
   <variablelist>
    <varlistentry>
     <term>"<varname>PHP_SELF</varname>"</term>
     <listitem>
      <simpara>
       Шлях до файлу, де запущено скрипт, відносно кореневої теки вебсервера
       (document root). Наприклад, <varname>$_SERVER['PHP_SELF']</varname> в
       скрипті за адресою <filename>http://example.com/foo/bar.php</filename>
       буде <filename>/foo/bar.php</filename>. Константа
       <link linkend="language.constants.magic">__FILE__</link> містить
       повний шлях та назву поточного (тобто підключеного) файлу.
      </simpara>
      <simpara>
       Якщо PHP запущено з командного рядка, ця змінна міститиме назву скрипта.
      </simpara>
     </listitem>
    </varlistentry>

    <varlistentry>
     <term>"<link linkend="reserved.variables.argv">argv</link>"</term>
     <listitem>
      <simpara>
       Масив аргументів, переданих до скрипта. Коли скрипт запущено з командного    
       рядка, то є можливість передавати до нього параметри в C-стилі. Під час
      виклику методом GET цей масив містить рядок запиту.
      </simpara>
     </listitem>
    </varlistentry>

    <varlistentry>
     <term>"<link linkend="reserved.variables.argc">argc</link>"</term>
     <listitem>
      <simpara>
       Містить число параметрів, переданих до скрипта з командного рядка
       (якщо скрипт запущено з командного рядка).
      </simpara>
     </listitem>
    </varlistentry>

    <varlistentry>
     <term>"<varname>GATEWAY_INTERFACE</varname>"</term>
     <listitem>
      <simpara>
       Назва та номер ревізії специфікації CGI сервера, що використовується.
       Наприклад, <literal>"CGI/1.1"</literal>.
      </simpara>
     </listitem>
    </varlistentry>

    <varlistentry>
     <term>"<varname>SERVER_ADDR</varname>"</term>
     <listitem>
      <simpara>
       IP-адреса сервера, на якому скрипт виконується.
      </simpara>
     </listitem>
    </varlistentry>

    <varlistentry>
     <term>"<varname>SERVER_NAME</varname>"</term>
     <listitem>
      <simpara>
       Назва хоста сервера, на якому скрипт виконується. Якщо скрипт запущено на
       віртуальному хості, ця змінна міститиме його назву.
      </simpara>
      <note>
       <simpara>
        На Apache 2 потрібно встановити <literal>UseCanonicalName = On</literal>
        і <literal>ServerName</literal>. Інакше, це значення відображатиме назву
        хоста, надану клієнтом, яку можна підробити. Покладатися на це значення
        в контексті безпеки — небезпечно.
       </simpara>
      </note>
     </listitem>
    </varlistentry>

    <varlistentry>
     <term>"<varname>SERVER_SOFTWARE</varname>"</term>
     <listitem>
      <simpara>
       Ідентифікаційний рядок сервера, передається в заголовках у відповідь на
       запит.
      </simpara>
     </listitem>
    </varlistentry>

    <varlistentry>
     <term>"<varname>SERVER_PROTOCOL</varname>"</term>
     <listitem>
      <simpara>
       Назва та номер ревізії протоколу, через який було запитано сторінку.
       Наприклад, <literal>"HTTP/1.0"</literal>.
      </simpara>
     </listitem>
    </varlistentry>
    
    <varlistentry>
     <term>"<varname>REQUEST_METHOD</varname>"</term>
     <listitem>
      <simpara>
       Назва метода, що використовувався під час запиту сторінки, тобто
       <literal>"GET"</literal>, <literal>"HEAD"</literal>,
       <literal>"POST"</literal>, <literal>"PUT"</literal>.
      </simpara>
      <note>
       <para>
        Скрипт PHP завершує роботу після надсилання заголовків (тобто, після
        здійснення будь-якого виводу без його буферизації) якщо метод запиту
        був <literal>HEAD</literal>.
       </para>
      </note>
     </listitem>
    </varlistentry>

    <varlistentry>
     <term>"<varname>REQUEST_TIME</varname>"</term>
     <listitem>
      <simpara>
       Мітка часу, коли почався запит.
      </simpara>
     </listitem>
    </varlistentry>
    
    <varlistentry>
     <term>"<varname>REQUEST_TIME_FLOAT</varname>"</term>
     <listitem>
      <simpara>
       Мітка часу, коли почався запит, з точністю до мікросекунд.
      </simpara>
     </listitem>
    </varlistentry>

    <varlistentry>
     <term>"<varname>QUERY_STRING</varname>"</term>
     <listitem>
      <simpara>
       Рядок запиту, якщо він є, через який доступились до сторінки.
      </simpara>
     </listitem>
    </varlistentry>

    <varlistentry>
     <term>"<varname>DOCUMENT_ROOT</varname>"</term>
     <listitem>
      <simpara>
       Коренева директорія документів (document root), в якій скрипт
       виконується; вона визначається в конфігураційному файлі вебсервера.
      </simpara>
     </listitem>
    </varlistentry>

    <varlistentry>
     <term>"<varname>HTTPS</varname>"</term>
     <listitem>
      <simpara>
       Має непорожнє значення, якщо скрипт було запитано через протокол HTTPS.
      </simpara>
     </listitem>
    </varlistentry>

    <varlistentry>
     <term>"<varname>REMOTE_ADDR</varname>"</term>
     <listitem>
      <simpara>
       IP-адреса, з якої користувач переглядає поточну сторінку.
      </simpara>
     </listitem>
    </varlistentry>

    <varlistentry>
     <term>"<varname>REMOTE_HOST</varname>"</term>
     <listitem>
      <simpara>
       Назва хоста, з якого користувач переглядає поточну сторінку. Зворотній
       пошук DNS базується на <varname>REMOTE_ADDR</varname> користувача.
      </simpara>
      <note>
       <simpara>
        Вебсервер необхідно сконфігурувати, так щоб створювалася ця змінна.
        Наприклад, в Apache у файлі &httpd.conf; потрібна опція
        <literal>HostnameLookups On</literal>. Див. також
        <function>gethostbyaddr</function>.
       </simpara>
      </note>
     </listitem>
    </varlistentry>

    <varlistentry>
     <term>"<varname>REMOTE_PORT</varname>"</term>
     <listitem>
      <simpara>
       Порт, який було використано на комп'ютері користувача для зв'язку
       з вебсервером.
      </simpara>
     </listitem>
    </varlistentry>

    <varlistentry>
     <term>"<varname>REMOTE_USER</varname>"</term>
     <listitem>
      <simpara>
        Ім'я авторизованого користувача.
      </simpara>
     </listitem>
    </varlistentry>

    <varlistentry>
     <term>"<varname>REDIRECT_REMOTE_USER</varname>"</term>
     <listitem>
      <simpara>
        Ім'я авторизованого користувача, якщо запит має внутрішню переадресацію.
      </simpara>
     </listitem>
    </varlistentry>

    <varlistentry>
     <term>"<varname>SCRIPT_FILENAME</varname>"</term>
     <listitem>
      <para>
       Абсолютний шлях до поточного скрипта, що виконується.
       <note>
        <para>
         Якщо скрипт виконується через CLI з використанням відносного шляху,
         як от <filename>file.php</filename> чи
         <filename>../file.php</filename>,
         <varname>$_SERVER['SCRIPT_FILENAME']</varname> буде містити цей
         відносний шлях, визначений користувачем.
        </para>
       </note>
      </para>
     </listitem>
    </varlistentry>

    <varlistentry>
     <term>"<varname>SERVER_ADMIN</varname>"</term>
     <listitem>
      <simpara>
       Значення, що встановлено для директиви SERVER_ADMIN (для Apache) в
       конфігураційному файлі вебсервера. Якщо скрипт запущено на віртуальному
       хості, SERVER_ADMIN матиме значення, визначене для даного віртуального
       хоста.
      </simpara>
     </listitem>
    </varlistentry>
    
    <varlistentry>
     <term>"<varname>SERVER_PORT</varname>"</term>
     <listitem>
      <simpara>
       Порт сервера, який використовується вебсервером для зв'язку. Початково,
       встановлюється значення <literal>"80"</literal>. Але використовуючи,
       наприклад, SSL, це значення буде тим, що вказано в конфігураційному файлі
       для з'єднання через безпечний HTTP-порт.
      </simpara>
      <note>
       <simpara>
        Для того, щоб отримати фізичний (реальний) порт на Apache 2, необхідно
        встановити <literal>UseCanonicalName = On</literal> і
        <literal>UseCanonicalPhysicalPort = On</literal>. В іншому випадку це
        значення може підмінятись, а тому не буде повертатись значення фізичного
        порту. Покладатися на це значення в контексті безпеки — небезпечно.
       </simpara>
      </note>
     </listitem>
    </varlistentry>

    <varlistentry>
     <term>"<varname>SERVER_SIGNATURE</varname>"</term>
     <listitem>
      <simpara>
       Рядок, що містить версію вебсервера та назву віртуального хоста, які
       додаються до сторінок, якщо на вебсервері ця функціональність підключена.
      </simpara>
     </listitem>
    </varlistentry>

    <varlistentry>
     <term>"<varname>PATH_TRANSLATED</varname>"</term>
     <listitem>
      <simpara>
       Шлях, що базується на файловій системі (а не на шляху до кореневої теки
       документів), який веде до поточного скрипта. PATH_TRANSLATED матиме
       значення, якщо створено зіставлення між назвою віртуального хоста та
       реальним шляхом до його теки.
      </simpara>
      <note>
       <simpara>
        Користувачі Apache 2 можуть використовувати <literal>AcceptPathInfo =
        On</literal> у файлі <filename>httpd.conf</filename>, щоб визначити
        <envar>PATH_INFO</envar>.
       </simpara>
      </note>
     </listitem>
    </varlistentry>

    <varlistentry>
     <term>"<varname>SCRIPT_NAME</varname>"</term>
     <listitem>
      <simpara>
       Містить шлях до поточного скрипта. Це є корисним для сторінок, які
       повинні посилатись на самих себе. Константа <link
       linkend="language.constants.magic">__FILE__</link> містить повний
       шлях та назву поточного файлу.
      </simpara>
     </listitem>
    </varlistentry>

    <varlistentry>
     <term>"<varname>REQUEST_URI</varname>"</term>
     <listitem>
      <simpara>
       URI, який передається для доступу до поточного скрипта. Наприклад,
       <literal>"/index.html"</literal>.
      </simpara>
     </listitem>
    </varlistentry>

    <varlistentry>
     <term>"<varname>PHP_AUTH_DIGEST</varname>"</term>
     <listitem>
      <simpara>
       Під час виконання автентифікації Digest HTTP, цій змінній передається
       значення заголовка "Authorization" (яке потім використовується для
       відповідної перевірки), що присилає клієнт.
      </simpara>
     </listitem>
    </varlistentry>

    <varlistentry>
     <term>"<varname>PHP_AUTH_USER</varname>"</term>
     <listitem>
      <simpara>
       Під час HTTP-автентифікації цій змінній передається ім'я користувача.
      </simpara>
     </listitem>
    </varlistentry>

    <varlistentry>
     <term>"<varname>PHP_AUTH_PW</varname>"</term>
     <listitem>
      <simpara>
       Під час HTTP-автентифікації цій змінній передається пароль користувача.
      </simpara>
     </listitem>
    </varlistentry>

    <varlistentry>
     <term>"<varname>AUTH_TYPE</varname>"</term>
     <listitem>
      <simpara>
       Під час HTTP-автентифікації, цій змінній передається значення типу
       автентифікації.
      </simpara>
     </listitem>
    </varlistentry>

    <varlistentry>
     <term>"<varname>PATH_INFO</varname>"</term>
     <listitem>
      <simpara>
       Містить будь-який шлях, вказаний клієнтом між назвою скрипта та
       рядком запиту. Наприклад, якщо скрипт запитувати через URI
       <filename>http://www.example.com/php/path_info.php/some/stuff?foo=bar</filename>,
       то <varname>$_SERVER['PATH_INFO']</varname> міститиме
       <literal>/some/stuff</literal>.
      </simpara>
     </listitem>
    </varlistentry>

    <varlistentry>
     <term>"<varname>ORIG_PATH_INFO</varname>"</term>
     <listitem>
      <simpara>
       Необроблене інтерпретатором значення <varname>"PATH_INFO"</varname>.
      </simpara>
     </listitem>
    </varlistentry>

   </variablelist>
  </para>
 </refsect1>
 
 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example xml:id="variable.server.basic">
    <title>Використання <varname>$_SERVER</varname></title>
    <programlisting role="php">
<![CDATA[
<?php
echo $_SERVER['SERVER_NAME'];
?>
]]>
    </programlisting>
    &example.outputs.similar;
    <screen>
<![CDATA[
www.example.com
]]>
    </screen>
   </example>
  </para>
 </refsect1>
 
 <refsect1 role="notes">
  &reftitle.notes;
  &note.is-superglobal;
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><link linkend="book.filter">Фільтрація даних</link></member>
   </simplelist>
  </para>
 </refsect1>

</refentry>
 
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->