update sync EN revision reference misc + other

language-defs.ent

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 5097918a78b2d1de0839a48bd30912d498ac5850 Maintainer: yannick Status: ready -->
+<!-- EN-Revision: a6621a4baf56fd78a842dfd684f5c981991bddcd Maintainer: yannick Status: ready -->
 <!-- Reviewed: yes -->
 
 <!ENTITY PHPManual           "Manuel PHP">
@@ -45,7 +45,7 @@
 <!ENTITY UIExtensions                             "Extensions GUI">
 <!ENTITY Appendices        "Annexes">
 <!ENTITY PEAR              "PEAR : la réserve d'extensions et applications PHP (PHP Extension and Application Repository)">
-<!ENTITY FAQ               "FAQ : foire Aux Questions">
+<!ENTITY FAQ               "Frequently Asked Questions">
 <!ENTITY FAQabbrev         "FAQ">
 <!ENTITY Internals         "PHP et le moteur interne Zend">
 <!ENTITY Internals2        "Dans le cœur de PHP : Guide du Hacker">
@@ -114,4 +114,3 @@ fichiers supplémentaires pour marquer les titres des sections -->
 <!ENTITY reftitle.setup         '<title xmlns="http://docbook.org/ns/docbook">Installation/Configuration</title>'>
 <!ENTITY reftitle.unicode       '<title xmlns="http://docbook.org/ns/docbook">Unicode</title>'>
 <!ENTITY reftitle.usage        '<title xmlns="http://docbook.org/ns/docbook">Utilisation</title>'>
-

language/control-structures/foreach.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 44ae7cb94991c11c93bc23f8a6544f81bb36cf1a Maintainer: jpauli Status: ready -->
+<!-- EN-Revision: 53a400680d0cb2ddabd4493fb9846533c422e90d Maintainer: jpauli Status: ready -->
 <!-- Reviewed: yes -->
 
 <sect1 xml:id="control-structures.foreach" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">

reference/curl/book.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: 27fd6d7147a855eb0e407110f1db39a9c61b26d6 Maintainer: yannick Status: ready -->
+<!-- EN-Revision: 01d19a544891db839e36de8316e78f81de56c1ca Maintainer: yannick Status: ready -->
 <!-- Reviewed: yes -->
 
 <book xml:id="book.curl" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
@@ -32,6 +32,7 @@
  &reference.curl.curlhandle;
  &reference.curl.curlmultihandle;
  &reference.curl.curlsharehandle;
+ &reference.curl.curlsharepersistenthandle;
  &reference.curl.curlfile;
  &reference.curl.curlstringfile;
 
@@ -57,4 +58,3 @@ vim600: syn=xml fen fdm=syntax fdl=2 si
 vim: et tw=78 syn=sgml
 vi: ts=1 sw=1
 -->
-

reference/curl/functions/curl-share-init.xml

@@ -1,6 +1,6 @@
 <?xml version="1.0" encoding="utf-8"?>
 <!-- $Revision$ -->
-<!-- EN-Revision: b7f8c11e56ff1c57a2993e2ed7e5c5ace18637fd Maintainer: yannick Status: ready -->
+<!-- EN-Revision: 01d19a544891db839e36de8316e78f81de56c1ca Maintainer: yannick Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="function.curl-share-init" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -104,6 +104,7 @@ curl_close($ch2);
    <simplelist>
     <member><function>curl_share_setopt</function></member>
     <member><function>curl_share_close</function></member>
+    <member><function>curl_share_init_persistent</function></member>
    </simplelist>
   </para>
  </refsect1>

reference/dom/domxpath/evaluate.xml

@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 21e1338e9721534c00085ff3cff25e2dd2e84dc9 Maintainer: jpauli Status: ready -->
+<!-- EN-Revision: 01904e809eaf0aa60e7ce0524400ddd5681c9541 Maintainer: jpauli Status: ready -->
 <!-- Reviewed: yes Maintainer: yannick -->
