[Sync-En] session: read() returns false to report a failure, an empty string for no data

reference/session/functions/session-set-save-handler.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: ca23605a1c0e46b9ec85975c6387528c32a7087f Maintainer: lacatoire Status: ready -->
+<!-- EN-Revision: 38bdb42b928616a559444a29fb5ae41f150fec59 Maintainer: lacatoire Status: ready -->
 
 <refentry xmlns="http://docbook.org/ns/docbook" xml:id="function.session-set-save-handler" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -48,7 +48,7 @@
      <term><parameter>sessionhandler</parameter></term>
      <listitem>
       <para>
-       Une instance d'une classe implémentant une ou plusieurs des interfaces suivantes:
+       Une instance d'une classe implémentant une ou plusieurs des interfaces suivantes :
        <interfacename>SessionHandlerInterface</interfacename>, et optionnellement
        <interfacename>SessionIdInterface</interfacename>, et/ou
        <interfacename>SessionUpdateTimestampHandlerInterface</interfacename>,
@@ -118,15 +118,17 @@
       <para>
        Une fonction de rappel avec la signature suivante :
        <methodsynopsis>
-        <type>string</type><methodname><replaceable>read</replaceable></methodname>
+        <type class="union"><type>string</type><type>false</type></type><methodname><replaceable>read</replaceable></methodname>
         <methodparam><type>string</type><parameter>sessionId</parameter></methodparam>
        </methodsynopsis>
       </para>
-      <para>
+      <simpara>
        La fonction de rappel <parameter>read</parameter> doit toujours retourner
        une chaîne sérialisée contenant les données de session encodées
        ou une chaîne vide s'il n'y a aucune donnée à lire.
-      </para>
+       Elle doit retourner &false; pour signaler un échec :
+       <function>session_start</function> émet alors un <constant>E_WARNING</constant> et retourne &false;.
+      </simpara>
       <para>
        Cette fonction de rappel est appelée en interne par PHP lorsque la session
        commence ou lorsque la fonction <function>session_start</function> est appelée.
@@ -370,6 +372,7 @@ session_start();
     et donc, ne peuvent pas utiliser les objets ou lancer des exceptions.
     Les exceptions ne peuvent donc pas être attrapées ni affichées,
     et l'exécution ne fera que s'arrêter de façon inattendue.
+    Les destructeurs d'objets peuvent cependant utiliser les sessions.
    </para>
    <para>
     Il est possible d'appeler <function>session_write_close</function> depuis

reference/session/sessionhandler/read.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 4de6272a1f15efc9e3df21d255965fd890da0d6f Maintainer: lacatoire Status: ready -->
+<!-- EN-Revision: 38bdb42b928616a559444a29fb5ae41f150fec59 Maintainer: lacatoire Status: ready -->
 <refentry xml:id="sessionhandler.read" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
   <refname>SessionHandler::read</refname>
@@ -54,10 +54,12 @@
 
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
-  <para>
-   Retourne les données lues sous forme encodée. Si rien n'a été lu &false; doit être retournée.
+  <simpara>
+   Retourne les données de session encodées lues depuis le gestionnaire de sauvegarde interne,
+   une chaîne vide s'il ne contient aucune donnée pour l'ID de session,
+   ou &false; si le gestionnaire de sauvegarde interne n'a pas réussi à les lire.
    Cette valeur est utilisée en interne par PHP.
-  </para>
+  </simpara>
  </refsect1>
 
  <refsect1 role="seealso">

reference/session/sessionhandlerinterface/read.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 601f6f4ce5827d441a7e110184708f0abe9fd447 Maintainer: jpauli Status: ready -->
+<!-- EN-Revision: 38bdb42b928616a559444a29fb5ae41f150fec59 Maintainer: jpauli Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="sessionhandlerinterface.read" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -18,13 +18,14 @@
    Appelé juste après que la session démarre ou lorsque <function>session_start</function> est appelée.
    Notez qu'avant que cette méthode ne soit appelée, <function>SessionHandlerInterface::open</function> est invoquée.
   </para>
-  <para>
+  <simpara>
    Cette méthode est appelée par PHP lui-même lorsque la session démarre. Cette méthode devrait
    retourner les données de session lues depuis le support de stockage en fonction de l'ID de
-   session. La chaîne retournée devrait être encodée par le même mécanisme de sérialisation que
+   session. La chaîne retournée doit être encodée par le même mécanisme de sérialisation que
    celui utilisé pour écrire les données lors de <function>SessionHandlerInterface::write</function>.
-   Si l'enregistrement n'est pas trouvé, &false; est retourné.
-  </para>
+   Retourner une chaîne vide lorsqu'aucune donnée n'est stockée pour l'ID de session donné ;
+   retourner &false; uniquement pour signaler un échec.
+  </simpara>
   <para>
    Les données retournées par cette méthode seront décodées en interne par PHP en utilisant le
    mécanisme de désérialisation spécifié dans
@@ -53,11 +54,13 @@
 
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
-  <para>
-   Retourne les données lues encodées.
-   Si rien n'est lu &false; doit être retourné.
+  <simpara>
+   Retourne les données lues encodées,
+   ou une chaîne vide si aucune donnée n'est stockée pour l'ID de session.
+   Retourner &false; signale un échec :
+   <function>session_start</function> émet alors un <constant>E_WARNING</constant> et retourne &false;.
    Il est à noter que cette valeur est destinée aux processus internes à PHP.
-  </para>
+  </simpara>
  </refsect1>
 
   <refsect1 role="seealso">