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
| From: | Rafael Martinez | Date: | Fri, 07 Jun 2002 11:20:50 +0000 |
| Subject: | 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 |
||
| Groups: | php.doc | ||
| Request: | Send a blank email to phpdoc+get-969346237@lists.php.net to get a copy of this message | ||
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é</refpurpose> </refnamediv> <refsect1> <title>Descripció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é. Si se proporciona <parameter>nueva_caducidad_cache</parameter>, se reemplazará 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é actual</refpurpose> </refnamediv> <refsect1> <title>Descripció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é actual. Si se especifica <parameter>limitador_del_cache</parameter>, el nombre del limitador de caché actual se cambia al nuevo valor. </para> <para> El limitador de caché controla las cabeceras HTTP de control del caché enviadas al cliente. Estas cabeceras determinan las reglas por las que el contenido de la página puede ser guardado en el caché local del cliente. Cambiando el limitador de caché a <literal>nocache</literal>, por ejemplo, impedirá cualquier tipo de almacenamiento en el caché por parte del cliente. Un valor de <literal>public</literal>, en cambio, permitiría el almacenamiento en el caché. Tambié se puede cambiar a <literal>private</literal>, que es un poco má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ía al cliente en este modo. </para> <note> <para> <literal>private_no_expire</literal> fue añadida en PHP 4.2.0dev. </para> </note> <para> Al comenzar la ejecución del script, el limitador de caché 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ó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é a 'private' session_cache_limiter('private'); $cache_limiter = session_cache_limiter(); echo "El limitador de caché está 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ó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ón actual. Si se especifica un <parameter>id</parameter>, reemplazará el session id actual. </para> <para> También se puede utilizar la constante <systemitem>SID</systemitem> para recuperar el nombre y el session id de la sesión actual como una cadena adecuada para añ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á registrada en la sesión </refpurpose> </refnamediv> <refsect1> <title>Descripció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ó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á 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ón actual</refpurpose> </refnamediv> <refsect1> <title>Descripció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ón. Si se especifica <parameter>path</parameter>, se cambiará 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ñ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ón a nivel de usuario </refpurpose> </refnamediv> <refsect1> <title>Descripció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ón de los datos asociados a una sesión. Es lo más útil cuando se prefiere utilizar otro método de almacenamiento distinto del proporcionaddo por las sesiones de PHP. p.ej. Almacenar los datos de la sesión en una base de datos local. &return.success; </para> <note> <para> Debe cambiar la opción <parameter>session.save_handler</parameter> en la configuració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á 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á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ón de lectura debe devolver siempre una cadena para que el manejador de escritura funcione como se espera. Devuelva una cadena vacía si no hay ningún dato a leer. Los valores devueltos de otros manejadores son convertidos a una expresión booleana. TRUE si todo ha ido correctamente, FALSE si ha habido algú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í. } } 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ÓN - Necesitará implementar algún * * tipo de rutinas recolectoras de basura aquí * ***********************************************/ 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ón actual </refpurpose> </refnamediv> <refsect1> <title>Descripció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ón actual. </para> <para> Esta función devuelve &true; cuando la variable es eliminada de la sesió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ón actual. </para> </note> <caution> <para> Esta función no borra la variable global correspondiente a <parameter>nombre</parameter>, sólo evita que la variable sea guardada como parte de la sesión. Debe llamar a <function>unset</function> para eliminar la variable global correspondiente. </para> </caution> <caution> <para> Si está 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ón </refpurpose> </refnamediv> <refsect1> <title>Descripción</title> <methodsynopsis> <type>void</type><methodname>session_unset</methodname> <void/> </methodsynopsis> <para> La función <function>session_unset</function> elimina y libera el espacio ocupado por todas las variables de la sesió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ó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 -->
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é</refpurpose> </refnamediv> <refsect1> <title>Descripció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é. Si se proporciona <parameter>nueva_caducidad_cache</parameter>, se reemplazará 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é actual</refpurpose> </refnamediv> <refsect1> <title>Descripció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é actual. Si se especifica <parameter>limitador_del_cache</parameter>, el nombre del limitador de caché actual se cambia al nuevo valor. </para> <para> El limitador de caché controla las cabeceras HTTP de control del caché enviadas al cliente. Estas cabeceras determinan las reglas por las que el contenido de la página puede ser guardado en el caché local del cliente. Cambiando el limitador de caché a <literal>nocache</literal>, por ejemplo, impedirá cualquier tipo de almacenamiento en el caché por parte del cliente. Un valor de <literal>public</literal>, en cambio, permitiría el almacenamiento en el caché. Tambié se puede cambiar a <literal>private</literal>, que es un poco má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ía al cliente en este modo. </para> <note> <para> <literal>private_no_expire</literal> fue añadida en PHP 4.2.0dev. </para> </note> <para> Al comenzar la ejecución del script, el limitador de caché 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ó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é a 'private' session_cache_limiter('private'); $cache_limiter = session_cache_limiter(); echo "El limitador de caché está 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ó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ón actual. Si se especifica un <parameter>id</parameter>, reemplazará el session id actual. </para> <para> También se puede utilizar la constante <systemitem>SID</systemitem> para recuperar el nombre y el session id de la sesión actual como una cadena adecuada para añ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á registrada en la sesión </refpurpose> </refnamediv> <refsect1> <title>Descripció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ó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á 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ón actual</refpurpose> </refnamediv> <refsect1> <title>Descripció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ón. Si se especifica <parameter>path</parameter>, se cambiará 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ñ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ón a nivel de usuario </refpurpose> </refnamediv> <refsect1> <title>Descripció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ón de los datos asociados a una sesión. Es lo más útil cuando se prefiere utilizar otro método de almacenamiento distinto del proporcionaddo por las sesiones de PHP. p.ej. Almacenar los datos de la sesión en una base de datos local. &return.success; </para> <note> <para> Debe cambiar la opción <parameter>session.save_handler</parameter> en la configuració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á 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á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ón de lectura debe devolver siempre una cadena para que el manejador de escritura funcione como se espera. Devuelva una cadena vacía si no hay ningún dato a leer. Los valores devueltos de otros manejadores son convertidos a una expresión booleana. TRUE si todo ha ido correctamente, FALSE si ha habido algú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í. } } 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ÓN - Necesitará implementar algún * * tipo de rutinas recolectoras de basura aquí * ***********************************************/ 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ón actual </refpurpose> </refnamediv> <refsect1> <title>Descripció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ón actual. </para> <para> Esta función devuelve &true; cuando la variable es eliminada de la sesió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ón actual. </para> </note> <caution> <para> Esta función no borra la variable global correspondiente a <parameter>nombre</parameter>, sólo evita que la variable sea guardada como parte de la sesión. Debe llamar a <function>unset</function> para eliminar la variable global correspondiente. </para> </caution> <caution> <para> Si está 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ón </refpurpose> </refnamediv> <refsect1> <title>Descripción</title> <methodsynopsis> <type>void</type><methodname>session_unset</methodname> <void/> </methodsynopsis> <para> La función <function>session_unset</function> elimina y libera el espacio ocupado por todas las variables de la sesió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ó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 -->