[PHP-DOC] cvs: phpdoc-es /reference/session/functions session-cache-expire.xml session-cache-limiter.xml session-id.xml session-is-registered.xml session-save-path.xml session-set-save-handler.xml session-unregister.xml session-unset.xml

[Rafael Martinez]

rafael          Fri Jun  7 07:20:50 2002 EDT

  Added files:                 
    /phpdoc-es/reference/session/functions      session-cache-expire.xml 
                                                session-cache-limiter.xml 
                                                session-id.xml 
                                                session-is-registered.xml 
                                                session-save-path.xml 
                                                session-set-save-handler.xml 
                                                session-unregister.xml 
                                                session-unset.xml 
  Log:
  Translation updated to PHP 4.x
  
  


Index: phpdoc-es/reference/session/functions/session-cache-expire.xml
+++ phpdoc-es/reference/session/functions/session-cache-expire.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<!-- EN-Revision: 1.2 Maintainer: victorf Status: ready -->
  <refentry id='function.session-cache-expire'>
   <refnamediv>
    <refname>session_cache_expire</refname>
    <refpurpose>Devuelve la caducidad actual del cach&eacute;</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripci&oacute;n</title>
     <methodsynopsis>
      <type>int</type><methodname>session_cache_expire</methodname>
      <methodparam 
choice="opt"><type>int</type><parameter>nueva_caducidad_cache</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>session_cache_expire</function> devuelve la caducidad actual
         del cach&eacute;. Si se proporciona
         <parameter>nueva_caducidad_cache</parameter>, se reemplazar&aacute;
         la caducidad actual con <parameter>nueva_caducidad_cache</parameter>.
    </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:"../../../../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
-->

Index: phpdoc-es/reference/session/functions/session-cache-limiter.xml
+++ phpdoc-es/reference/session/functions/session-cache-limiter.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<!-- EN-Revision: 1.2 Maintainer: victorf Status: ready -->
  <refentry id="function.session-cache-limiter">
   <refnamediv>
    <refname>session_cache_limiter</refname>
    <refpurpose>Lee y/o cambia el limitador del cach&eacute; actual</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripci&oacute;n</title>
     <methodsynopsis>
      <type>string</type><methodname>session_cache_limiter</methodname>
      <methodparam 
choice="opt"><type>string</type><parameter>limitador_del_cache</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>session_cache_limiter</function> devuelve el nombre del
         limitador de cach&eacute; actual. Si se especifica
     <parameter>limitador_del_cache</parameter>, el nombre del limitador
         de cach&eacute; actual se cambia al nuevo valor.
    </para>
    <para>
     El limitador de cach&eacute; controla las cabeceras HTTP de control del
         cach&eacute; enviadas al cliente. Estas cabeceras determinan las reglas
         por las que el contenido de la p&aacute;gina puede ser guardado en el
         cach&eacute; local del cliente. Cambiando el limitador de cach&eacute;
         a <literal>nocache</literal>, por ejemplo, impedir&aacute; cualquier
         tipo de almacenamiento en el cach&eacute; por parte del cliente. Un valor
         de <literal>public</literal>, en cambio, permitir&iacute;a el almacenamiento
         en el cach&eacute;. Tambi&eacute; se puede cambiar a
         <literal>private</literal>, que es un poco m&aacute;s restrictivo que
         el <literal>public</literal>.
    </para>
    <para>
     En el modo <literal>private</literal>, la cabecera Expire (caducidad)
         enviada al cliente puede confundir a algunos navegadores incluyendo
         Mozilla. Puede evitar este problema con el modo
     <literal>private_no_expire</literal>. La cabecera Expire nunca se
     env&iacute;a al cliente en este modo.
    </para>
    <note>
     <para>
      <literal>private_no_expire</literal> fue a&ntilde;adida en PHP 4.2.0dev.
     </para>
    </note>
    <para>
     Al comenzar la ejecuci&oacute;n del script, el limitador de cach&eacute;
         se reestablece al valor por defecto guardado en
     <literal>session.cache_limiter</literal>. De este modo, es necesario
     llamar a <function>session_cache_limiter</function> en cada petici&oacute;n
     (y antes de llamar a <function>session_start</function>).
    </para>
    <example>
     <title>Ejemplos con <function>session_cache_limiter</function></title>
     <programlisting role="php">
