Fix/full doc fr review 4

.claude/settings.local.json

@@ -0,0 +1,23 @@
+{
+  "permissions": {
+    "allow": [
+      "Bash(bash:*)",
+      "Bash(node -e:*)",
+      "Bash(node:*)",
+      "Bash(while IFS='|' read filepath fr_hash en_hash)",
+      "Bash(do echo \"=== $filepath ===\" echo \"FR points to: $fr_hash\" echo \"EN current: $en_hash\" git diff \"$fr_hash\"..\"$en_hash\" -- \"$filepath\")",
+      "Bash(skip=\"[SKIP]\")",
+      "Bash(__NEW_LINE_c89e4ccfde51d0a2__ echo \"\")",
+      "Bash(__NEW_LINE_367c5fcbb11f09fe__ echo \"\")",
+      "Bash(__NEW_LINE_454259d5376d896e__ echo \"\")",
+      "Bash(__NEW_LINE_28964b2a7d5796a6__ echo \"\")",
+      "Bash(git config:*)",
+      "Bash(xxd:*)",
+      "Bash(# Force git to re-detect changes by touching the index cd /c/Users/louis/www/opensource/php-doc/doc-fr && git update-index --really-refresh ; git diff --name-only)",
+      "Bash(git status:*)",
+      "Bash(git add:*)",
+      "Bash(git commit:*)",
+      "Bash(git push:*)"
+    ]
+  }
+}

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/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/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/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/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/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>.

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>

install/ini.xml

@@ -84,7 +84,7 @@ xmlns:xi="http://www.w3.org/2001/XInclude">
   </para>
   <para>
    Si le fichier <filename>php-SAPI.ini</filename> existe (où SAPI utilise SAPI, donc le
-   nom du fichier est e.g. <filename>php-cli.ini</filename> ou
+   nom du fichier est par exemple <filename>php-cli.ini</filename> ou
    <filename>php-apache.ini</filename>), il sera utilisé à la place du &php.ini;.
    Le nom SAPI peut être déterminé en utilisant la fonction <function>php_sapi_name</function>.
   </para>

install/intro.xml

@@ -19,7 +19,7 @@
   avez besoin de trois choses : PHP lui-même, un serveur Web et
   un navigateur. Vous avez probablement un navigateur, et en
   fonction de votre système d'exploitation, vous pouvez
-  aussi disposer d'un serveur Web (i.e. Apache sous Linux et macOS
+  aussi disposer d'un serveur Web (c.-à-d. Apache sous Linux et macOS
   ou IIS sous Windows). Vous pouvez aussi louer un espace
   à une société. De cette façon, vous n'aurez pas à mettre
   en place PHP, mais uniquement à écrire vos scripts, les charger

language/constants.xml

@@ -322,7 +322,7 @@ echo ANIMALS[1]; // affiche "chat"
        <entry><constant>__TRAIT__</constant></entry>
        <entry>
         Le nom du trait. Le nom du trait inclut l'espace de nom
-        dans lequel il a été déclaré (e.g. <literal>Foo\Bar</literal>).
+        dans lequel il a été déclaré (par exemple <literal>Foo\Bar</literal>).
        </entry>
       </row>
       <row xml:id="constant.method">

language/context/zip.xml

@@ -7,7 +7,7 @@
 annotations="verify_info:false" role="stream_context_option">
  <refnamediv>
   <refname>Options de contexte Zip</refname>
-  <refpurpose>Zip context option listing</refpurpose>
+  <refpurpose>Liste des options de contexte Zip</refpurpose>
  </refnamediv>
 
  <refsect1 role="description"><!-- {{{ -->

language/operators/functional.xml

@@ -103,7 +103,7 @@ Array
  <note>
   <para>
    Sachez que, pour éviter toute ambiguïté syntaxique, les <link linkend="functions.arrow">fonctions fléchées</link>
-   DOIVENT être placées entre parenthèses lorsqu'elle sont utilisées avec un opérateur de pipeline, comme dans les exemples ci-dessus.
+   DOIVENT être placées entre parenthèses lorsqu'elles sont utilisées avec un opérateur de pipeline, comme dans les exemples ci-dessus.
    Ne pas le faire entraînera une erreur fatale.
   </para>
  </note>