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

97 lines
4.3 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: lex Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="sessionhandler.write" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>SessionHandler::write</refname>
<refpurpose>Записывает данные сессии</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis role="SessionHandler">
<modifier>public</modifier> <type>bool</type><methodname>SessionHandler::write</methodname>
<methodparam><type>string</type><parameter>id</parameter></methodparam>
<methodparam><type>string</type><parameter>data</parameter></methodparam>
</methodsynopsis>
<para>
Записывает данные сессии в хранилище. Обычно вызывается при завершении скрипта, функцией
<function>session_write_close</function> или когда <function>session_register_shutdown</function> терпит неудачу.
PHP вызывает <function>SessionHandler::close</function> сразу же после этого метода.
</para>
<para>
Метод является обёрткой внутреннего обработчика PHP, определённого в параметре ini-файла <link linkend="ini.session.save-handler">session.save_handler</link> который устанавливается до того, как будет определён обработчик сессии вызовом <function>session_set_save_handler</function>.
</para>
<para>
Если этот класс расширен путём наследования, вызов родительского метода <parameter>write</parameter> вызовет обёртку для этого метода и, соответственно, вызов внутреннего обработчика. Это позволяет методу быть перегруженным или перехваченным и отфильтрованным (например, для шифрования значения параметра <parameter>$data</parameter> перед отправкой его в родительский метод <parameter>write</parameter>).
</para>
<para>
Для дополнительной информации смотрите документацию по методу <function>SessionHandlerInterface::write</function>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<variablelist>
<varlistentry>
<term><parameter>id</parameter></term>
<listitem>
<para>
Идентификатор сессии.
</para>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>data</parameter></term>
<listitem>
<para>
Зашифрованные данные сессии. Эти данные являются результатом того, что PHP внутренне шифрует суперглобальную переменную <varname>$_SESSION</varname> в сериализированную
строку и передаёт её в качестве параметра. Обратите внимание, что сессии используют альтернативный метод сериализации.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
&returns.session.storage.retval;
</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
-->