<![CDATA[
<?php

# cambia el limitador del cach&eacute; a 'private'

session_cache_limiter('private');
$cache_limiter = session_cache_limiter();

echo "El limitador de cach&eacute; est&aacute; puesto ahora en $cache_limiter<p>";
?>
]]>
     </programlisting>
    </example>
   </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:"../../../../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
-->

Index: phpdoc-es/reference/session/functions/session-id.xml
+++ phpdoc-es/reference/session/functions/session-id.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<!-- EN-Revision: 1.3 Maintainer: victorf Status: ready -->
  <refentry id="function.session-id">
   <refnamediv>
    <refname>session_id</refname>
    <refpurpose>Lee y/o cambia el session id actual</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripci&oacute;n</title>
     <methodsynopsis>
      <type>string</type><methodname>session_id</methodname>
      <methodparam 
choice="opt"><type>string</type><parameter>id</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>session_id</function> devuelve el session id de la
     sesi&oacute;n actual. Si se especifica un <parameter>id</parameter>,
     reemplazar&aacute; el session id actual.
    </para>
    <para>
     Tambi&eacute;n se puede utilizar la constante
         <systemitem>SID</systemitem> para recuperar el nombre y el
         session id de la sesi&oacute;n actual como una cadena adecuada
         para a&ntilde;adir a las URLs.
    </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:"../../../../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
-->

Index: phpdoc-es/reference/session/functions/session-is-registered.xml
+++ phpdoc-es/reference/session/functions/session-is-registered.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<!-- EN-Revision: 1.2 Maintainer: victorf Status: ready -->
  <refentry id="function.session-is-registered">
   <refnamediv>
    <refname>session_is_registered</refname>
    <refpurpose>
     Comprueba si una variable est&aacute; registrada en la sesi&oacute;n
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripci&oacute;n</title>
     <methodsynopsis>
      <type>bool</type><methodname>session_is_registered</methodname>
      <methodparam><type>string</type><parameter>nombre</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>session_is_registered</function> devuelve &true; si hay
         una variable registrada en la sesi&oacute;n actual cuyo nombre es
         <parameter>nombre</parameter>.
    </para>
    <note>
     <para>
      Si utiliza <varname>$_SESSION</varname> (o
      <varname>$HTTP_SESSION_VARS</varname> con PHP 4.0.6 o inferior),
      use <function>isset</function> para comprobar si una variable
          est&aacute; registrada en <varname>$_SESSION</varname>.
     </para>
    </note>
    <caution>
     <para>
      Si utiliza
      <varname>$HTTP_SESSION_VARS</varname>/<varname>$_SESSION</varname>,
      no use <function>session_register</function>,
      <function>session_is_registered</function> ni
      <function>session_unregister</function>.
     </para>
    </caution>
   </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:"../../../../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
-->

Index: phpdoc-es/reference/session/functions/session-save-path.xml
+++ phpdoc-es/reference/session/functions/session-save-path.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<!-- EN-Revision: 1.2 Maintainer: victorf Status: ready -->
  <refentry id="function.session-save-path">
   <refnamediv>
    <refname>session_save_path</refname>
    <refpurpose>Lee y/o cambia la ruta donde se guardan los datos de la sesi&oacute;n 
actual</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripci&oacute;n</title>
     <methodsynopsis>
      <type>string</type><methodname>session_save_path</methodname>
      <methodparam 
choice="opt"><type>string</type><parameter>path</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>session_save_path</function> devuelve la ruta del directorio
         usado actualmente para guardar los datos de la sesi&oacute;n. Si se
     especifica <parameter>path</parameter>, se cambiar&aacute; la ruta
         donde se guardan los datos.
     <note>
      <para>
       En algunos sistemas operativos, puede que quiera especificar una
           ruta en un sistema de ficheros que maneja muchos ficheros
           peque&ntilde;os de forma eficiente. Por ejemplo, en Linux,
           reiserfs puede dar un rendimiento mejor que ext2fs.
      </para>
     </note>
    </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:"../../../../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
