session-create-id.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: f5c124befdf7c2791877694a86ead123b179d935 Maintainer: PhilDaiguille Status: ready -->
<!-- Reviewed: no -->
<refentry xml:id="function.session-create-id" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>session_create_id</refname>
  <refpurpose>Crear un nuevo ID de sesión</refpurpose>
 </refnamediv>
 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type class="union"><type>string</type><type>false</type></type><methodname>session_create_id</methodname>
   <methodparam choice="opt"><type>string</type><parameter>prefix</parameter><initializer>""</initializer></methodparam>
  </methodsynopsis>
  <para>
   <function>session_create_id</function> se utiliza para crear un nuevo
   ID de sesión para la sesión actual. Esto devuelve un ID de
   sesión sin colisión.
  </para>
  <para>
   Si la sesión no está activa, la verificación de colisión se omite.
  </para>
  <para>
   El ID de sesión se crea de acuerdo con los parámetros php.ini.
  </para>
  <para>
   Es importante utilizar el mismo ID de usuario de su servidor web
   para el script de la tarea de Recogida de Basura (Garbage Collection).
   De lo contrario, se pueden tener problemas de permisos, especialmente
   con los gestores de guardado de ficheros.
  </para>
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>prefix</parameter></term>
      <listitem>
       <para>
        Si <parameter>prefix</parameter> está especificado, el nuevo ID de sesión
        se prefiere con <parameter>prefix</parameter>. No todos
        los caracteres están permitidos en el ID de sesión. Los caracteres
        entre <literal>[a-z A-Z 0-9]</literal> están permitidos. La longitud máxima es de 256 caracteres.
       </para>
      </listitem>
     </varlistentry>
   </variablelist>
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   <function>session_create_id</function> devuelve un nuevo ID de sesión
   sin colisión para la sesión actual. Si se utiliza sin una sesión
   activa, la verificación de colisión se omite.
   En caso de error, &false; se devuelve.
  </para>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   <example>
    <title>Ejemplo de <function>session_create_id</function> con <function>session_regenerate_id</function></title>
    <programlisting role="php">
<![CDATA[
<?php
// Mi función de inicio de sesión soporta la gestión de marcas de tiempo
function my_session_start() {
    session_start();
    // No permite el uso de antiguos ID de sesión
    if (!empty($_SESSION['deleted_time']) && $_SESSION['deleted_time'] < time() - 180) {
        session_destroy();
        session_start();
    }
}

// Mi función de regeneración de ID
function my_session_regenerate_id() {
    // Llamada a session_create_id() cuando la sesión está activa
    // para asegurarse de que no hay colisión.
    if (session_status() != PHP_SESSION_ACTIVE) {
        session_start();
    }
    // ADVERTENCIA: Nunca utilizar cadenas confidenciales como prefijo
    $newid = session_create_id('myprefix-');
    // Establece la marca de tiempo de eliminación.
    // Los datos de sesión no deben eliminarse inmediatamente por ciertas razones.
    $_SESSION['deleted_time'] = time();
    // Termina la sesión
    session_commit();
    // Asegúrese de aceptar los ID de sesión definidos por el usuario
    // NOTA: Debe activar use_strict_mode para operaciones normales.
    ini_set('session.use_strict_mode', 0);
    // Definir un nuevo ID de sesión personalizado
    session_id($newid);
    // Inicio con un ID de sesión personalizado
    session_start();
}

// Asegúrese de que use_strict_mode esté activado.
// use_strict_mode es obligatorio por razones de seguridad.
ini_set('session.use_strict_mode', 1);
my_session_start();

// El ID de sesión debe regenerarse cuando
//  - Un usuario se conecta
//  - Un usuario se desconecta
//  - Ha transcurrido un cierto período de tiempo
my_session_regenerate_id();

// Lógica de aplicación
?>
]]>
    </programlisting>
   </example>
  </para>
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>session_regenerate_id</function></member>
    <member><function>session_start</function></member>
    <member><link linkend="ini.session.use-strict-mode">session.use_strict_mode</link></member>
    <member><methodname>SessionHandler::create_sid</methodname></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
-->