Новый день - новый патч
| From: | Andrey Bezrukov | Date: | Tue, 02 Aug 2011 20:16:50 +0000 |
| Subject: | Новый день - новый патч | ||
| Groups: | php.doc.ru | ||
| Request: | Send a blank email to doc-ru+get-2098@lists.php.net to get a copy of this message | ||
Переведены следующие файлы
reference/session/functions/session-cache-expire.xml
reference/session/functions/session-cache-limiter.xml
reference/session/functions/session-commit.xml
reference/session/functions/session-decode.xml
reference/session/functions/session-destroy.xml
reference/session/functions/session-encode.xml
reference/session/functions/session-get-cookie-params.xml
reference/session/functions/session-id.xml
reference/session/functions/session-is-registered.xml
reference/session/functions/session-module-name.xml
reference/session/functions/session-name.xml
reference/session/functions/session-regenerate-id.xml
reference/session/functions/session-register.xml
reference/session/functions/session-save-path.xml
reference/session/functions/session-set-cookie-params.xml
reference/session/functions/session-set-save-handler.xml
reference/session/functions/session-start.xml
reference/session/functions/session-unregister.xml
reference/session/functions/session-unset.xml
reference/session/functions/session-write-close.xml
Там, где я сомневаюсь в понимании и употреблении
терминов выставлено
<!-- Reviewed: no -->
Решил для себя не транслитерировать cookie. Слово
"куки" мне почему-то
не нравится. А "cache" прописывать как "кэш".
Также прошу коллег прокомментировать качество этого и
других моих
переводов в директории reference/session.
Стараюсь строить предложения в обезличенной форме,
возможно это не
приветствуется.
--
Andrey Bezrukov
Index: reference/session/ini.xml =================================================================== --- reference/session/ini.xml (revision 0) +++ reference/session/ini.xml (revision 0) @@ -0,0 +1,789 @@ +<?xml version="1.0" encoding="utf-8"?> +<!-- EN-Revision: 312729 Maintainer: shein Status: ready --> +<!-- Reviewed: yes --> +<!-- $Revision: 312729 $ --> +<section xml:id="session.configuration" xmlns="http://docbook.org/ns/docbook"> + &reftitle.runtime; + &extension.runtime; + <para> + <table> + <title>Опции настройки механизма сессий</title> + <tgroup cols="4"> + <thead> + <row> + <entry>Наименование</entry> + <entry>По умолчанию</entry> + <entry>Изменяемый</entry> + <entry>Изменений</entry> + </row> + </thead> + <tbody> + <row> + <entry><link linkend="ini.session.save-path">session.save_path</link></entry> + <entry>""</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> + <entry><link linkend="ini.session.name">session.name</link></entry> + <entry>"PHPSESSID"</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> + <entry><link linkend="ini.session.save-handler">session.save_handler</link></entry> + <entry>"files"</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> + <entry><link linkend="ini.session.auto-start">session.auto_start</link></entry> + <entry>"0"</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> + <entry><link linkend="ini.session.gc-probability">session.gc_probability</link></entry> + <entry>"1"</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> + <entry><link linkend="ini.session.gc-divisor">session.gc_divisor</link></entry> + <entry>"100"</entry> + <entry>PHP_INI_ALL</entry> + <entry>Доступно с PHP 4.3.2.</entry> + </row> + <row> + <entry><link linkend="ini.session.gc-maxlifetime">session.gc_maxlifetime</link></entry> + <entry>"1440"</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> + <entry><link linkend="ini.session.serialize-handler">session.serialize_handler</link></entry> + <entry>"php"</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> + <entry><link linkend="ini.session.cookie-lifetime">session.cookie_lifetime</link></entry> + <entry>"0"</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> + <entry><link linkend="ini.session.cookie-path">session.cookie_path</link></entry> + <entry>"/"</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> + <entry><link linkend="ini.session.cookie-domain">session.cookie_domain</link></entry> + <entry>""</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> + <entry><link linkend="ini.session.cookie-secure">session.cookie_secure</link></entry> + <entry>""</entry> + <entry>PHP_INI_ALL</entry> + <entry>Доступно с PHP 4.0.4.</entry> + </row> + <row> + <entry><link linkend="ini.session.cookie-httponly">session.cookie_httponly</link></entry> + <entry>""</entry> + <entry>PHP_INI_ALL</entry> + <entry>Доступно с PHP 5.2.0.</entry> + </row> + <row> + <entry><link linkend="ini.session.use-cookies">session.use_cookies</link></entry> + <entry>"1"</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> + <entry><link linkend="ini.session.use-only-cookies">session.use_only_cookies</link></entry> + <entry>"1"</entry> + <entry>PHP_INI_ALL</entry> + <entry>Доступно с PHP 4.3.0.</entry> + </row> + <row> + <entry><link linkend="ini.session.referer-check">session.referer_check</link></entry> + <entry>""</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> + <entry><link linkend="ini.session.entropy-file">session.entropy_file</link></entry> + <entry>""</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> + <entry><link linkend="ini.session.entropy-length">session.entropy_length</link></entry> + <entry>"0"</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> + <entry><link linkend="ini.session.cache-limiter">session.cache_limiter</link></entry> + <entry>"nocache"</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> + <entry><link linkend="ini.session.cache-expire">session.cache_expire</link></entry> + <entry>"180"</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> + <entry><link linkend="ini.session.use-trans-sid">session.use_trans_sid</link></entry> + <entry>"0"</entry> + <entry>PHP_INI_ALL</entry> + <entry>PHP_INI_ALL в PHP <= 4.2.3. PHP_INI_PERDIR в PHP < 5. Доступно с PHP 4.0.3.</entry> + </row> + <row> + <entry><link linkend="ini.session.bug-compat-42">session.bug_compat_42</link></entry> + <entry>"1"</entry> + <entry>PHP_INI_ALL</entry> + <entry>Доступно с PHP 4.3.0. Упразднено в PHP 5.4.0.</entry> + </row> + <row> + <entry><link linkend="ini.session.bug-compat-warn">session.bug_compat_warn</link></entry> + <entry>"1"</entry> + <entry>PHP_INI_ALL</entry> + <entry>Доступно с PHP 4.3.0. Упразднено в PHP 5.4.0.</entry> + </row> + <row> + <entry><link linkend="ini.session.hash-function">session.hash_function</link></entry> + <entry>"0"</entry> + <entry>PHP_INI_ALL</entry> + <entry>Доступно с PHP 5.0.0.</entry> + </row> + <row> + <entry><link linkend="ini.session.hash-bits-per-character">session.hash_bits_per_character</link></entry> + <entry>"4"</entry> + <entry>PHP_INI_ALL</entry> + <entry>Доступно с PHP 5.0.0.</entry> + </row> + <row> + <entry><link linkend="ini.url-rewriter.tags">url_rewriter.tags</link></entry> + <entry>"a=href,area=href,frame=src,form=,fieldset="</entry> + <entry>PHP_INI_ALL</entry> + <entry>Доступно с PHP 4.0.4.</entry> + </row> + <row> + <entry>session.upload_progress.enabled</entry> + <entry>"1"</entry> + <entry>PHP_INI_PERDIR</entry> + <entry>Доступно с PHP 5.4.0.</entry> + </row> + <row> + <entry>session.upload_progress.cleanup</entry> + <entry>"1"</entry> + <entry>PHP_INI_PERDIR</entry> + <entry>Доступно с PHP 5.4.0.</entry> + </row> + <row> + <entry>session.upload_progress.prefix</entry> + <entry>"upload_progress_"</entry> + <entry>PHP_INI_PERDIR</entry> + <entry>Доступно с PHP 5.4.0.</entry> + </row> + <row> + <entry>session.upload_progress.name</entry> + <entry>"PHP_SESSION_UPLOAD_PROGRESS"</entry> + <entry>PHP_INI_PERDIR</entry> + <entry>Доступно с PHP 5.4.0.</entry> + </row> + <row> + <entry>session.upload_progress.freq</entry> + <entry>"1%"</entry> + <entry>PHP_INI_PERDIR</entry> + <entry>Доступно с PHP 5.4.0.</entry> + </row> + <row> + <entry>session.upload_progress.min_freq</entry> + <entry>"1"</entry> + <entry>PHP_INI_PERDIR</entry> + <entry>Доступно с PHP 5.4.0.</entry> + </row> + </tbody> + </tgroup> + </table> + &ini.php.constants; + </para> + <para> + Система управления сессиями поддерживает ряд опций, которые могут быть + указаны в файле &php.ini;. Ниже приводится краткий обзор. + <variablelist> + + <varlistentry xml:id="ini.session.save-handler"> + <term> + <parameter>session.save_handler</parameter> + <type>string</type> + </term> + <listitem> + <simpara> + <literal>session.save_handler</literal> определяет имя обработчика, который + используется для хранения и извлечения данных, связанных с сессией. + По умолчанию, <literal>files</literal>. Следует обратить внимание, что + некоторые расширения могут зарегистрировать собственные + <literal>save_handler</literal>. Текущие зарегистрированные обработчики + отображаются в <function>phpinfo</function>. См.также + <function>session_set_save_handler</function>. + </simpara> + </listitem> + </varlistentry> + + <varlistentry xml:id="ini.session.save-path"> + <term> + <parameter>session.save_path</parameter> + <type>string</type> + </term> + <listitem> + <simpara> + <literal>session.save_path</literal> определяет аргумент, который + передается в обработчик сохранения. При установленном по умолчанию + обработчике files, аргумент содержит путь, где будут создаваться файлы. + См.также <function>session_save_path</function>. + </simpara> + <para> + У этой директивы также существует дополнительный аргумент N, определяющий + глубину размещения файлов сессии относительно указанной директории. + Например, указание <literal>'5;/tmp'</literal> может в конечном итоге + привести к такому размещению файла сессии + <literal>/tmp/4/b/1/e/3/sess_4b1e384ad74619bd212e236e52a5a174If + </literal>. Для того чтобы использовать аргумент N необходимо + предварительно создать все эти директории. Небольшой скрипт, + расположенный в <filename>ext/session</filename>, позволяет это выполнить. + Версия для bash именуется <filename>mod_files.sh</filename>, версия для + интерпретатора ОС Windows -- <filename>mod_files.bat</filename>. + Также следует учитывать, что если N определен и больше 0, то автоматическая + сборка мусора не выполняется. См. &php.ini; для большей информации. + Если используется N, необходимо также удостовериться, что значение + <literal>session.save_path</literal> указано в кавычках, поскольку + разделитель (<literal>;</literal>) в &php.ini; используется как знак + комментария. + </para> + <warning> + <para> + Если установить в качестве значения общедоступную для чтения директорию, + например <filename>/tmp</filename> (по умолчанию), прочие пользователи + сервера получат возможность перехватить сессию пользователя, получив + список файлов такой директории. + </para> + </warning> + <note> + <simpara> + До версии PHP 4.3.6, пользователям Windows приходилось изменять эту + переменную для использования механизма сессий. Правильный путь мог быть + таким: <filename>c:/temp</filename>. + </simpara> + </note> + </listitem> + </varlistentry> + + <varlistentry xml:id="ini.session.name"> + <term> + <parameter>session.name</parameter> + <type>string</type> + </term> + <listitem> + <simpara> + <literal>session.name</literal> определяет название сессии, + используемое как название Cookies. Может содержать только цифры и буквы. + По умолчанию, <literal>PHPSESSID</literal>. + См.также <function>session_name</function>. + </simpara> + </listitem> + </varlistentry> + + <varlistentry xml:id="ini.session.auto-start"> + <term> + <parameter>session.auto_start</parameter> + <type>boolean</type> + </term> + <listitem> + <simpara> + <literal>session.auto_start</literal> определяет, будет ли модуль сессии + запускать сессию автоматически при старте. Значение по умолчанию + <literal>0</literal> (отключено). + </simpara> + </listitem> + </varlistentry> + + <varlistentry xml:id="ini.session.serialize-handler"> + <term> + <parameter>session.serialize_handler</parameter> + <type>string</type> + </term> + <listitem> + <simpara> + <literal>session.serialize_handler</literal> определяет имя обработчика, + который используется для сериализации / десериализации данных. В настоящее + время используется внутренний формат PHP (наименование <literal>php + </literal> или <literal>php_binary</literal>), также поддерживается WDDX + (наименование <literal>wddx</literal>). WDDX доступен только в том случае, + если PHP скомпилирован с <link linkend="ref.wddx">поддержка WDDX</link>. + Значение по умолчанию: <literal>php</literal>. + </simpara> + </listitem> + </varlistentry> + + <varlistentry xml:id="ini.session.gc-probability"> + <term> + <parameter>session.gc_probability</parameter> + <type>integer</type> + </term> + <listitem> + <simpara> + <literal>session.gc_probability</literal> в сочетании с + <literal>session.gc_divisor</literal> определяет вероятность того, + что функция gc (сборщика мусора) запущена. + По умолчанию, <literal>1</literal>. См.подробнее в <link + linkend="ini.session.gc-divisor">session.gc_divisor</link>. + </simpara> + </listitem> + </varlistentry> + + <varlistentry xml:id="ini.session.gc-divisor"> + <term> + <parameter>session.gc_divisor</parameter> + <type>integer</type> + </term> + <listitem> + <simpara> + <literal>session.gc_divisor</literal> в сочетании с + <literal>session.gc_probability</literal> определяет вероятность того, + что функция gc (сборщика мусора) запускается при каждой инициализации + сессии. Вероятность рассчитывается как gc_probability/gc_divisor, т.е. + 1/100 означает, что функция gc запускается в одном случае из ста, или 1% + запусков при каждом запросе. + <literal>session.gc_divisor</literal> по умолчанию имеет значение + <literal>100</literal>. + </simpara> + </listitem> + </varlistentry> + + <varlistentry xml:id="ini.session.gc-maxlifetime"> + <term> + <parameter>session.gc_maxlifetime</parameter> + <type>integer</type> + </term> + <listitem> + <simpara> + <literal>session.gc_maxlifetime</literal> задает отсрочку времени в + секундах, после которой данные будут рассматриваться как "мусор" и + потенциально будут удалены. Сбор мусора может произойти во время начала + сессии + (в зависимости от значений <link + linkend="ini.session.gc-probability">session.gc_probability</link> и + <link linkend="ini.session.gc-divisor">session.gc_divisor</link>). + </simpara> + <note> + <para> + Если разные скрипты имеют разные значения + <literal>session.gc_maxlifetime</literal>, но при этом одни и + те же места для хранения данных сессии, то скрипт с минимальным + значением уничтожит все данные. В таком случае следует использовать + эту директиву вместе с + <link linkend="ini.session.save-path">session.save_path</link>. + </para> + </note> + <note> + <simpara>Если по умолчанию используется обработчик file, файловая система + должна отслеживать время доступа (access time, atime). Windows FAT этого не + позволяет, при использовании данной файловой системы (или любой другой без + поддержки отслеживания времени доступа) придется разрабатывать собственный + способ уборки сессионного мусора. + Начиная с версии PHP 4.2.3 используется mtime (modified date, дата + изменений) вместо atime. В этом случае поддержка файловой системой atime не + требуется. + </simpara> + </note> + </listitem> + </varlistentry> + + <varlistentry xml:id="ini.session.referer-check"> + <term> + <parameter>session.referer_check</parameter> + <type>string</type> + </term> + <listitem> + <simpara> + <literal>session.referer_check</literal> содержит подстроку, которую + можно использовать при проверке HTTP Referer. Если клиентом был послан + referer и подстрока не была выявлена, то идентификатор сессии + будет помечен как недействительный. По умолчанию используется пустая + строка. + </simpara> + </listitem> + </varlistentry> + + <varlistentry xml:id="ini.session.entropy-file"> + <term> + <parameter>session.entropy_file</parameter> + <type>string</type> + </term> + <listitem> + <simpara> + <literal>session.entropy_file</literal> содержит путь к ресурсу(файлу), + используемому как дополнительный источник энтропии в процессе создания + идентификатора сессии. Например, <literal>/dev/random</literal> или + <literal>/dev/urandom</literal>, которые доступны на многих Unix-системах. + </simpara> + <simpara> + Эта возможность также поддерживается в Windows начиная с версии PHP 5.3.3. + Указание ненулевого значения в <literal>session.entropy_length</literal> + предписывает PHP использовать Windows Random API как источник энтропии. + </simpara> + </listitem> + </varlistentry> + + <varlistentry xml:id="ini.session.entropy-length"> + <term> + <parameter>session.entropy_length</parameter> + <type>integer</type> + </term> + <listitem> + <simpara> + <literal>session.entropy_length</literal> определяет количество байтов, + которые будут прочитаны из файла, указанного выше. По умолчанию, + <literal>0</literal> (отключено). + </simpara> + </listitem> + </varlistentry> + + <varlistentry xml:id="ini.session.use-cookies"> + <term> + <parameter>session.use_cookies</parameter> + <type>boolean</type> + </term> + <listitem> + <simpara> + <literal>session.use_cookies</literal> определяет, будет ли модуль + использовать cookies для хранения идентификатора сессии на стороне клиента. + По умолчанию <literal>1</literal> (включено). + </simpara> + </listitem> + </varlistentry> + + <varlistentry xml:id="ini.session.use-only-cookies"> + <term> + <parameter>session.use_only_cookies</parameter> + <type>boolean</type> + </term> + <listitem> + <simpara> + <literal>session.use_only_cookies</literal> определяет, будет ли + модуль использовать <emphasis role="strong">только</emphasis> cookies + для хранения идентификатора сессии на стороне клиента. + Включение этого параметра предотвращает атаки с использованием + идентификатора сессии, размещенного в URL. Добавлено в PHP 4.3.0. + Значение по умолчанию <literal>1</literal> (включено) с версии PHP 5.3.0. + </simpara> + </listitem> + </varlistentry> + + + <varlistentry xml:id="ini.session.cookie-lifetime"> + <term> + <parameter>session.cookie_lifetime</parameter> + <type>integer</type> + </term> + <listitem> + <simpara> + <literal>session.cookie_lifetime</literal> указывает время жизни cookies, + отправляемого в браузер клиента, в секундах. Значение 0 означает, что время + жизни cookies до закрытия браузера. По умолчанию <literal>0</literal>. + См.также <function>session_get_cookie_params</function> и + <function>session_set_cookie_params</function>. + </simpara> + <note> + <para> + Отметка окончания времени устанавливается по отношению к серверу времени, + который не обязательно совпадает с временем в браузере клиента. + </para> + </note> + </listitem> + </varlistentry> + + <varlistentry xml:id="ini.session.cookie-path"> + <term> + <parameter>session.cookie_path</parameter> + <type>string</type> + </term> + <listitem> + <simpara> + <literal>session.cookie_path</literal> указывает путь для установки cookies + с сессией. По умолчанию <literal>/</literal>. См.также + <function>session_get_cookie_params</function> и + <function>session_set_cookie_params</function>. + </simpara> + </listitem> + </varlistentry> + + <varlistentry xml:id="ini.session.cookie-domain"> + <term> + <parameter>session.cookie_domain</parameter> + <type>string</type> + </term> + <listitem> + <simpara> + <literal>session.cookie_domain</literal> указывает домен для установки + cookies с сессией. В соответствии со спецификацией нет смысла дополнительно + указывать имя хоста, который сгенерировал cookies. + См.также <function>session_get_cookie_params</function> и + <function>session_set_cookie_params</function>. + </simpara> + </listitem> + </varlistentry> + + <varlistentry xml:id="ini.session.cookie-secure"> + <term> + <parameter>session.cookie_secure</parameter> + <type>boolean</type> + </term> + <listitem> + <simpara> + <literal>session.cookie_secure</literal> указывает, должны ли cookies + передаваться только через защищенное соединение. По умолчанию + <literal>off</literal>. + Добавлено в версии PHP 4.0.4. См.также + <function>session_get_cookie_params</function> и + <function>session_set_cookie_params</function>. + </simpara> + </listitem> + </varlistentry> + + <varlistentry xml:id="ini.session.cookie-httponly"> + <term> + <parameter>session.cookie_httponly</parameter> + <type>boolean</type> + </term> + <listitem> + <simpara> + Отметка, согласно которой доступ к cookies может быть только через HTTP + протокол. Это означает, что cookies не будет доступна через скриптовые языки, + такие как JavaScrupt. Данная настройка позволяет эффективно защитить от + XSS атак (к сожалению, эта функция поддерживается не всеми браузерами). + </simpara> + </listitem> + </varlistentry> + + <varlistentry xml:id="ini.session.cache-limiter"> + <term> + <parameter>session.cache_limiter</parameter> + <type>string</type> + </term> + <listitem> + <simpara> + <literal>session.cache_limiter</literal> определяет метод контроля + кэша, используемого для страниц сессий. Может принимать одно из следующих + значений: + <literal>nocache</literal>, <literal>private</literal>, + <literal>private_no_expire</literal>, или <literal>public</literal>. + По умолчанию <literal>nocache</literal>. О данных значениях см.подробнее в + <function>session_cache_limiter</function>. + </simpara> + </listitem> + </varlistentry> + + + <varlistentry xml:id="ini.session.cache-expire"> + <term> + <parameter>session.cache_expire</parameter> + <type>integer</type> + </term> + <listitem> + <simpara> + <literal>session.cache_expire</literal> указывает время жизни + кэшированных страниц сессий в минутах, это никак не влияет на ограничитель + nocache. По умолчанию <literal>180</literal>. См.также + <function>session_cache_expire</function>. + </simpara> + </listitem> + </varlistentry> + + <varlistentry xml:id="ini.session.use-trans-sid"> + <term> + <parameter>session.use_trans_sid</parameter> + <type>boolean</type> + </term> + <listitem> + <simpara> + <literal>session.use_trans_sid</literal> определяет использовать ли + прозрачную поддержку sid. По умолчанию + <literal>0</literal> (отключено). + </simpara> + <note> + <simpara> + Для PHP 4.1.2 и более ранних, опция доступна при компиляции с + <link linkend="configure.enable-trans-sid"> + <literal>--enable-trans-sid</literal></link>. + Начиная с PHP 4.2.0, возможность trans-sid всегда доступна. + </simpara> + <simpara> + Управление сессией на основе URL имеет дополнительные риски + безопасности по сравнению с управлением на основе cookies. В качестве + примера можно упомянуть такие ситуации, когда пользователи + могут отправить URL, содержащий идентификатор активной сессии своим + друзьям по электронной почте или сохранить ссылку с идентификатором + в закладках и все время посещать сайт с одним и тем же идентификатором. + </simpara> + </note> + </listitem> + </varlistentry> + + <varlistentry xml:id="ini.session.bug-compat-42"> + <term> + <parameter>session.bug_compat_42</parameter> + <type>boolean</type> + </term> + <listitem> + <simpara> + PHP версии 4.2.3 и более ранние имеют недокументированную особенность / + ошибку, позволяющую инициализировать переменную сессии как + глобальную, хотя директива + <link linkend="ini.register-globals">register_globals</link> отключена. + PHP 4.3.0 и более поздние предупреждают, если эта особенность используется + и если <link linkend="ini.session.bug-compat-warn"> + session.bug_compat_warn</link> также включена. Эта особенность / ошибка + может быть отключена при отключении данной директивы. + </simpara> + </listitem> + </varlistentry> + + <varlistentry xml:id="ini.session.bug-compat-warn"> + <term> + <parameter>session.bug_compat_warn</parameter> + <type>boolean</type> + </term> + <listitem> + <simpara> + PHP версии 4.2.3 и более ранние имеют недокументированную особенность / + ошибка, позволяющую инициализировать переменную сессии как + глобальную, хотя директива + <link linkend="ini.register-globals">register_globals</link> отключена. + PHP 4.3.0 и более поздние предупреждают, если эта особенность используется + при помощи включения + <link linkend="ini.session.bug-compat-42">session.bug_compat_42</link> + и <link linkend="ini.session.bug-compat-warn"> + session.bug_compat_warn</link>. + </simpara> + </listitem> + </varlistentry> + + <varlistentry xml:id="ini.session.hash-function"> + <term> + <parameter>session.hash_function</parameter> + <type>mixed</type> + </term> + <listitem> + <simpara> + <literal>session.hash_function</literal> позволяет указать алгоритм + хэширования, используемый для генерации идентификатора сессии. + '0' означает MD5 (128 bits) и + '1' означает SHA-1 (160 bits). + </simpara> + <para> + Начиная с PHP 5.3.0 также возможно указать любой из алгоритмов, + предусмотренных <link linkend="ref.hash">hash extension</link> (если + это доступно), например <literal>sha512</literal> или + <literal>whirlpool</literal>. Полный список алгоритмов может быть + получен функцией <function>hash_algos</function>. + </para> + <note> + <para> + Эта установка была введена в PHP 5. + </para> + </note> + </listitem> + </varlistentry> + + <varlistentry xml:id="ini.session.hash-bits-per-character"> + <term> + <parameter>session.hash_bits_per_character</parameter> + <type>integer</type> + </term> + <listitem> + <simpara> + <literal>session.hash_bits_per_character</literal> позволяет определить + сколько бит хранится в каждом символе при преобразовании бинарного + представления во что-либо удобочитаемое. Возможные значения '4' (0-9, a-f), + '5' (0-9, a-v), and '6' (0-9, a-z, A-Z, "-", ","). + </simpara> + <note> + <para> + Эта установка была введена в PHP 5. + </para> + </note> + </listitem> + </varlistentry> + + <varlistentry xml:id="ini.url-rewriter.tags"> + <term> + <parameter>url_rewriter.tags</parameter> + <type>string</type> + </term> + <listitem> + <simpara> + <literal>url_rewriter.tags</literal> определяет, какие HTML-теги + будут переписаны при включении идентификатора сессии при условии + включенной поддержки transparent sid. + По умолчанию + <literal>a=href,area=href,frame=src,input=src,form=fakeentry,fieldset=</literal> + </simpara> + <note> + <simpara> + Если необходимо строгое соответствие HTML/XHTML следует удалить + элементы <literal>form</literal> из документа и использовать + тэг <fieldset> в HTML формах. + </simpara> + </note> + </listitem> + </varlistentry> + </variablelist> + </para> + + <para> + Настройки <link + linkend="ini.track-vars"><literal>track_vars</literal></link> и + <link + linkend="ini.register-globals"><literal>register_globals</literal></link> + позволяют повлиять на способ хранения и использования переменных сессии. + </para> + + <note> + <para> + По состоянию на PHP 4.0.3, <link + linkend="ini.track-vars"><literal>track_vars</literal></link> постоянно + включен. + </para> + </note> + +</section> + +<!-- 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 +-->
Index: reference/session/ini.xml =================================================================== --- reference/session/ini.xml (revision 0) +++ reference/session/ini.xml (revision 0) @@ -0,0 +1,789 @@ +<?xml version="1.0" encoding="utf-8"?> +<!-- EN-Revision: 312729 Maintainer: shein Status: ready --> +<!-- Reviewed: yes --> +<!-- $Revision: 312729 $ --> +<section xml:id="session.configuration" xmlns="http://docbook.org/ns/docbook"> + &reftitle.runtime; + &extension.runtime; + <para> + <table> + <title>Опции настройки механизма сессий</title> + <tgroup cols="4"> + <thead> + <row> + <entry>Наименование</entry> + <entry>По умолчанию</entry> + <entry>Изменяемый</entry> + <entry>Изменений</entry> + </row> + </thead> + <tbody> + <row> + <entry><link linkend="ini.session.save-path">session.save_path</link></entry> + <entry>""</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> + <entry><link linkend="ini.session.name">session.name</link></entry> + <entry>"PHPSESSID"</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> + <entry><link linkend="ini.session.save-handler">session.save_handler</link></entry> + <entry>"files"</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> + <entry><link linkend="ini.session.auto-start">session.auto_start</link></entry> + <entry>"0"</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> + <entry><link linkend="ini.session.gc-probability">session.gc_probability</link></entry> + <entry>"1"</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> + <entry><link linkend="ini.session.gc-divisor">session.gc_divisor</link></entry> + <entry>"100"</entry> + <entry>PHP_INI_ALL</entry> + <entry>Доступно с PHP 4.3.2.</entry> + </row> + <row> + <entry><link linkend="ini.session.gc-maxlifetime">session.gc_maxlifetime</link></entry> + <entry>"1440"</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> + <entry><link linkend="ini.session.serialize-handler">session.serialize_handler</link></entry> + <entry>"php"</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> + <entry><link linkend="ini.session.cookie-lifetime">session.cookie_lifetime</link></entry> + <entry>"0"</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> + <entry><link linkend="ini.session.cookie-path">session.cookie_path</link></entry> + <entry>"/"</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> + <entry><link linkend="ini.session.cookie-domain">session.cookie_domain</link></entry> + <entry>""</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> + <entry><link linkend="ini.session.cookie-secure">session.cookie_secure</link></entry> + <entry>""</entry> + <entry>PHP_INI_ALL</entry> + <entry>Доступно с PHP 4.0.4.</entry> + </row> + <row> + <entry><link linkend="ini.session.cookie-httponly">session.cookie_httponly</link></entry> + <entry>""</entry> + <entry>PHP_INI_ALL</entry> + <entry>Доступно с PHP 5.2.0.</entry> + </row> + <row> + <entry><link linkend="ini.session.use-cookies">session.use_cookies</link></entry> + <entry>"1"</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> + <entry><link linkend="ini.session.use-only-cookies">session.use_only_cookies</link></entry> + <entry>"1"</entry> + <entry>PHP_INI_ALL</entry> + <entry>Доступно с PHP 4.3.0.</entry> + </row> + <row> + <entry><link linkend="ini.session.referer-check">session.referer_check</link></entry> + <entry>""</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> + <entry><link linkend="ini.session.entropy-file">session.entropy_file</link></entry> + <entry>""</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> + <entry><link linkend="ini.session.entropy-length">session.entropy_length</link></entry> + <entry>"0"</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> + <entry><link linkend="ini.session.cache-limiter">session.cache_limiter</link></entry> + <entry>"nocache"</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> + <entry><link linkend="ini.session.cache-expire">session.cache_expire</link></entry> + <entry>"180"</entry> + <entry>PHP_INI_ALL</entry> + <entry></entry> + </row> + <row> + <entry><link linkend="ini.session.use-trans-sid">session.use_trans_sid</link></entry> + <entry>"0"</entry> + <entry>PHP_INI_ALL</entry> + <entry>PHP_INI_ALL в PHP <= 4.2.3. PHP_INI_PERDIR в PHP < 5. Доступно с PHP 4.0.3.</entry> + </row> + <row> + <entry><link linkend="ini.session.bug-compat-42">session.bug_compat_42</link></entry> + <entry>"1"</entry> + <entry>PHP_INI_ALL</entry> + <entry>Доступно с PHP 4.3.0. Упразднено в PHP 5.4.0.</entry> + </row> + <row> + <entry><link linkend="ini.session.bug-compat-warn">session.bug_compat_warn</link></entry> + <entry>"1"</entry> + <entry>PHP_INI_ALL</entry> + <entry>Доступно с PHP 4.3.0. Упразднено в PHP 5.4.0.</entry> + </row> + <row> + <entry><link linkend="ini.session.hash-function">session.hash_function</link></entry> + <entry>"0"</entry> + <entry>PHP_INI_ALL</entry> + <entry>Доступно с PHP 5.0.0.</entry> + </row> + <row> + <entry><link linkend="ini.session.hash-bits-per-character">session.hash_bits_per_character</link></entry> + <entry>"4"</entry> + <entry>PHP_INI_ALL</entry> + <entry>Доступно с PHP 5.0.0.</entry> + </row> + <row> + <entry><link linkend="ini.url-rewriter.tags">url_rewriter.tags</link></entry> + <entry>"a=href,area=href,frame=src,form=,fieldset="</entry> + <entry>PHP_INI_ALL</entry> + <entry>Доступно с PHP 4.0.4.</entry> + </row> + <row> + <entry>session.upload_progress.enabled</entry> + <entry>"1"</entry> + <entry>PHP_INI_PERDIR</entry> + <entry>Доступно с PHP 5.4.0.</entry> + </row> + <row> + <entry>session.upload_progress.cleanup</entry> + <entry>"1"</entry> + <entry>PHP_INI_PERDIR</entry> + <entry>Доступно с PHP 5.4.0.</entry> + </row> + <row> + <entry>session.upload_progress.prefix</entry> + <entry>"upload_progress_"</entry> + <entry>PHP_INI_PERDIR</entry> + <entry>Доступно с PHP 5.4.0.</entry> + </row> + <row> + <entry>session.upload_progress.name</entry> + <entry>"PHP_SESSION_UPLOAD_PROGRESS"</entry> + <entry>PHP_INI_PERDIR</entry> + <entry>Доступно с PHP 5.4.0.</entry> + </row> + <row> + <entry>session.upload_progress.freq</entry> + <entry>"1%"</entry> + <entry>PHP_INI_PERDIR</entry> + <entry>Доступно с PHP 5.4.0.</entry> + </row> + <row> + <entry>session.upload_progress.min_freq</entry> + <entry>"1"</entry> + <entry>PHP_INI_PERDIR</entry> + <entry>Доступно с PHP 5.4.0.</entry> + </row> + </tbody> + </tgroup> + </table> + &ini.php.constants; + </para> + <para> + Система управления сессиями поддерживает ряд опций, которые могут быть + указаны в файле &php.ini;. Ниже приводится краткий обзор. + <variablelist> + + <varlistentry xml:id="ini.session.save-handler"> + <term> + <parameter>session.save_handler</parameter> + <type>string</type> + </term> + <listitem> + <simpara> + <literal>session.save_handler</literal> определяет имя обработчика, который + используется для хранения и извлечения данных, связанных с сессией. + По умолчанию, <literal>files</literal>. Следует обратить внимание, что + некоторые расширения могут зарегистрировать собственные + <literal>save_handler</literal>. Текущие зарегистрированные обработчики + отображаются в <function>phpinfo</function>. См.также + <function>session_set_save_handler</function>. + </simpara> + </listitem> + </varlistentry> + + <varlistentry xml:id="ini.session.save-path"> + <term> + <parameter>session.save_path</parameter> + <type>string</type> + </term> + <listitem> + <simpara> + <literal>session.save_path</literal> определяет аргумент, который + передается в обработчик сохранения. При установленном по умолчанию + обработчике files, аргумент содержит путь, где будут создаваться файлы. + См.также <function>session_save_path</function>. + </simpara> + <para> + У этой директивы также существует дополнительный аргумент N, определяющий + глубину размещения файлов сессии относительно указанной директории. + Например, указание <literal>'5;/tmp'</literal> может в конечном итоге + привести к такому размещению файла сессии + <literal>/tmp/4/b/1/e/3/sess_4b1e384ad74619bd212e236e52a5a174If + </literal>. Для того чтобы использовать аргумент N необходимо + предварительно создать все эти директории. Небольшой скрипт, + расположенный в <filename>ext/session</filename>, позволяет это выполнить. + Версия для bash именуется <filename>mod_files.sh</filename>, версия для + интерпретатора ОС Windows -- <filename>mod_files.bat</filename>. + Также следует учитывать, что если N определен и больше 0, то автоматическая + сборка мусора не выполняется. См. &php.ini; для большей информации. + Если используется N, необходимо также удостовериться, что значение + <literal>session.save_path</literal> указано в кавычках, поскольку + разделитель (<literal>;</literal>) в &php.ini; используется как знак + комментария. + </para> + <warning> + <para> + Если установить в качестве значения общедоступную для чтения директорию, + например <filename>/tmp</filename> (по умолчанию), прочие пользователи + сервера получат возможность перехватить сессию пользователя, получив + список файлов такой директории. + </para> + </warning> + <note> + <simpara> + До версии PHP 4.3.6, пользователям Windows приходилось изменять эту + переменную для использования механизма сессий. Правильный путь мог быть + таким: <filename>c:/temp</filename>. + </simpara> + </note> + </listitem> + </varlistentry> + + <varlistentry xml:id="ini.session.name"> + <term> + <parameter>session.name</parameter> + <type>string</type> + </term> + <listitem> + <simpara> + <literal>session.name</literal> определяет название сессии, + используемое как название Cookies. Может содержать только цифры и буквы. + По умолчанию, <literal>PHPSESSID</literal>. + См.также <function>session_name</function>. + </simpara> + </listitem> + </varlistentry> + + <varlistentry xml:id="ini.session.auto-start"> + <term> + <parameter>session.auto_start</parameter> + <type>boolean</type> + </term> + <listitem> + <simpara> + <literal>session.auto_start</literal> определяет, будет ли модуль сессии + запускать сессию автоматически при старте. Значение по умолчанию + <literal>0</literal> (отключено). + </simpara> + </listitem> + </varlistentry> + + <varlistentry xml:id="ini.session.serialize-handler"> + <term> + <parameter>session.serialize_handler</parameter> + <type>string</type> + </term> + <listitem> + <simpara> + <literal>session.serialize_handler</literal> определяет имя обработчика, + который используется для сериализации / десериализации данных. В настоящее + время используется внутренний формат PHP (наименование <literal>php + </literal> или <literal>php_binary</literal>), также поддерживается WDDX + (наименование <literal>wddx</literal>). WDDX доступен только в том случае, + если PHP скомпилирован с <link linkend="ref.wddx">поддержка WDDX</link>. + Значение по умолчанию: <literal>php</literal>. + </simpara> + </listitem> + </varlistentry> + + <varlistentry xml:id="ini.session.gc-probability"> + <term> + <parameter>session.gc_probability</parameter> + <type>integer</type> + </term> + <listitem> + <simpara> + <literal>session.gc_probability</literal> в сочетании с + <literal>session.gc_divisor</literal> определяет вероятность того, + что функция gc (сборщика мусора) запущена. + По умолчанию, <literal>1</literal>. См.подробнее в <link + linkend="ini.session.gc-divisor">session.gc_divisor</link>. + </simpara> + </listitem> + </varlistentry> + + <varlistentry xml:id="ini.session.gc-divisor"> + <term> + <parameter>session.gc_divisor</parameter> + <type>integer</type> + </term> + <listitem> + <simpara> + <literal>session.gc_divisor</literal> в сочетании с + <literal>session.gc_probability</literal> определяет вероятность того, + что функция gc (сборщика мусора) запускается при каждой инициализации + сессии. Вероятность рассчитывается как gc_probability/gc_divisor, т.е. + 1/100 означает, что функция gc запускается в одном случае из ста, или 1% + запусков при каждом запросе. + <literal>session.gc_divisor</literal> по умолчанию имеет значение + <literal>100</literal>. + </simpara> + </listitem> + </varlistentry> + + <varlistentry xml:id="ini.session.gc-maxlifetime"> + <term> + <parameter>session.gc_maxlifetime</parameter> + <type>integer</type> + </term> + <listitem> + <simpara> + <literal>session.gc_maxlifetime</literal> задает отсрочку времени в + секундах, после которой данные будут рассматриваться как "мусор" и + потенциально будут удалены. Сбор мусора может произойти во время начала + сессии + (в зависимости от значений <link + linkend="ini.session.gc-probability">session.gc_probability</link> и + <link linkend="ini.session.gc-divisor">session.gc_divisor</link>). + </simpara> + <note> + <para> + Если разные скрипты имеют разные значения + <literal>session.gc_maxlifetime</literal>, но при этом одни и + те же места для хранения данных сессии, то скрипт с минимальным + значением уничтожит все данные. В таком случае следует использовать + эту директиву вместе с + <link linkend="ini.session.save-path">session.save_path</link>. + </para> + </note> + <note> + <simpara>Если по умолчанию используется обработчик file, файловая система + должна отслеживать время доступа (access time, atime). Windows FAT этого не + позволяет, при использовании данной файловой системы (или любой другой без + поддержки отслеживания времени доступа) придется разрабатывать собственный + способ уборки сессионного мусора. + Начиная с версии PHP 4.2.3 используется mtime (modified date, дата + изменений) вместо atime. В этом случае поддержка файловой системой atime не + требуется. + </simpara> + </note> + </listitem> + </varlistentry> + + <varlistentry xml:id="ini.session.referer-check"> + <term> + <parameter>session.referer_check</parameter> + <type>string</type> + </term> + <listitem> + <simpara> + <literal>session.referer_check</literal> содержит подстроку, которую + можно использовать при проверке HTTP Referer. Если клиентом был послан + referer и подстрока не была выявлена, то идентификатор сессии + будет помечен как недействительный. По умолчанию используется пустая + строка. + </simpara> + </listitem> + </varlistentry> + + <varlistentry xml:id="ini.session.entropy-file"> + <term> + <parameter>session.entropy_file</parameter> + <type>string</type> + </term> + <listitem> + <simpara> + <literal>session.entropy_file</literal> содержит путь к ресурсу(файлу), + используемому как дополнительный источник энтропии в процессе создания + идентификатора сессии. Например, <literal>/dev/random</literal> или + <literal>/dev/urandom</literal>, которые доступны на многих Unix-системах. + </simpara> + <simpara> + Эта возможность также поддерживается в Windows начиная с версии PHP 5.3.3. + Указание ненулевого значения в <literal>session.entropy_length</literal> + предписывает PHP использовать Windows Random API как источник энтропии. + </simpara> + </listitem> + </varlistentry> + + <varlistentry xml:id="ini.session.entropy-length"> + <term> + <parameter>session.entropy_length</parameter> + <type>integer</type> + </term> + <listitem> + <simpara> + <literal>session.entropy_length</literal> определяет количество байтов, + которые будут прочитаны из файла, указанного выше. По умолчанию, + <literal>0</literal> (отключено). + </simpara> + </listitem> + </varlistentry> + + <varlistentry xml:id="ini.session.use-cookies"> + <term> + <parameter>session.use_cookies</parameter> + <type>boolean</type> + </term> + <listitem> + <simpara> + <literal>session.use_cookies</literal> определяет, будет ли модуль + использовать cookies для хранения идентификатора сессии на стороне клиента. + По умолчанию <literal>1</literal> (включено). + </simpara> + </listitem> + </varlistentry> + + <varlistentry xml:id="ini.session.use-only-cookies"> + <term> + <parameter>session.use_only_cookies</parameter> + <type>boolean</type> + </term> + <listitem> + <simpara> + <literal>session.use_only_cookies</literal> определяет, будет ли + модуль использовать <emphasis role="strong">только</emphasis> cookies + для хранения идентификатора сессии на стороне клиента. + Включение этого параметра предотвращает атаки с использованием + идентификатора сессии, размещенного в URL. Добавлено в PHP 4.3.0. + Значение по умолчанию <literal>1</literal> (включено) с версии PHP 5.3.0. + </simpara> + </listitem> + </varlistentry> + + + <varlistentry xml:id="ini.session.cookie-lifetime"> + <term> + <parameter>session.cookie_lifetime</parameter> + <type>integer</type> + </term> + <listitem> + <simpara> + <literal>session.cookie_lifetime</literal> указывает время жизни cookies, + отправляемого в браузер клиента, в секундах. Значение 0 означает, что время + жизни cookies до закрытия браузера. По умолчанию <literal>0</literal>. + См.также <function>session_get_cookie_params</function> и + <function>session_set_cookie_params</function>. + </simpara> + <note> + <para> + Отметка окончания времени устанавливается по отношению к серверу времени, + который не обязательно совпадает с временем в браузере клиента. + </para> + </note> + </listitem> + </varlistentry> + + <varlistentry xml:id="ini.session.cookie-path"> + <term> + <parameter>session.cookie_path</parameter> + <type>string</type> + </term> + <listitem> + <simpara> + <literal>session.cookie_path</literal> указывает путь для установки cookies + с сессией. По умолчанию <literal>/</literal>. См.также + <function>session_get_cookie_params</function> и + <function>session_set_cookie_params</function>. + </simpara> + </listitem> + </varlistentry> + + <varlistentry xml:id="ini.session.cookie-domain"> + <term> + <parameter>session.cookie_domain</parameter> + <type>string</type> + </term> + <listitem> + <simpara> + <literal>session.cookie_domain</literal> указывает домен для установки + cookies с сессией. В соответствии со спецификацией нет смысла дополнительно + указывать имя хоста, который сгенерировал cookies. + См.также <function>session_get_cookie_params</function> и + <function>session_set_cookie_params</function>. + </simpara> + </listitem> + </varlistentry> + + <varlistentry xml:id="ini.session.cookie-secure"> + <term> + <parameter>session.cookie_secure</parameter> + <type>boolean</type> + </term> + <listitem> + <simpara> + <literal>session.cookie_secure</literal> указывает, должны ли cookies + передаваться только через защищенное соединение. По умолчанию + <literal>off</literal>. + Добавлено в версии PHP 4.0.4. См.также + <function>session_get_cookie_params</function> и + <function>session_set_cookie_params</function>. + </simpara> + </listitem> + </varlistentry> + + <varlistentry xml:id="ini.session.cookie-httponly"> + <term> + <parameter>session.cookie_httponly</parameter> + <type>boolean</type> + </term> + <listitem> + <simpara> + Отметка, согласно которой доступ к cookies может быть только через HTTP + протокол. Это означает, что cookies не будет доступна через скриптовые языки, + такие как JavaScrupt. Данная настройка позволяет эффективно защитить от + XSS атак (к сожалению, эта функция поддерживается не всеми браузерами). + </simpara> + </listitem> + </varlistentry> + + <varlistentry xml:id="ini.session.cache-limiter"> + <term> + <parameter>session.cache_limiter</parameter> + <type>string</type> + </term> + <listitem> + <simpara> + <literal>session.cache_limiter</literal> определяет метод контроля + кэша, используемого для страниц сессий. Может принимать одно из следующих + значений: + <literal>nocache</literal>, <literal>private</literal>, + <literal>private_no_expire</literal>, или <literal>public</literal>. + По умолчанию <literal>nocache</literal>. О данных значениях см.подробнее в + <function>session_cache_limiter</function>. + </simpara> + </listitem> + </varlistentry> + + + <varlistentry xml:id="ini.session.cache-expire"> + <term> + <parameter>session.cache_expire</parameter> + <type>integer</type> + </term> + <listitem> + <simpara> + <literal>session.cache_expire</literal> указывает время жизни + кэшированных страниц сессий в минутах, это никак не влияет на ограничитель + nocache. По умолчанию <literal>180</literal>. См.также + <function>session_cache_expire</function>. + </simpara> + </listitem> + </varlistentry> + + <varlistentry xml:id="ini.session.use-trans-sid"> + <term> + <parameter>session.use_trans_sid</parameter> + <type>boolean</type> + </term> + <listitem> + <simpara> + <literal>session.use_trans_sid</literal> определяет использовать ли + прозрачную поддержку sid. По умолчанию + <literal>0</literal> (отключено). + </simpara> + <note> + <simpara> + Для PHP 4.1.2 и более ранних, опция доступна при компиляции с + <link linkend="configure.enable-trans-sid"> + <literal>--enable-trans-sid</literal></link>. + Начиная с PHP 4.2.0, возможность trans-sid всегда доступна. + </simpara> + <simpara> + Управление сессией на основе URL имеет дополнительные риски + безопасности по сравнению с управлением на основе cookies. В качестве + примера можно упомянуть такие ситуации, когда пользователи + могут отправить URL, содержащий идентификатор активной сессии своим + друзьям по электронной почте или сохранить ссылку с идентификатором + в закладках и все время посещать сайт с одним и тем же идентификатором. + </simpara> + </note> + </listitem> + </varlistentry> + + <varlistentry xml:id="ini.session.bug-compat-42"> + <term> + <parameter>session.bug_compat_42</parameter> + <type>boolean</type> + </term> + <listitem> + <simpara> + PHP версии 4.2.3 и более ранние имеют недокументированную особенность / + ошибку, позволяющую инициализировать переменную сессии как + глобальную, хотя директива + <link linkend="ini.register-globals">register_globals</link> отключена. + PHP 4.3.0 и более поздние предупреждают, если эта особенность используется + и если <link linkend="ini.session.bug-compat-warn"> + session.bug_compat_warn</link> также включена. Эта особенность / ошибка + может быть отключена при отключении данной директивы. + </simpara> + </listitem> + </varlistentry> + + <varlistentry xml:id="ini.session.bug-compat-warn"> + <term> + <parameter>session.bug_compat_warn</parameter> + <type>boolean</type> + </term> + <listitem> + <simpara> + PHP версии 4.2.3 и более ранние имеют недокументированную особенность / + ошибка, позволяющую инициализировать переменную сессии как + глобальную, хотя директива + <link linkend="ini.register-globals">register_globals</link> отключена. + PHP 4.3.0 и более поздние предупреждают, если эта особенность используется + при помощи включения + <link linkend="ini.session.bug-compat-42">session.bug_compat_42</link> + и <link linkend="ini.session.bug-compat-warn"> + session.bug_compat_warn</link>. + </simpara> + </listitem> + </varlistentry> + + <varlistentry xml:id="ini.session.hash-function"> + <term> + <parameter>session.hash_function</parameter> + <type>mixed</type> + </term> + <listitem> + <simpara> + <literal>session.hash_function</literal> позволяет указать алгоритм + хэширования, используемый для генерации идентификатора сессии. + '0' означает MD5 (128 bits) и + '1' означает SHA-1 (160 bits). + </simpara> + <para> + Начиная с PHP 5.3.0 также возможно указать любой из алгоритмов, + предусмотренных <link linkend="ref.hash">hash extension</link> (если + это доступно), например <literal>sha512</literal> или + <literal>whirlpool</literal>. Полный список алгоритмов может быть + получен функцией <function>hash_algos</function>. + </para> + <note> + <para> + Эта установка была введена в PHP 5. + </para> + </note> + </listitem> + </varlistentry> + + <varlistentry xml:id="ini.session.hash-bits-per-character"> + <term> + <parameter>session.hash_bits_per_character</parameter> + <type>integer</type> + </term> + <listitem> + <simpara> + <literal>session.hash_bits_per_character</literal> позволяет определить + сколько бит хранится в каждом символе при преобразовании бинарного + представления во что-либо удобочитаемое. Возможные значения '4' (0-9, a-f), + '5' (0-9, a-v), and '6' (0-9, a-z, A-Z, "-", ","). + </simpara> + <note> + <para> + Эта установка была введена в PHP 5. + </para> + </note> + </listitem> + </varlistentry> + + <varlistentry xml:id="ini.url-rewriter.tags"> + <term> + <parameter>url_rewriter.tags</parameter> + <type>string</type> + </term> + <listitem> + <simpara> + <literal>url_rewriter.tags</literal> определяет, какие HTML-теги + будут переписаны при включении идентификатора сессии при условии + включенной поддержки transparent sid. + По умолчанию + <literal>a=href,area=href,frame=src,input=src,form=fakeentry,fieldset=</literal> + </simpara> + <note> + <simpara> + Если необходимо строгое соответствие HTML/XHTML следует удалить + элементы <literal>form</literal> из документа и использовать + тэг <fieldset> в HTML формах. + </simpara> + </note> + </listitem> + </varlistentry> + </variablelist> + </para> + + <para> + Настройки <link + linkend="ini.track-vars"><literal>track_vars</literal></link> и + <link + linkend="ini.register-globals"><literal>register_globals</literal></link> + позволяют повлиять на способ хранения и использования переменных сессии. + </para> + + <note> + <para> + По состоянию на PHP 4.0.3, <link + linkend="ini.track-vars"><literal>track_vars</literal></link> постоянно + включен. + </para> + </note> + +</section> + +<!-- 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 +-->