<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/ref.session.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'es',
  ),
  'this' => 
  array (
    0 => 'function.session-id.php',
    1 => 'session_id',
    2 => 'Lee y/o modifica el identificador de sesi&oacute;n actual',
  ),
  'up' => 
  array (
    0 => 'ref.session.php',
    1 => 'Funciones de sesi&oacute;n',
  ),
  'prev' => 
  array (
    0 => 'function.session-get-cookie-params.php',
    1 => 'session_get_cookie_params',
  ),
  'next' => 
  array (
    0 => 'function.session-module-name.php',
    1 => 'session_module_name',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'es',
    'path' => 'reference/session/functions/session-id.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="function.session-id" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">session_id</h1>
  <p class="verinfo">(PHP 4, PHP 5, PHP 7, PHP 8)</p><p class="refpurpose"><span class="refname">session_id</span> &mdash; <span class="dc-title">Lee y/o modifica el identificador de sesión actual</span></p>

 </div>

 <div class="refsect1 description" id="refsect1-function.session-id-description">
  <h3 class="title">Descripción</h3>
  <div class="methodsynopsis dc-description">
   <span class="methodname"><strong>session_id</strong></span>(<span class="methodparam"><span class="type"><span class="type"><a href="language.types.null.php" class="type null">?</a></span><span class="type"><a href="language.types.string.php" class="type string">string</a></span></span> <code class="parameter">$id</code><span class="initializer"> = <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong></span></span>): <span class="type"><span class="type"><a href="language.types.string.php" class="type string">string</a></span>|<span class="type"><a href="language.types.singleton.php" class="type false">false</a></span></span></div>

  <p class="para rdfs-comment">
   <span class="function"><strong>session_id()</strong></span> se utiliza para recuperar o definir
   el identificador de sesión para la sesión actual.
  </p>
  <p class="para">
   La constante <strong><code><a href="session.constants.php#constant.sid">SID</a></code></strong> 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 <a href="ref.session.php" class="link">Gestión de sesión</a>.
  </p>
 </div>


 <div class="refsect1 parameters" id="refsect1-function.session-id-parameters">
  <h3 class="title">Parámetros</h3>
  <p class="para">
   <dl>
    
     <dt><code class="parameter">id</code></dt>
      <dd>
       <p class="para">
        Si <code class="parameter">id</code> es proporcionado y no es <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong>, reemplazará el identificador
        de sesión actual. <span class="function"><strong>session_id()</strong></span> debe ser
        llamado antes de <span class="function"><a href="function.session-start.php" class="function">session_start()</a></span>. 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 <code class="literal">[a-zA-Z0-9,-]</code>!
       </p>
       <blockquote class="note"><p><strong class="note">Nota</strong>: 
        <span class="simpara">
         Cuando se utilizan sesiones con cookies, el hecho de especificar un
         <code class="parameter">id</code> para <span class="function"><strong>session_id()</strong></span>
         hará que una nueva cookie siempre sea enviada al llamar a
         <span class="function"><a href="function.session-start.php" class="function">session_start()</a></span>, independientemente de si el identificador de sesión
         actual es idéntico al que acaba de ser definido.
        </span>
       </p></blockquote>
      </dd>
     
   </dl>
  </p>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-function.session-id-returnvalues">
  <h3 class="title">Valores devueltos</h3>
  <p class="para">
   <span class="function"><strong>session_id()</strong></span> devuelve el identificador de sesión para la sesión
   actual o una cadena vacía (<code class="literal">&quot;&quot;</code>) si no hay sesión
   actual (ningún identificador de sesión existe).
   En caso de error, <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong> es devuelto.
  </p>
 </div>


 <div class="refsect1 changelog" id="refsect1-function.session-id-changelog">
  <h3 class="title">Historial de cambios</h3>
  <table class="doctable informaltable">
   
    <thead>
     <tr>
      <th>Versión</th>
      <th>Descripción</th>
     </tr>

    </thead>

    <tbody class="tbody">
     <tr>
      <td>8.0.0</td>
      <td>
       <code class="parameter">id</code> ahora es nullable.
      </td>
     </tr>

    </tbody>
   
  </table>

 </div>


 <div class="refsect1 seealso" id="refsect1-function.session-id-seealso">
  <h3 class="title">Ver también</h3>
  <p class="para">
   <ul class="simplelist">
    <li><span class="function"><a href="function.session-regenerate-id.php" class="function" rel="rdfs-seeAlso">session_regenerate_id()</a> - Reemplaza el identificador de sesi&oacute;n actual por uno nuevo</span></li>
    <li><span class="function"><a href="function.session-start.php" class="function" rel="rdfs-seeAlso">session_start()</a> - Inicia una nueva sesi&oacute;n o reanuda una sesi&oacute;n existente</span></li>
    <li><span class="function"><a href="function.session-set-save-handler.php" class="function" rel="rdfs-seeAlso">session_set_save_handler()</a> - Configura las funciones de almacenamiento de sesiones</span></li>
    <li>
     <a href="session.configuration.php#ini.session.save-handler" class="link">session.save_handler</a>
    </li>
   </ul>
  </p>
 </div>

</div><?php manual_footer($setup); ?>