-->

Index: phpdoc-es/reference/session/functions/session-set-save-handler.xml
+++ phpdoc-es/reference/session/functions/session-set-save-handler.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<!-- EN-Revision: 1.3 Maintainer: victorf Status: ready -->
  <refentry id="function.session-set-save-handler">
   <refnamediv>
    <refname>session_set_save_handler</refname>
    <refpurpose>
     Establece unas funciones para el almacenamiento de los datos de la sesi&oacute;n 
a nivel de usuario
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripci&oacute;n</title>
     <methodsynopsis>
      <type>bool</type><methodname>session_set_save_handler</methodname>
      
<methodparam><type>string</type><parameter>abrir</parameter></methodparam><methodparam><type>string</type><parameter>cerrar</parameter></methodparam><methodparam><type>string</type><parameter>leer</parameter></methodparam><methodparam><type>string</type><parameter>escribir</parameter></methodparam><methodparam><type>string</type><parameter>destruir</parameter></methodparam><methodparam><type>string</type><parameter>gc</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>session_set_save_handler</function> establece las
         funciones que se utilizan a nivel de usuario para el
         almacenamiento y recuperaci&oacute;n de los datos asociados a
         una sesi&oacute;n. Es lo m&aacute;s &uacute;til cuando se
         prefiere utilizar otro m&eacute;todo de almacenamiento distinto
         del proporcionaddo por las sesiones de PHP. p.ej. Almacenar
         los datos de la sesi&oacute;n en una base de datos local.
     &return.success;
    </para>
    <note>
     <para>
      Debe cambiar la opci&oacute;n
      <parameter>session.save_handler</parameter> en la
          configuraci&oacute;n a <parameter>user</parameter> en su
          archivo &php.ini; para que
          <function>session_set_save_handler</function> tenga efecto.
     </para>
    </note>
    <note>
     <para>
      El manejador "escribir" no se ejecuta hasta que se cierra la
          salida. Por ello, la salida de las sentencias que coloquemos
          en el manejador "escribir" para el depurado nunca ser&aacute;
          enviadas al navegador. Si se necesita producir una salida para
          el depurado, se sugiere que la salida se produzca en un archivo.
     </para>
    </note>
    <para>
     El siguiente ejemplo proporciona almacenamiento de las sesiones
         basado en archivos de forma similar al manejador de sesiones
         por defecto de PHP <parameter>files</parameter>. Este ejemplo
         puede ser extendido f&aacute;cilmente para cubrir el almacenamiento
         en bases de datos usando su motor de soporte de bases de datos
         de PHP favorito.
    </para>
    <para>
     La funci&oacute;n de lectura debe devolver siempre una cadena
         para que el manejador de escritura funcione como se espera.
     Devuelva una cadena vac&iacute;a si no hay ning&uacute;n dato
         a leer. Los valores devueltos de otros manejadores son
         convertidos a una expresi&oacute;n booleana. TRUE si todo ha
         ido correctamente, FALSE si ha habido alg&uacute;n problema.
    </para>
    <para>
     <example>
      <title>
       Ejemplo de <function>session_set_save_handler</function>
      </title>
      <programlisting role="php">
