<?xml version="1.0" encoding="utf-8"?>

<!-- $Revision$ -->

<!-- EN-Revision: f5c124befdf7c2791877694a86ead123b179d935 Maintainer: PhilDaiguille Status: ready -->

<!-- Reviewed: yes -->

<refentry xml:id="function.session-id" xmlns="http://docbook.org/ns/docbook">

<refnamediv>

<refname>session_id</refname>

<refpurpose>Lee y/o modifica el identificador de sesión actual</refpurpose>

</refnamediv>

<refsect1 role="description">

&reftitle.description;

<methodsynopsis>

<type class="union"><type>string</type><type>false</type></type><methodname>session_id</methodname>

<methodparam choice="opt"><type class="union"><type>string</type><type>null</type></type><parameter>id</parameter><initializer>&null;</initializer></methodparam>

</methodsynopsis>

<para>

<function>session_id</function> se utiliza para recuperar o definir

el identificador de sesión para la sesión actual.

</para>

<para>

La constante <constant>SID</constant> también puede ser utilizada para

leer el nombre de la sesión actual y el identificador de sesión a proporcionar

en las URL. Véase también <link linkend="ref.session">Gestión de sesión</link>.

</para>

</refsect1>

<refsect1 role="parameters">

&reftitle.parameters;

<para>

<variablelist>

<varlistentry>

<term><parameter>id</parameter></term>

<listitem>

<para>

Si <parameter>id</parameter> es proporcionado y no es &null;, reemplazará el identificador

de sesión actual. <function>session_id</function> debe ser

llamado antes de <function>session_start</function>. Dependiendo del gestor

de sesiones que se utilice, no todos los caracteres serán aceptados

en este valor. Por ejemplo, el gestor de sesiones por defecto,

basado en archivos, solo acepta caracteres dentro del intervalo <literal>[a-zA-Z0-9,-]</literal>!

</para>

<note>

<simpara>

Cuando se utilizan sesiones con cookies, el hecho de especificar un

<parameter>id</parameter> para <function>session_id</function>

hará que una nueva cookie siempre sea enviada al llamar a

<function>session_start</function>, independientemente de si el identificador de sesión

actual es idéntico al que acaba de ser definido.

</simpara>

</note>

</listitem>

</varlistentry>

</variablelist>

</para>

</refsect1>

<refsect1 role="returnvalues">

&reftitle.returnvalues;

<para>

<function>session_id</function> devuelve el identificador de sesión para la sesión

actual o una cadena vacía (<literal>""</literal>) si no hay sesión

actual (ningún identificador de sesión existe).

En caso de error, &false; es devuelto.

</para>

</refsect1>

<refsect1 role="changelog">

&reftitle.changelog;

<informaltable>

<tgroup cols="2">

<thead>

<row>

<entry>&Version;</entry>

<entry>&Description;</entry>

</row>

</thead>

<tbody>

<row>

<entry>8.0.0</entry>

<entry>

<parameter>id</parameter> ahora es nullable.

</entry>

</row>

</tbody>

</tgroup>

</informaltable>

</refsect1>

<refsect1 role="seealso">

&reftitle.seealso;

<para>

<simplelist>

<member><function>session_regenerate_id</function></member>

<member><function>session_start</function></member>

<member><function>session_set_save_handler</function></member>

<member>

<link linkend="ini.session.save-handler">session.save_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

-->