-<refentry xml:id="domxpath.evaluate" xmlns="http://docbook.org/ns/docbook">
+<refentry xml:id="domxpath.evaluate" xmlns="http://docbook.org/ns/docbook" xmlns:xi="http://www.w3.org/2001/XInclude">
  <refnamediv>
   <refname>DOMXPath::evaluate</refname>
   <refpurpose>
@@ -47,6 +47,7 @@
    </variablelist>
   </para>
  </refsect1>
+ <xi:include xpointer="domxpath.query..errors" />
  <refsect1 role="returnvalues">
   &reftitle.returnvalues;
   <para>

reference/dom/domxpath/query.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 21e1338e9721534c00085ff3cff25e2dd2e84dc9 Maintainer: jpauli Status: ready -->
+<!-- EN-Revision: 01904e809eaf0aa60e7ce0524400ddd5681c9541 Maintainer: jpauli Status: ready -->
 <!-- Reviewed: yes -->
 <refentry xml:id="domxpath.query" xmlns="http://docbook.org/ns/docbook">
  <refnamediv>
@@ -61,6 +61,36 @@
   </para>
  </refsect1>
 
+ <refsect1 role="errors" xml:id="domxpath.query..errors">
+  &reftitle.errors;
+  <simpara>
+   Les erreurs suivantes peuvent survenir lors de l'utilisation d'une expression qui invoque
+   des callbacks PHP.
+  </simpara>
+  <itemizedlist>
+   <listitem>
+    <simpara>
+     Lance une <exceptionname>Erreur</exceptionname> si
+     un callback PHP est invoqué mais qu'aucun callback n'est enregistré,
+     ou si le callback nommé n'est pas enregistré.
+    </simpara>
+   </listitem>
+   <listitem>
+    <simpara>
+     Lance une <exceptionname>TypeError</exceptionname> si
+     la syntaxe <literal>php:function</literal> est utilisée et que le nom du gestionnaire
+     n'est pas une chaîne de caractères.
+    </simpara>
+   </listitem>
+   <listitem>
+    <simpara>
+     Lance une <exceptionname>Erreur</exceptionname> si
+     un objet non-DOM est retourné par un callback.
+    </simpara>
+   </listitem>
+  </itemizedlist>
+ </refsect1>
+
  <refsect1 role="examples">
   &reftitle.examples;
   <para>

reference/dom/domxpath/registerphpfunctions.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 2bd9a67c8c6c5961189f868364837a5c3ba7e063 Maintainer: yannick Status: ready -->
+<!-- EN-Revision: 01904e809eaf0aa60e7ce0524400ddd5681c9541 Maintainer: yannick Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="domxpath.registerphpfunctions" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -51,6 +51,26 @@
   </para>
  </refsect1>
 
+ <refsect1 role="errors" xml:id="domxpath.registerphpfunctions..errors">
+  &reftitle.errors;
+  <itemizedlist>
+   <listitem>
+    <simpara>
+     Lance une <exceptionname>ValueError</exceptionname> si
+     le nom d'un callback n'est pas valide.
+    </simpara>
+   </listitem>
+   &dom.errors.compliant.common;
+   <listitem>
+    <simpara>
+     Lance une <exceptionname>TypeError</exceptionname> si
+     un callback donné n'est pas appelable.
+    </simpara>
+   </listitem>
+  </itemizedlist>
+ </refsect1>
+
+
  <refsect1 role="changelog">
   &reftitle.changelog;
   <informaltable>
@@ -62,6 +82,15 @@
      </row>
     </thead>
     <tbody>
+     <row xml:id="domxpath.registerphpfunctions..changelog.errors">
+       <entry>8.4.0</entry>
+       <entry>
+        Les noms de callback invalides lancent maintenant une
+        <exceptionname>ValueError</exceptionname>.
+        Passer une entrée non appelable lance maintenant une
+        <exceptionname>TypeError</exceptionname>.
+       </entry>
+     </row>
      <row>
       <entry>8.4.0</entry>
       <entry>

