1
0
mirror of https://github.com/php/doc-ru.git synced 2026-03-24 07:42:22 +01:00
Files
2022-12-16 00:55:54 +03:00

94 lines
4.1 KiB
XML
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 601f6f4ce5827d441a7e110184708f0abe9fd447 Maintainer: rjhdby Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="sessionhandler.read" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>SessionHandler::read</refname>
<refpurpose>Считывает данные сессии</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis role="SessionHandler">
<modifier>public</modifier> <type class="union"><type>string</type><type>false</type></type><methodname>SessionHandler::read</methodname>
<methodparam><type>string</type><parameter>id</parameter></methodparam>
</methodsynopsis>
<para>
Считывает данные сессии из хранилища и возвращает результат обратно в PHP для
внутренней обработки. Этот метод вызывается автоматически когда PHP стартует сессию
(либо автоматически или напрямую вызовом <function>session_start</function> с
последующим вызовом <function>SessionHandler::open</function>.
</para>
<para>
Этот метод является обёрткой внутреннего обработчика PHP, определённого в
параметре ini-файла <link linkend="ini.session.save-handler">session.save_handler</link>
который устанавливается до того, как будет определён обработчик сессии вызовом <function>session_set_save_handler</function>.
</para>
<para>
Если этот класс расширен путём наследования, вызов родительского метода <parameter>read</parameter>
вызовет обёртку для этого метода и, соответственно, вызов внутреннего обработчика.
Это позволяет методу быть перегруженным, и/или перехваченные и отфильтрованным
(например для расшифровки, значения параметра <parameter>$data</parameter>,
которое возвращает родительский метод <parameter>read</parameter>).
</para>
<para>
Для дополнительной информации смотрите документацию по методу <function>SessionHandlerInterface::read</function>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<variablelist>
<varlistentry>
<term><parameter>id</parameter></term>
<listitem>
<para>
Идентификатор сессии, из которой необходимо считать данные.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Возвращает зашифрованную строку считанных данных. Если ничего не считано, возвращается &false;.
Обратите внимание, что это значение возвращается в PHP для внутренней обработки.
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member>
Директива настройки <link linkend="ini.session.serialize-handler">session.serialize_handler</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
-->