[PHP-DOC] cvs: phpdoc-es /reference/session/functions session-name.xml session-readonly.xml session-write-close.xml

[Rafael Martinez]

rafael          Wed Jun  5 15:36:50 2002 EDT

  Added files:                 
    /phpdoc-es/reference/session/functions      session-name.xml 
                                                session-readonly.xml 
                                                session-write-close.xml 
  Log:
  Translation updated to PHP 4.x
  
  

Index: phpdoc-es/reference/session/functions/session-name.xml
+++ phpdoc-es/reference/session/functions/session-name.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<!-- EN-Revision: 1.2 Maintainer: victorf Status: ready -->
  <refentry id="function.session-name">
   <refnamediv>
    <refname>session_name</refname>
    <refpurpose>Lee y/o cambia el nombre de la sesi&oacute;n actual</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripci&oacute;n</title>
     <methodsynopsis>
      <type>string</type><methodname>session_name</methodname>
      <methodparam 
choice="opt"><type>string</type><parameter>nombre</parameter></methodparam>
     </methodsynopsis>
    <para>
     <function>session_name</function> devuelve el nombre de la sesi&oacute;n
         actual. Si se especifica un <parameter>nombre</parameter>, el nombre de
     de la sesi&oacute;n actual se cambia a este valor.
    </para>
    <para>
     El nombre de la sesi&oacute;n hace referencia al session id
         utilizado en las cookies y en las URLs. Deber&iacute;a contener
         &uacute;nicamente caracteres alfanum&eacute;ricos; tambi&eacute;n
         deber&iacute;a ser corto y descriptivo (p.ej. para usuarios con
         los avisos de las cookies activados). El nombre de la sesi&oacute;n
         se restaura al valor guardado por defecto en
         <literal>session.name</literal> al comenzar la petici&oacute;n.
     As&iacute;, pues, es necesario llamar a
         <function>session_name</function> en cada petici&oacute;n (y
         antes de llamar a <function>session_start</function>
     o a <function>session_register</function>).
    </para>
    <example>
     <title>Ejemplos de <function>session_name</function></title>
     <programlisting role="php">
<![CDATA[
<?php

// Cambiar el nombre de la sesi&oacute;n a WebsiteID

$nombre_anterior = session_name("WebsiteID");

echo "El anterior nombre de la sesi&oacute;n era $nombre_anterior<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-readonly.xml
+++ phpdoc-es/reference/session/functions/session-readonly.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<!-- EN-Revision: 1.2 Maintainer: victorf Status: ready -->
  <refentry id="function.session-readonly">
   <refnamediv>
    <refname>session_readonly</refname>
    <refpurpose>Inicia una sesi&oacute;n - reinicializa las variables, pero sin 
guardar los cambios al terminar</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripci&oacute;n</title>
     <methodsynopsis>
      <type>void</type><methodname>session_readonly</methodname>
      <void/>
     </methodsynopsis>
    <para>
     Lee los datos de una sesi&oacute;n sin bloquearlos. No es posible cambiar
     los datos de la sesi&oacute;n, pero el rendimiento de los framesets
         mejorar&aacute;.
    </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-write-close.xml
+++ phpdoc-es/reference/session/functions/session-write-close.xml
<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.1 $ -->
<!-- EN-Revision: 1.2 Maintainer: victorf Status: ready -->
  <refentry id="function.session-write-close">
   <refnamediv>
    <refname>session_write_close</refname>
    <refpurpose>Escribe los datos de la sesi&oacute;n y la finaliza</refpurpose>
   </refnamediv>
   <refsect1>
    <title>Descripci&oacute;n</title>
     <methodsynopsis>
      <type>void</type><methodname>session_write_close</methodname>
      <void/>
     </methodsynopsis>
    <para>
     Finaliza la sesi&oacute;n actual y guarda sus datos
    </para>
    <para>
     Los datos de la sesi&oacute; se suelen guardar tras finalizar la
         ejecuci&oacute;n de su script sin necesidad de llamar a
     <function>session_write_close</function>, pero como los datos
     de la sesi&oacute; est&aacute;n bloqueados para evitar escrituras
         concurrentes, s&oacute;lo un script puede trabajar con una sesi&oacute;n
         a la vez. Cuando se usan framesets junto con sesiones, podr&aacute;
         comprobar que los frames se cargan uno a uno debido a este bloqueo.
         Puede reducir el tiempo necesario para cargar los frames finalizando
         la sesi&oacute;n tan pronto como haya terminado los cambios a las
         variables de la sesi&oacute;n.
    </para>
<!-- commented out until final decision on implementation
    <para>
     See also: <function>session_readonly</function>.
    </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
-->