[PHP-DOC] cvs: phpdoc /fr/functions session.xml

[Damien Seguy]

dams            Mon Oct 22 22:52:40 2001 EDT

  Modified files:              
    /phpdoc/fr/functions        session.xml 
  Log:
  Updating doc to be synch with test.
  Including session-end and session read only.
  
Index: phpdoc/fr/functions/session.xml
diff -u phpdoc/fr/functions/session.xml:1.13 phpdoc/fr/functions/session.xml:1.14
--- phpdoc/fr/functions/session.xml:1.13        Thu Jul 12 08:17:02 2001
+++ phpdoc/fr/functions/session.xml     Mon Oct 22 22:52:40 2001
@@ -1,3 +1,5 @@
+<?xml encoding="iso-8859-1"?>
+<!-- $Revision: 1.14 $ -->
  <reference id="ref.session">
   <title>Sessions</title>
   <titleabbrev>Sessions</titleabbrev>
@@ -170,7 +172,7 @@
      <para>
      Les URL absolues sont consid&eacute;r&eacute;es comme des sites externes,
      et PHP ne leur attribuera pas le SID, qui pourrait repr&eacute;senter
-     un risque de trou de s&eacute;curit&eacute;.
+     un trou de s&eacute;curit&eacute;.
      </para>
     </note>
    </para>
@@ -261,14 +263,13 @@
      </listitem>
      <listitem>
     <simpara>
-     <literal>session.referer_check</literal> d&eacute;termine si
-     l'identifiant de session (session id) utilis&eacute; par des sites externes
-     seront &eacute;limin&eacute;s. Si les identifiants de session sont
-     propag&eacute;s avec la m&eacute;thode des URL, des utilisateurs qui
-     n'en conna&icirc;traient pas l'utilit&eacute; risquent de divulguer ces
-     valeurs, et cela m&egrave;nera &agrave; des probl&egrave;mes de
-     s&eacute;curit&eacute;. Cette option y rem&eacute;die. Par
-     d&eacute;faut : <literal>0</literal>.
+     <literal>session.referer_check</literal> repr&eacute;sente la sous-cha&icirc;ne
+     que vous utilisez pour v&eacute;rifier la provenance de l'internaute.
+     Si l'ent&ecirc;te HTTP Referer vous est fournie par le navigateur
+     et que cette sous-cha&icirc;ne n'est pas trouv&eacute;e, la session qui vous est
+     fournie sera consid&eacute;r&eacute;e comme invalide (car provenant
+     probablement d'un autre site que le votre). Par d&eacute;faut, cette 
+     cha&icirc;ne est vide.
     </simpara>
      </listitem>
      <listitem>
@@ -954,6 +955,60 @@
       PHP 4.0.3.
      </para>
     </note>
+   </refsect1>
+  </refentry>
+  <refentry id="function.session-end">
+   <refnamediv>
+    <refname>session_end</refname>
+    <refpurpose>Ecrit les donn&eacute;es de session, et termine la 
+session</refpurpose>
+   </refnamediv>
+   <refsect1>
+    <title>Description</title>
+    <funcsynopsis>
+     <funcprototype>
+      <funcdef>void <function>session_end</function></funcdef>
+      <void/>
+     </funcprototype>
+    </funcsynopsis>
+    <para>
+     <function>session_end</function> termine la session
+     courante, et enregistre les donn&eacute;es de session.
+    </para>
+    <para>
+     Les donn&eacute;es de session sont g&eacute;n&eacute;ralement 
+     enregistr&eacute;es &agrave; la fin
+     du script, sans besoin d'appeler <function>session_end</function>,
+     mais comme les donn&eacute;es de session sont verrouill&eacute;es pour
+     &eacute;viter les acc&egrave;s concurents, seul un script peut travailler sur
+     une session &agrave; la fois. Lorsque vous utilisez des frames avec
+     des sessions, vous verrez les frames s'afficher l'un apr&egrave;s
+     l'autre, &agrave; cause de ce verrouillage. Vous pouvez r&eacute;duire le
+     temps d'attente en terminant la session le plus t&ocirc;t possible.
+    </para>
+    <para>
+     Voir aussi
+     <function>session_readonly</function>.
+    </para>
+   </refsect1>
+  </refentry>
+  <refentry id="function.session-readonly">
+   <refnamediv>
+    <refname>session_readonly</refname>
+    <refpurpose>Lit les variables de session sans verrouiller les 
+donn&eacute;es</refpurpose>
+   </refnamediv>
+   <refsect1>
+    <title>Description</title>
+    <funcsynopsis>
+     <funcprototype>
+      <funcdef>void <function>session_readonly</function></funcdef>
+      <void/>
+     </funcprototype>
+    </funcsynopsis>
+    <para>
+     <function>session_readonly</function> lit les variables de session sans
+     verrouiller les donn&eacute;es. Les modifications ne seront pas possibles, mais
+     les performances de PHP avec les frames seront am&eacute;lior&eacute;es.
+    </para>
    </refsect1>
   </refentry>
  </reference>