1
0
mirror of https://github.com/php/doc-es.git synced 2026-03-24 15:32:36 +01:00
Files
2024-11-08 09:48:03 +00:00

93 lines
3.3 KiB
XML

<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 601f6f4ce5827d441a7e110184708f0abe9fd447 Maintainer: seros Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="sessionhandlerinterface.read" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
<refname>SessionHandlerInterface::read</refname>
<refpurpose>Leer información de sesión</refpurpose>
</refnamediv>
<refsect1 role="description">
&reftitle.description;
<methodsynopsis role="SessionHandlerInterface">
<modifier>public</modifier> <type class="union"><type>string</type><type>false</type></type><methodname>SessionHandlerInterface::read</methodname>
<methodparam><type>string</type><parameter>id</parameter></methodparam>
</methodsynopsis>
<para>
Lee la información de sesión desde el almacenamiento de sesiones, y devuelve el resultado.
Llamado justo después de iniciarse una sesión o cuando es llamada <function>session_start</function>.
Observe que antes de que este método sea llamado <function>SessionHandlerInterface::open</function> es invocado.
</para>
<para>
Este método es llmado por PHP cuando la sesión es iniciada.
Este método debería recuperar la información de sesión desde el almacenamiento mediante el
ID de sesión proporcionado. La cadena devuelta por este método debe estar en el mismo
formato serializado que el orgibal pasado a <function>SessionHandlerInterface::write</function>
Si no se encuentra el registro, devuelve &false;.
</para>
<para>
La información devuelta por este método será decodificada internamente por PHP usando el
método de deserialización especificado en <link linkend="ini.session.serialize-handler">session.serialize_handler</link>.
La información resultante será usada para rellenar la variable superglobal <varname>$_SESSION</varname>.
</para>
<para>
Observe que el esquema de serialización no es el mismo que <function>unserialize</function>
y pudede accederse a él mediante <function>session_decode</function>.
</para>
</refsect1>
<refsect1 role="parameters">
&reftitle.parameters;
<variablelist>
<varlistentry>
<term><parameter>id</parameter></term>
<listitem>
<para>
El ID de sesión.
</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 role="returnvalues">
&reftitle.returnvalues;
<para>
Devuelve una cadena codificada de la información leída. Si no se leyó nada, debe devolver &false;. Observe que este valor es devuelto internamente por PHP para procesamiento.
</para>
</refsect1>
<refsect1 role="seealso">
&reftitle.seealso;
<para>
<simplelist>
<member>
La directiva de configuración
<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
-->