reference/password/functions/password-hash.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 762b61c66262a1e0c329dacdcc3be6f1702c299d Maintainer: yannick Status: ready -->
+<!-- EN-Revision: e302f07943465892db7f72469e2ce9b42c4f763f Maintainer: yannick Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="function.password-hash" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -36,9 +36,9 @@
     </listitem>
     <listitem>
      <simpara>
-      <constant>PASSWORD_BCRYPT</constant> - Utilisation de l'algorithme <constant>CRYPT_BLOWFISH</constant>
+      <constant>PASSWORD_BCRYPT</constant> - Utilisation de l'algorithme bcrypt
       pour créer la clé de hachage. Ceci va créer une clé de hachage standard <function>crypt</function>
-      utilisant l'identifiant "$2y$". Le résultat sera toujours une chaîne de 60 caractères, &return.falseforfailure;.
+      utilisant l'identifiant <literal>$2y$</literal>. Le résultat sera toujours une chaîne de 60 caractères, &return.falseforfailure;.
      </simpara>
     </listitem>
     <listitem>
@@ -84,7 +84,7 @@
         de la fonction <function>crypt</function>.
        </para>
        <para>
-        Si omis, la valeur par défaut <literal>10</literal> sera utilisée. C'est un bon compromis,
+        Si omis, la valeur par défaut <literal>12</literal> sera utilisée. C'est un bon compromis,
         mais vous pourriez vouloir l'augmenter suivant votre architecture.
        </para>
       </listitem>
@@ -159,10 +159,6 @@
      <para>
       &password.parameter.options;
      </para>
-     <para>
-      Si omis, un salt aléatoire sera créé et le cost par défaut sera
-      utilisé.
-     </para>
     </listitem>
    </varlistentry>
   </variablelist>
@@ -193,6 +189,14 @@
       </row>
      </thead>
      <tbody>
+      <row>
+        <entry>8.4.0</entry>
+        <entry>
+         La valeur par défaut de l'option <literal>cost</literal> de
+         l'algorithme <constant>PASSWORD_BCRYPT</constant> a été augmentée de
+         <literal>10</literal> à <literal>12</literal>.
+        </entry>
+      </row>
       <row>
        <entry>8.3.0</entry>
        <entry>
@@ -274,7 +278,7 @@ echo password_hash("rasmuslerdorf", PASSWORD_DEFAULT);
     &example.outputs.similar;
     <screen>
 <![CDATA[
-$2y$10$.vGA1O9wmRjrwAVXD98HNOgsNpDczlqm3Jq7KnEd1rVAGv3Fykk1a
+$2y$12$4Umg0rCJwMswRw/l.SwHvuQV01coP0eWmGzd61QH2RvAOMANUBGC.
 ]]>
     </screen>
    </example>
