Doc review 4

appendices/about.xml

@@ -177,7 +177,7 @@ Retourne la taille de la chaîne $string.
        </entry>
        <entry>
         Type de valeur retournée par cette fonction, qui est, en l'occurrence,
-        un &integer; (i.e. la taille d'une chaîne est mesurée par
+        un &integer; (c.-à-d. la taille d'une chaîne est mesurée par
         un nombre).
        </entry>
       </row>

appendices/comparisons.xml

@@ -43,7 +43,7 @@
    constante <constant>NAN</constant>. Toutes les comparaisons de cette valeur
    avec une autre valeur, y compris cette même valeur, à l'exception de &true; 
    auront comme résultat &false;
-   (i.e. <literal>NAN != NAN</literal> et <literal>NAN !== NAN</literal>).
+   (c.-à-d. <literal>NAN != NAN</literal> et <literal>NAN !== NAN</literal>).
    Exemples d'opérations qui produisent la valeur <constant>NAN</constant> :
    <literal>sqrt(-1)</literal>, <literal>asin(2)</literal>, et
    <literal>acosh(0)</literal>.

appendices/history.xml

@@ -317,7 +317,7 @@
      et je pensais que Gtk+ était une excellente bibliothèque, hormis le fait
      que programmer avec en C est plutôt laborieux.
      Après avoir assisté aux implémentations de PyGtk et GTK-Perl,
-     j'ai décidé de  voir si PHP pouvait disposer de sa propre interface
+     j'ai décidé de voir si PHP pouvait disposer de sa propre interface
      avec Gtk+, même minimale. J'ai commencé au mois d'août 2000,
      alors que j'avais un peu plus de temps libre, et j'ai réalisé les
      premières expérimentations. Mon guide principal fut l'implémentation de

appendices/ini.core.xml

@@ -849,9 +849,9 @@ Fatal error: Maximum execution time of 30+2 seconds exceeded (terminated) in Unk
         que <parameter>post_max_size</parameter>, les
         <link linkend="language.variables.superglobals">superglobales</link>
         <varname>$_POST</varname> et <varname>$_FILES</varname>
-        seront vides. Ceci peut être surveillé de différentes façons, e.g. en passant
+        seront vides. Ceci peut être surveillé de différentes façons, par exemple, en passant
         une variable <varname>$_GET</varname> au script qui traite les données,
-        i.e. <literal>&lt;form action="edit.php?processed=1"&gt;</literal>, et ainsi
+        c.-à-d. <literal>&lt;form action="edit.php?processed=1"&gt;</literal>, et ainsi
         vérifier si <varname>$_GET['processed']</varname> est défini.
        </simpara>
        <para>
@@ -1290,7 +1290,7 @@ include_path = ".:${USER}/pear/php"
        </para>
        <para>
         Dans le fichier <filename>httpd.conf</filename>, <option>open_basedir</option>
-        peut être désactivée (i.e. pour certains hôtes virtuels) de la
+        peut être désactivée (c.-à-d. pour certains hôtes virtuels) de la
         <link linkend="configuration.changes.apache">même façon</link> 
         que n'importe quelle directive de configuration avec
         "<literal>php_admin_value open_basedir none</literal>".
@@ -1564,9 +1564,9 @@ include_path = ".:${USER}/pear/php"
         <link xlink:href="&url.rfc;2616">RFC 2616</link>.
        </para>
        <para>
-        Si cette option est activée, et que vous exécutez PHP en environnement CGI (e.g. PHP-FPM),
+        Si cette option est activée, et que vous exécutez PHP en environnement CGI (par exemple, PHP-FPM),
         vous ne devriez pas utiliser les en-têtes de réponse HTTP "status" RFC 2616, mais plutôt
-        utiliser l'équivalent RFC 3875, i.e. au lieu de l'en-tête ("HTTP/1.0 404 Not found"), utilisez
+        utiliser l'équivalent RFC 3875, c.-à-d. au lieu de l'en-tête ("HTTP/1.0 404 Not found"), utilisez
         ("Status: 404 Not Found").
        </para>
        <para>

appendices/migration70/new-features.xml

@@ -59,7 +59,7 @@ int(9)
   <title>Déclarations du type de retour</title>
 
   <para>
-   PHP 7 ajoute un support pour  les
+   PHP 7 ajoute un support pour les
    <link linkend="language.types.declarations">déclarations du type de retour</link>.
    Similaires aux 
    <link linkend="language.types.declarations">déclarations du type d'argument</link>,

appendices/migration71/windows-support.xml

@@ -37,12 +37,12 @@
       <itemizedlist>
        <listitem>
         <simpara>
-         sapi_windows_cp_set() to set the default codepage
+         sapi_windows_cp_set() pour définir la page de codes par défaut
         </simpara>
        </listitem>
        <listitem>
         <simpara>
-         sapi_windows_cp_get() to retrieve the current codepage
+         sapi_windows_cp_get() pour récupérer la page de codes actuelle
         </simpara>
        </listitem>
        <listitem>
@@ -52,7 +52,7 @@
        </listitem>
        <listitem>
         <simpara>
-         sapi_windows_cp_conv() to convert between codepages, using iconv() compatible signature
+         sapi_windows_cp_conv() pour convertir entre les pages de codes, en utilisant une signature compatible avec iconv()
         </simpara>
        </listitem>
       </itemizedlist>

appendices/migration72/new-features.xml

@@ -407,7 +407,7 @@ use Foo\Bar\{
   <itemizedlist>
    <listitem>
     <simpara>
-     Le modificateur <literal>J</literal> pour définir  PCRE_DUPNAMES a été ajouté.
+     Le modificateur <literal>J</literal> pour définir PCRE_DUPNAMES a été ajouté.
     </simpara>
    </listitem>
   </itemizedlist>
@@ -427,7 +427,7 @@ use Foo\Bar\{
   <title><link linkend="book.oci8">Oracle OCI8</link> prise en charge du Transparent Application Failover</title>
 
   <para>
-   La prise en charge de la <link linkend="oci8.taf">fonction de rappel de Transparent Application Failover (TAF)</link> a été ajouté.
+   La prise en charge de la <link linkend="oci8.taf">fonction de rappel de Transparent Application Failover (TAF)</link> a été ajoutée.
    TAF permet aux applications PHP oci8 de se reconnecter automatiquement à 
    une base de données préconfigurée lorsqu'une connexion est rompue. Le 
    nouveau support de rappel TAF permet aux applications PHP de surveiller et 

appendices/migration74/incompatible.xml

@@ -284,7 +284,7 @@
    <listitem>
     <simpara>
      Potentiellement d'autres fonctions travaillant sur les propriétés de l'objet comme une liste,
-     e.g. <function>array_walk</function>.
+     par exemple <function>array_walk</function>.
     </simpara>
    </listitem>
   </itemizedlist>

appendices/migration80/other-changes.xml

@@ -269,8 +269,8 @@
    <listitem>
     <para>
      <!--<link linkend="ini.zend.exception-string-param-max-len">-->zend.exception_string_param_max_len<!--</link>-->
-     est une nouvelle directive INI pour changer la longueur maximum d'une chaîne de caratères dans un argument d'une trace d'appels
-     transformée en chaîne de caratères.
+     est une nouvelle directive INI pour changer la longueur maximum d'une chaîne de caractères dans un argument d'une trace d'appels
+     transformée en chaîne de caractères.
     </para>
    </listitem>
    </itemizedlist>

appendices/migration81/deprecated.xml

@@ -238,7 +238,7 @@ $arr[] = 2;
  </sect2>
 
  <sect2 xml:id="migration81.deprecated.mbstring">
-  <title>Chaine de caractères multibytes</title>
+  <title>Chaîne de caractères multibytes</title>
 
   <para>
    Appeller <function>mb_check_encoding</function> avec aucun argument

appendices/migration83/other-changes.xml

@@ -51,7 +51,7 @@
 
    <para>
     Un stream de mémoire ne retourne plus d'erreur si le décalage de recherche est au-delà de la fin.
-    A la place, la mémoire sera augmentée à la prochaine écriture et les données entre
+    A la place, la mémoire sera augmentée à la prochaîne écriture et les données entre
     l'ancienne fin et le décalage sont remplies de zéros, similaire à la façon dont les fichiers fonctionnent.
    </para>
 
@@ -239,22 +239,22 @@
 
    <para>
     <function>mb_encode_mimeheader</function> ne supprime plus les octets NUL
-    (zéro) lors de l'encodage QPrint de la chaine d'entrée.
-    Cela corrompait précédemment les chaines dans certains encodages de texte,
+    (zéro) lors de l'encodage QPrint de la chaîne d'entrée.
+    Cela corrompait précédemment les chaînes dans certains encodages de texte,
     en particulier UTF-16 et UTF-32, par mb_encode_mimeheader.
    </para>
 
    <para>
     <function>mb_detect_encoding</function> en mode "non-strict" se comporte
     désormais comme décrit dans la documentation.
     Auparavant, il retournait &false; si le même octet (par exemple, le premier
-    octet) de la chaine d'entrée était invalide dans tous les encodages candidats.
+    octet) de la chaîne d'entrée était invalide dans tous les encodages candidats.
     Plus généralement, il éliminait les encodages candidats de la considération
     lorsqu'un octet invalide était vu, et si le même octet d'entrée éliminait
     tous les encodages restants encore sous considération, il retournait &false;.
     D'autre part, si tous les encodages candidats sauf un étaient éliminés
     de la considération, il retournait le dernier restant sans tenir compte
-    du nombre d'erreurs d'encodage qui pourraient être rencontrées plus tard dans la chaine.
+    du nombre d'erreurs d'encodage qui pourraient être rencontrées plus tard dans la chaîne.
     Ceci est différent du comportement décrit dans la documentation, qui
     dit : "Si strict est défini sur false, l'encodage le plus proche
     sera retourné."
@@ -423,7 +423,7 @@
 
    <para>
     <function>str_getcsv</function> et <function>fgetcsv</function> retournent désormais
-    une chaine vide au lieu d'une chaine avec un seul octet nul pour le dernier champ
+    une chaîne vide au lieu d'une chaîne avec un seul octet nul pour le dernier champ
     qui ne contient qu'une enceinte non terminée.
    </para>
   </sect3>

appendices/migration84/incompatible.xml

@@ -520,17 +520,17 @@
   <title>MBString</title>
 
   <simpara>
-   En cas de chaines invalides (celles avec des erreurs d'encodage),
+   En cas de chaînes invalides (celles avec des erreurs d'encodage),
    <function>mb_substr</function> interprète désormais les indices de caractères
    de la même manière que la plupart des autres fonctions mbstring.
    Cela signifie que les indices de caractères retournés par <function>mb_strpos</function>
    peuvent être passés à <function>mb_substr</function>.
   </simpara>
 
   <simpara>
-   Pour les chaines SJIS-Mac (MacJapanese), les indices de caractères passés à
+   Pour les chaînes SJIS-Mac (MacJapanese), les indices de caractères passés à
    <function>mb_substr</function> font désormais référence aux indices des
-   points de code Unicode qui sont produits lorsque la chaine est convertie en Unicode.
+   points de code Unicode qui sont produits lorsque la chaîne est convertie en Unicode.
    C'est significatif car environ 40 caractères SJIS-Mac se convertissent en une
    séquence de plusieurs points de code Unicode.
   </simpara>

appendices/migration84/new-features.xml

@@ -13,17 +13,47 @@
    <title>Propriété avec hooks</title>
 
    <simpara>
-    TODO
+    Les propriétés d'objet peuvent désormais avoir une logique supplémentaire
+    associée à leurs opérations <literal>get</literal> et <literal>set</literal>.
+    Selon l'utilisation, cela peut rendre la propriété virtuelle ou non,
+    c'est-à-dire qu'elle n'a aucune valeur de stockage sous-jacente.
    </simpara>
 
    <informalexample>
     <programlisting role="php">
 <![CDATA[
 <?php
-/*
-examples
-*/
+class Person
+{
+    // Une propriété "virtuelle". Elle ne peut pas être définie explicitement.
+    public string $fullName {
+        get => $this->firstName . ' ' . $this->lastName;
+    }
+
+    // Toutes les opérations d'écriture passent par ce hook, et le résultat est ce qui est écrit.
+    // L'accès en lecture se fait normalement.
+    public string $firstName {
+        set => ucfirst(strtolower($value));
+    }
+
+    // Toutes les opérations d'écriture passent par ce hook, qui doit écrire dans la valeur de stockage lui-même.
+    // L'accès en lecture se fait normalement.
+    public string $lastName {
+        set {
+            if (strlen($value) < 2) {
+                throw new \InvalidArgumentException('Too short');
+            }
+            $this->lastName = $value;
+        }
+    }
+}
+
+$p = new Person();
 
+$p->firstName = 'peter';
+print $p->firstName; // Affiche "Peter"
+$p->lastName = 'Peterson';
+print $p->fullName; // Affiche "Peter Peterson"
 ]]>
     </programlisting>
    </informalexample>

appendices/migration85/new-features.xml

@@ -229,7 +229,7 @@ print T1 . PHP_EOL;   // Affiche "0"
    <constant>CURLOPT_INFILESIZE</constant> n'accepte qu'un entier signé 32 bits comme
    taille de fichier (2,0 Gio) même sur les systèmes 64 bits.
    <constant>CURLOPT_INFILESIZE_LARGE</constant> accepte la plus grande valeur entière
-   the system can handle.
+   que le système peut gérer.
   </simpara>
 
   <simpara>

appendices/reserved.constants.core.xml

@@ -28,7 +28,7 @@
    <listitem>
     <simpara>
      La version majeure courante de PHP sous la forme d'une chaîne de
-     caractères (e.g., int(5) depuis la version "5.2.7-extra").
+     caractères (par exemple, int(5) depuis la version "5.2.7-extra").
     </simpara>
    </listitem>
   </varlistentry>
@@ -40,7 +40,7 @@
    <listitem>
     <simpara>
      La version mineure courante de PHP sous la forme d'une chaîne de
-     caractères (e.g., int(2) depuis la version "5.2.7-extra").
+     caractères (par exemple, int(2) depuis la version "5.2.7-extra").
     </simpara>
    </listitem>
   </varlistentry>
@@ -52,7 +52,7 @@
    <listitem>
     <simpara>
      La version stable courante de PHP sous la forme d'une chaîne de
-     caractères (e.g., int(7) depuis la version "5.2.7-extra").
+     caractères (par exemple, int(7) depuis la version "5.2.7-extra").
     </simpara>
    </listitem>
   </varlistentry>
@@ -65,7 +65,7 @@
     <simpara>
      La version courante de PHP sous la forme d'un entier,
      utile pour la comparaison de versions
-     (e.g., int(50207) depuis la version "5.2.7-extra").
+     (par exemple, int(50207) depuis la version "5.2.7-extra").
     </simpara>
    </listitem>
   </varlistentry>
@@ -77,7 +77,7 @@
    <listitem>
     <simpara>
      La version "extra" courante de PHP sous la forme
-     d'une chaîne de caractères(i.e., '-extra'
+     d'une chaîne de caractères (c.-à-d. '-extra'
      depuis la version "5.2.7-extra"). Habituellement
      utilisée par les packagers des distributions
      pour indiquer une version de paquet.
@@ -199,7 +199,7 @@
    </term>
    <listitem>
     <simpara>
-     The operating system PHP was built for.
+     Le système d'exploitation pour lequel PHP a été compilé.
     </simpara>
    </listitem>
   </varlistentry>

appendices/tokens.xml

@@ -801,7 +801,7 @@ defined('T_FN') || define('T_FN', 10001);
     <row xml:id="constant.t-string">
      <entry><constant>T_STRING</constant></entry>
      <entry>parent, self, etc.</entry>
-     <entry>identifiants, e.g. mots-clés comme <literal>parent</literal> et
+     <entry>identifiants, par exemple les mots-clés comme <literal>parent</literal> et
       <literal>self</literal>, noms de fonctions, classes et autres, correspondent.
       Voir aussi <constant>T_CONSTANT_ENCAPSED_STRING</constant>.
      </entry>

chapters/intro.xml

@@ -149,7 +149,7 @@ echo "Bonjour, je suis un script PHP !";
    <link linkend="refs.database">énormément de bases de données</link>.
    Écrire une page web faisant appel à une base de données devient
    terriblement simple, en utilisant une des extensions spécifiques
-   aux bases de données (i.e., pour <link linkend="book.mysqli">mysql</link>),
+   aux bases de données (c.-à-d. pour <link linkend="book.mysqli">mysql</link>),
    ou utilisant une classe d'abstraction comme <link linkend="book.pdo">PDO</link>,
    ou une connexion à n'importe quelle base de données supportant la connexion
    standard ouvert via l'extension <link linkend="book.uodbc">ODBC</link>.

faq/general.xml

@@ -21,7 +21,7 @@
       Depuis la <link linkend="preface">préface de ce manuel</link> :
      </para>
      <para>
-      PHP est un langage de script HTML, exécuté coté serveur. Sa syntaxe
+      PHP est un langage de script HTML, exécuté côté serveur. Sa syntaxe
       est empruntée aux langages C, Java et Perl, et est facile à apprendre.
       Le but de ce langage est de permettre aux développeurs web
       d'écrire des pages dynamiques rapidement, mais vous pouvez

faq/html.xml

@@ -301,7 +301,7 @@ variable = document.forms[0].elements['var[]'];
       et de faire rafraîchir le navigateur tout seul, passant ainsi des variables spécifiques
       au script PHP. L'exemple suivant montre précisément comme réaliser cela --
       il permet à PHP de récupérer les dimensions de l'écran du client, ce qui est normalement
-      possible qu'en technologie coté client.
+      possible qu'en technologie côté client.
      </para>
      <para>
       <example>

faq/passwords.xml

@@ -31,7 +31,7 @@
     </simpara>
     <simpara>
      En appliquant un hachage sur le mot de passe, vous rendez
-     la tâche d'un attaquant très difficile pour connaitre le mot de passe original,
+     la tâche d'un attaquant très difficile pour connaître le mot de passe original,
      et vous avez toujours la possibilité de comparer le mot de passe hashé à une chaîne
      reçue.
     </simpara>

features/commandline.xml

@@ -892,7 +892,7 @@ Additional .ini files parsed:      (none)
        <entry>
         <para>
          Affiche des informations sur la fonction donnée ou la méthode
-         d'une classe (i.e. nombre et nom des paramètres).
+         d'une classe (c.-à-d. nombre et nom des paramètres).
         </para>
         <para>
          Cette option n'est disponible que si PHP a été compilé avec le support
@@ -1641,7 +1641,7 @@ php >
     Les fichiers inclus via <link
     linkend="ini.auto-prepend-file">auto_prepend_file</link> et <link
     linkend="ini.auto-append-file">auto_append_file</link> sont analysés
-    dans ce mode, mais avec quelques restrictions - i.e. les fonctions
+    dans ce mode, mais avec quelques restrictions - c.-à-d. les fonctions
     doivent avoir été définies avant l'appel.
    </para>
   </note>