<![CDATA[
<?php
function abrir ($save_path, $session_name) {
  global $sess_save_path, $sess_session_name;
       
  $sess_save_path = $save_path;
  $sess_session_name = $session_name;
  return(true);
}

function cerrar() {
  return(true);
}

function leer ($id) {
  global $sess_save_path, $sess_session_name;

  $sess_file = "$sess_save_path/sess_$id";
  if ($fp = @fopen($sess_file, "r")) {
    $sess_data = fread($fp, filesize($sess_file));
    return($sess_data);
  } else {
    return(""); // Debe devolver "" aqu&iacute;.
  }

}

function escribir ($id, $sess_data) {
  global $sess_save_path, $sess_session_name;

  $sess_file = "$sess_save_path/sess_$id";
  if ($fp = @fopen($sess_file, "w")) {
    return(fwrite($fp, $sess_data));
  } else {
    return(false);
  }

}

function destruir ($id) {
  global $sess_save_path, $sess_session_name;
       
  $sess_file = "$sess_save_path/sess_$id";
  return(@unlink($sess_file));
}

/***********************************************
 * ATENCI&Oacute;N - Necesitar&aacute; implementar alg&uacute;n     *
 * tipo de rutinas recolectoras de basura aqu&iacute; *
 ***********************************************/
function rb ($maxlifetime) {
  return true;
}

session_set_save_handler ("abrir", "cerrar", "leer", "escribir", "destruir", "rb");

session_start();

// proceed to use sessions normally

?>
]]>
      </programlisting>
     </example>
    </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:"../../../../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
-->

Index: phpdoc-es/reference/session/functions/session-unregister.xml
+++ phpdoc-es/reference/session/functions/session-unregister.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<!-- EN-Revision: 1.2 Maintainer: victorf Status: ready -->
  <refentry id="function.session-unregister">
   <refnamediv>
    <refname>session_unregister</refname>
    <refpurpose>
     Desregistrar una variable de la sesi&oacute;n actual
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripci&oacute;n</title>
     <methodsynopsis>
      <type>bool</type><methodname>session_unregister</methodname>
      <methodparam><type>string</type><parameter>nombre</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>session_unregister</function> desregistra (olvida)
     la variable global llamada <parameter>nombre</parameter> de la
     sesi&oacute;n actual.
    </para>
    <para>
     Esta funci&oacute;n devuelve &true; cuando la variable es
     eliminada de la sesi&oacute;n correctamente.
    </para>
    <note>
     <para>
      Si utiliza <varname>$_SESSION</varname> (o
      <varname>$HTTP_SESSION_VARS</varname> con PHP 4.0.6 o inferior),
      use <function>unset</function> para eliminar una variable de
      la sesi&oacute;n actual.
     </para>
    </note>
    <caution>
     <para>
      Esta funci&oacute;n no borra la variable global correspondiente a
      <parameter>nombre</parameter>, s&oacute;lo evita que la variable sea
      guardada como parte de la sesi&oacute;n. Debe llamar a
          <function>unset</function> para eliminar la variable global
          correspondiente.
     </para>
    </caution>
    <caution>
     <para>
      Si est&aacute; trabajando con
      <varname>$HTTP_SESSION_VARS</varname>/<varname>$_SESSION</varname>,
      no utilice <function>session_register</function>,
      <function>session_is_registered</function> ni
      <function>session_unregister</function>.
     </para>
    </caution>
   </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:"../../../../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
-->

Index: phpdoc-es/reference/session/functions/session-unset.xml
+++ phpdoc-es/reference/session/functions/session-unset.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<!-- EN-Revision: 1.3 Maintainer: victorf Status: ready -->
  <refentry id="function.session-unset">
   <refnamediv>
    <refname>session_unset</refname>
    <refpurpose>
     Elimina todas las variables de la sesi&oacute;n
    </refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripci&oacute;n</title>
     <methodsynopsis>
      <type>void</type><methodname>session_unset</methodname>
      <void/>
     </methodsynopsis>
    <para>
     La funci&oacute;n <function>session_unset</function> elimina y
         libera el espacio ocupado por todas las variables de la sesi&oacute;n
         actual registradas.
    </para>
    <note>
     <para>
      Si utiliza <varname>$_SESSION</varname> (o
      <varname>$HTTP_SESSION_VARS</varname> con PHP 4.0.6 o inferior),
      use <function>unset</function> en su lugar para desregistrar
      una variable de la sesi&oacute;n. p.ej. $_SESSION = array();
     </para>
    </note>
   </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:"../../../../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
-->