@@ -286,13 +290,11 @@ $2y$10$.vGA1O9wmRjrwAVXD98HNOgsNpDczlqm3Jq7KnEd1rVAGv3Fykk1a
 <![CDATA[
 <?php
 /**
- * Dans ce cas, nous souhaitons augmenter le "cost" par défaut pour BCRYPT à la valeur 12.
- * Notez que nous passons également à l'algorithme BCRYPT, qui produit toujours un résultat
- * de 60 caractères.
+ * Dans ce cas, nous voulons augmenter le coût de bcrypt à 13.
  */
 
 $options = [
-    'cost' => 12,
+    'cost' => 13,
 ];
 echo password_hash("rasmuslerdorf", PASSWORD_BCRYPT, $options);
 ?>
@@ -301,7 +303,7 @@ echo password_hash("rasmuslerdorf", PASSWORD_BCRYPT, $options);
     &example.outputs.similar;
     <screen>
 <![CDATA[
-$2y$12$QjSH496pcT5CEbzjD/vtVeH03tfHKFy36d4J0Ltp3lRtee9HDxY3K
+$2y$13$xeDfQumlmdm0Sco.4qmH1OGfUUmOcuRmfae0dPJhjX1Bq0yYhqbNi
 ]]>
     </screen>
    </example>
@@ -315,14 +317,14 @@ $2y$12$QjSH496pcT5CEbzjD/vtVeH03tfHKFy36d4J0Ltp3lRtee9HDxY3K
 /**
  * Ce code va tester votre serveur pour déterminer quel serait le meilleur "cost".
  * Vous souhaitez définir le "cost" le plus élevé possible sans trop ralentir votre serveur.
- * 10 est une bonne base, mais une valeur plus élevée est aussi un bon choix à partir
+ * 11 est une bonne base, mais une valeur plus élevée est aussi un bon choix à partir
  * du moment où votre serveur est suffisament rapide ! Le code suivant espère un temps
  * ≤ à 350 millisecondes, ce qui est un délai approprié pour les systèmes gérants les identifications
  * intéractivement.
  */
 $timeTarget = 0.350; // 350 millisecondes
 
-$cost = 10;
+$cost = 11;
 do {
     $cost++;
     $start = microtime(true);
@@ -337,7 +339,7 @@ echo "Valeur de 'cost' la plus appropriée : " . $cost;
     &example.outputs.similar;
     <screen>
 <![CDATA[
-Valeur de 'cost' la plus appropriée : 12
+Valeur de 'cost' la plus appropriée : 13
 ]]>
     </screen>
    </example>

reference/password/functions/password-needs-rehash.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: ff492e168a557e4dd17574023b7c3cb21b14df3b Maintainer: yannick Status: ready -->
+<!-- EN-Revision: e302f07943465892db7f72469e2ce9b42c4f763f Maintainer: yannick Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="function.password-needs-rehash" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -95,11 +95,11 @@
 <?php
 
 $password = 'rasmuslerdorf';
-$hash = '$2y$10$YCFsG6elYca568hBi2pZ0.3LDL5wjgxct1N8w/oLR/jfHsiQwCqTS';
+$hash = '$2y$12$4Umg0rCJwMswRw/l.SwHvuQV01coP0eWmGzd61QH2RvAOMANUBGC.';
 
 $algorithm = PASSWORD_BCRYPT;
 // Le paramètre cost de bcrypt peut évoluer avec le temps en fonction des améliorations matérielles.
-$options = ['cost' => 12];
+$options = ['cost' => 13];
 
 // Vérifions d'abord que le mot de passe correspond au hachage stocké
 if (password_verify($password, $hash)) {

reference/password/functions/password-verify.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 5bc68add3da3cd18c40f851e944b15095d3a26aa Maintainer: yannick Status: ready -->
+<!-- EN-Revision: 5baba54a67be43d689970983cfc6d24debad1ce0 Maintainer: yannick Status: ready -->
 <!-- Reviewed: no -->
 <refentry xml:id="function.password-verify" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <refnamediv>
@@ -77,7 +77,7 @@
 <?php
 // Voir l'exemple fourni sur la page de la fonction password_hash()
 // pour savoir d'où cela provient.
-$hash = '$2y$10$.vGA1O9wmRjrwAVXD98HNOgsNpDczlqm3Jq7KnEd1rVAGv3Fykk1a';
+$hash = '$2y$12$4Umg0rCJwMswRw/l.SwHvuQV01coP0eWmGzd61QH2RvAOMANUBGC.';
 
 if (password_verify('rasmuslerdorf', $hash)) {
     echo 'Le mot de passe est valide !';
@@ -103,7 +103,6 @@ Le mot de passe est valide !
    <simplelist>
     <member><function>password_needs_rehash</function></member>
     <member><function>password_hash</function></member>
-    <member><link xmlns:xlink="http://www.w3.org/1999/xlink" xlink:href="&url.password.compat;">l'implémentation en espace utilisateur</link></member>
     <member><function>sodium_crypto_pwhash_str_verify</function></member>
    </simplelist>
   </para>