[Sync-En] features: fix typos and grammar

features/commandline.xml

@@ -1,5 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- EN-Revision: 14f641dc7a2eb3ab1f97062f0a74f7cdb59ae708 Maintainer: lacatoire Status: ready -->
+<!-- EN-Revision: 5e6ca803fc284739a7b1e7fba58b6b8466d5006f Maintainer: lacatoire Status: ready -->
 
 <chapter xml:id="features.commandline" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
  <title>Utiliser PHP en ligne de commande</title>
@@ -88,7 +88,7 @@
 
   <para>
    Les différences les plus notables entre le &cli; <acronym>SAPI</acronym> et les
-   <acronym>SAPI</acronym> sont :
+   autres <acronym>SAPI</acronym> sont :
    <itemizedlist>
     <listitem>
      <para>
@@ -137,7 +137,7 @@
           <entry>
            Par défaut à &false;, vu qu'il peut être bien difficile de lire des messages
            d'erreur sur un terminal lorsqu'ils sont noyés dans des balises <acronym>HTML</acronym>
-           non-interprétées.
+           non interprétées.
           </entry>
          </row>
          <row>
@@ -224,7 +224,7 @@ if (php_sapi_name() === 'cli') {
           <entry>&false;</entry>
           <entry>
            <para>
-            Le PHP &cli; ne supporte pas GET, POST et le téléchargement de fichiers.
+            Le PHP &cli; ne supporte ni GET, ni POST, ni le téléchargement de fichiers.
            </para>
           </entry>
          </row>
@@ -313,11 +313,11 @@ $ php -f autre_dossier/test.php
       </para>
      </example>
      <note>
-      <para>
+      <simpara>
        Le <acronym>CGI</acronym> <acronym>SAPI</acronym> se comporte de la même façon que le
        &cli.sapi;, en lui passant l'option
        <option>-C</option>, lorsqu'il est invoqué en ligne de commande.
-      </para>
+      </simpara>
      </note>
     </listitem>
    </itemizedlist>
@@ -405,7 +405,7 @@ Usage: php [options] [-f] <file> [--] [args...]
        <entry>--bindpath</entry>
        <entry>
         <para>
-         Lie le chemin pour les externes, en mode serveur FASTCGI
+         Chemin de liaison pour le mode serveur FASTCGI externe
          (<acronym>CGI</acronym> uniquement).
         </para>
        </entry>
@@ -540,8 +540,8 @@ string(15) "doesntmakesense"
        <entry>-h et -?</entry>
        <entry>--help et --usage</entry>
        <entry>
-        Affiche des informations sur la liste courante des options de la
-        ligne de commande, ainsi que leur description.
+        Affiche la liste des options de la ligne de commande,
+        avec une description sur une ligne de chacune d'elles.
        </entry>
       </row>
       <row>
@@ -735,9 +735,9 @@ array(370) {
         <para>
          Il y a deux variables spéciales de disponibles dans ce mode :
          <varname>$argn</varname> et <varname>$argi</varname>.
-         <varname>$argn</varname> doit contenir la ligne PHP
+         <varname>$argn</varname> contiendra la ligne PHP
          traitée à ce moment donné, tandis que
-         <varname>$argi</varname> doit contenir le numéro de la ligne.
+         <varname>$argi</varname> contiendra le numéro de la ligne.
         </para>
        </entry>
       </row>
@@ -755,7 +755,7 @@ array(370) {
        <entry>--process-end</entry>
        <entry>
         <para>
-         Code PHP à exécuter après avoir effectué l'entrée.
+         Code PHP à exécuter après le traitement de l'entrée.
         </para>
         <para>
          <example>
@@ -878,7 +878,7 @@ Additional .ini files parsed:      (none)
        <entry>
         <para>
          Affiche des informations sur la fonction donnée ou la méthode
-         d'une classe (c.-à-d. nombre et nom des paramètres).
+         d'une classe (par exemple le nombre et le nom des paramètres).
         </para>
         <para>
          Cette option n'est disponible que si PHP a été compilé avec le support
@@ -1003,7 +1003,7 @@ Extension [ <persistent> extension #19 json version 1.2.1 ] {
         <para>
          Affiche les informations de configuration pour l'extension donnée (les
          mêmes informations retournées par la fonction <function>phpinfo</function>).
-         Les informations de configurations internes
+         Les informations de configuration du cœur
          sont disponibles en utilisant le nom d'extension "main".
         </para>
         <para>
@@ -1034,7 +1034,7 @@ date.sunrise_zenith => 90.583333 => 90.583333
       </row>
      </tbody>
     </tgroup>
-   </table>   
+   </table>
   </para>
 
   <note>
@@ -1059,9 +1059,9 @@ date.sunrise_zenith => 90.583333 => 90.583333
      <informalexample>
       <screen>
 <![CDATA[
-php mon_script.php
+$ php mon_script.php
 
-php -f mon_script.php
+$ php -f mon_script.php
 ]]>
       </screen>
      </informalexample>
@@ -1080,12 +1080,12 @@ php -f mon_script.php
      <informalexample>
       <screen>
 <![CDATA[
-php -r 'print_r(get_defined_constants());'
+$ php -r 'print_r(get_defined_constants());'
 ]]>
       </screen>
      </informalexample>
      <para>
-      Une attention particulière doit alors être apportée aux variables d'environnement,
+      Une attention particulière doit alors être apportée aux variables du shell,
       qui seront remplacées, et aux guillemets, qui ont des significations spéciales en
       ligne de commande.
      </para>
@@ -1129,7 +1129,7 @@ $ some_application | some_filter | php | sort -u > final_output.txt
    index (zéro) contient toujours le nom du script appelé depuis la ligne
    de commande. Il est à noter que, si le code est exécuté en ligne en utilisant
    l'option de ligne de commande <option>-r</option>, la valeur de <varname>$argv[0]</varname>
-   sera <literal>"Standard input code"</literal>; antérieur à PHP 7.2.0,
+   sera <literal>"Standard input code"</literal> ; antérieur à PHP 7.2.0,
    c'était un tiret (<literal>"-"</literal>) à la place. Cela est aussi vrai si
    le code est exécuté via un pipe depuis <constant>STDIN</constant>.
   </para>
@@ -1170,7 +1170,7 @@ array(2) {
    </screen>
   </informalexample>
   <para>
-   Cependant, il y a une autre méthode pour utiliser PHP en script shell ;
+   Cependant, sur les systèmes Unix, il existe une autre méthode pour utiliser PHP en script shell :
    la première ligne du script devra être <literal>#!/usr/bin/php</literal>
    (à remplacer par le chemin vers le binaire PHP &cli; sur le système sous-jacent).
    Le reste du fichier doit contenir le code PHP normal, compris entre les
@@ -1435,7 +1435,7 @@ php -r 'fwrite(STDERR, "stderr\n");'
  </section>
 
  <section xml:id="features.commandline.interactive">
-  <title>Shell Interactif</title>
+  <title>Shell interactif</title>
 
   <para>
    Le &cli.sapi; fournit un shell interactif lors de l'utilisation
@@ -1474,8 +1474,6 @@ php >
    Le shell interactif fournit également une autocomplétion des fonctions,
    des constantes, des noms de classes, des variables, des appels aux méthodes
    statiques et des constantes de classes en utilisant la touche de tabulation.
-   À partir de PHP 8.4.0, le chemin vers le fichier d'historique peut être défini en utilisant la
-   variable d'environnement <envar>PHP_HISTFILE</envar>.
   </para>
 
   <example>
@@ -1513,8 +1511,10 @@ php > $foo[TAB]ThisIsAReallyLongVariableName
   </example>
 
   <simpara>
-   Le shell interactif stocke l'historique et peut y accéder en utilisant les touches
+   Le shell interactif stocke l'historique, auquel il est possible d'accéder en utilisant les touches
    haut et bas. L'historique est sauvegardé dans le fichier <filename>~/.php_history</filename>.
+   À partir de PHP 8.4.0, le chemin vers le fichier d'historique peut être défini en utilisant la
+   variable d'environnement <envar>PHP_HISTFILE</envar>.
   </simpara>
 
   <para>
@@ -1523,7 +1523,7 @@ php > $foo[TAB]ThisIsAReallyLongVariableName
    La directive <parameter>cli.pager</parameter> permet la définition d'un programme
    externe (comme <filename>less</filename>) à utiliser comme pager pour la sortie
    au lieu d'afficher directement sur l'écran. La directive
-   <parameter>cli.prompt</parameter> autorise la modification du prompte
+   <parameter>cli.prompt</parameter> autorise la modification du prompt
    <literal>php &gt;</literal>.
   </para>
 
@@ -1545,7 +1545,7 @@ hello world :>
    </programlisting>
    <simpara>
     En utilisant des backticks, il est possible d'exécuter du code PHP
-    dans le prompte :
+    dans le prompt :
    </simpara>
    <programlisting role="shell">
 <![CDATA[
@@ -1584,7 +1584,7 @@ php >
       <row>
        <entry><literal>\e</literal></entry>
        <entry>
-        utilisé pour ajouter des couleurs au prompte. Exemple :
+        utilisé pour ajouter des couleurs au prompt. Exemple :
         <literal>\e[032m\v \e[031m\b \e[34m\> \e[0m</literal>
        </entry>
       </row>
@@ -1597,16 +1597,16 @@ php >
        <entry>
         Indique dans quel bloc de PHP nous nous trouvons.
         Par exemple, <literal>/*</literal> permet d'indiquer que nous
-        sommes dans un commentaire multilignes. Le scope externe est représenté
+        sommes dans un commentaire multilignes. La portée externe est représentée
         par <literal>php</literal>.
        </entry>
       </row>
       <row>
        <entry><literal>\&gt;</literal></entry>
        <entry>
-        Indique le caractère utilisé pour le prompte. Par défaut, ce sera
+        Indique le caractère utilisé pour le prompt. Par défaut, ce sera
         <literal>&gt;</literal>, mais peut être modifié lorsque le shell se
-        trouve dans un bloc indéterminé ou dans une chaîne de caractères.
+        trouve dans un bloc non terminé ou dans une chaîne de caractères non terminée.
         Les caractères possibles sont : <literal>' " {
         ( &gt;</literal>
        </entry>
@@ -1621,16 +1621,16 @@ 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 - c.-à-d. les fonctions
+    dans ce mode, mais avec quelques restrictions - par exemple, les fonctions
     doivent avoir été définies avant l'appel.
    </para>
   </note>
 
   <section xml:id="features.commandline.interactive.mode">
    <title>Mode interactif</title>
    <para>
-    Si l'extension readline n'est pas disponible, antérieur à PHP 8.1.0,
-    invoquer le &cli.sapi; avec l'option <option>-a</option> fournit le mode interactif.
+    Antérieur à PHP 8.1.0, si l'extension readline n'était pas disponible,
+    invoquer le &cli.sapi; avec l'option <option>-a</option> fournissait le mode interactif.
     Dans ce mode, un script PHP complet est supposé être donné via STDIN,
     et après l'interruption
     avec
@@ -1644,11 +1644,11 @@ php >
      <keycap>Z</keycap>
     </keycombo>
     suivi de <keycap>ENTER</keycap> (Windows), ce script sera évalué.
-    Ceci est basiquement identique à invoquer le &cli.sapi; sans l'option <option>-a</option>.
+    Ceci est essentiellement identique à invoquer le &cli.sapi; sans l'option <option>-a</option>.
    </para>
    <para>
     À partir de PHP 8.1.0, invoquer le &cli.sapi; avec l'option <option>-a</option>
-    échoue, si l'extension readline n'est pas disponible.
+    échoue si l'extension readline n'est pas disponible.
    </para>
   </section>
  </section>
@@ -1661,7 +1661,7 @@ php >
     Ce serveur web est prévu pour aider dans le développement des applications.
     Il peut également être utile pour les tests, et pour les démonstrations
     d'applications qui sont exécutées dans des environnements contrôlés.
-    Mais par contre, il n'a pas été conçu pour être un serveur web complet.
+    Cependant, il n'a pas été conçu pour être un serveur web complet.
     Aussi, il ne devrait pas être utilisé dans un réseau public.
    </para>
   </warning>
@@ -1707,7 +1707,7 @@ php >
   </para>
 
   <para>
-   Les types MIME standards sont retournés pour les fichiers avec les extensions : 
+   Les types MIME standards sont retournés pour les fichiers avec les extensions :
    <simplelist type="inline">
     <member><literal>.3gp</literal></member>
     <member><literal>.apk</literal></member>
@@ -1767,15 +1767,15 @@ php >
   </para>
 
   <simpara>
-   À partir de PHP 7.4.0, le serveur web intégré peut être configuré pour bifurquer plusieurs
-   travailleurs afin de tester du code nécessitant plusieurs requêtes concurrentes
+   À partir de PHP 7.4.0, le serveur web intégré peut être configuré pour créer (fork) plusieurs
+   processus de travail afin de tester du code nécessitant plusieurs requêtes concurrentes
    au serveur web intégré.
    Définissez la variable d'environnement <envar>PHP_CLI_SERVER_WORKERS</envar> sur le
-   nombre de travailleurs souhaité avant de démarrer le serveur.
+   nombre de processus de travail souhaité avant de démarrer le serveur.
   </simpara>
   <note>
    <simpara>
-    Les processus de travail multiples ne sont pas pris en charge sur Windows.
+    Les processus de travail multiples ne sont pas supportés sur Windows.
    </simpara>
   </note>
   <note>
@@ -1788,7 +1788,7 @@ php >
   <warning>
    <para>
     Cette fonctionnalité <emphasis>expérimentale</emphasis> n'est <emphasis>pas</emphasis>
-    destinée à une utilisation en production. En général, le Serveur Web intégré
+    destinée à une utilisation en production. En général, le serveur web intégré
     n'est <emphasis>pas</emphasis> destiné à une utilisation en production.
    </para>
   </warning>
@@ -1886,7 +1886,7 @@ $ php -S localhost:8000 router.php
   <example>
    <title>Vérification de l'utilisation CLI du serveur Web</title>
    <para>
-    Pour ré-utiliser un script router du framework lors du
+    Pour réutiliser un script de routage du framework lors du
     développement avec le CLI du serveur web et ensuite, continuer
     de l'utiliser avec un serveur web de production :
    </para>
@@ -1895,7 +1895,7 @@ $ php -S localhost:8000 router.php
 <?php
 // router.php
 if (php_sapi_name() == 'cli-server') {
-    /* Activation de la route statique et retourne FALSE */
+    /* router les ressources statiques et retourner FALSE */
 }
 /* on continue avec les opérations d'un index.php normal */
 ?>]]>

features/connection-handling.xml

@@ -1,6 +1,5 @@
 <?xml version="1.0" encoding="utf-8"?>
-<!-- $Revision$ -->
-<!-- EN-Revision: dc0f955be2a10b707ae06f7da69f52fab24df3d1 Maintainer: yannick Status: ready -->
+<!-- EN-Revision: 5e6ca803fc284739a7b1e7fba58b6b8466d5006f Maintainer: yannick Status: ready -->
 <!-- Reviewed: no -->
 
 <chapter xml:id="features.connection-handling" xmlns="http://docbook.org/ns/docbook">
@@ -20,7 +19,7 @@
   Si le client distant se déconnecte, le statut devient ABORTED.
   Une déconnexion du client distant est généralement causée par les utilisateurs
   appuyant sur leur bouton STOP. Si la durée maximale d'exécution de PHP est
-  dépassée, (voir <function>set_time_limit</function>), le script prend le
+  dépassée (voir <function>set_time_limit</function>), le script prend le
   statut TIMEOUT.
  </simpara>
  <simpara>
@@ -40,9 +39,9 @@
   seule exception est si une fonction de fermeture a été enregistrée,
   avec <function>register_shutdown_function</function>.
   Avec une telle fonction, lorsque l'utilisateur interrompt sa
-  requête, à la prochaine exécution du script,
-  PHP va s'apercevoir que le dernier script n'a pas été
-  terminé, et il va déclencher la fonction de fermeture.
+  requête, à la prochaine tentative d'affichage du script,
+  PHP va s'apercevoir que la connexion a été
+  annulée, et il va déclencher la fonction de fermeture.
   Cette fonction sera aussi appelée à la fin du script,
   si celui-ci se termine normalement. Pour pouvoir avoir un comportement
   différent suivant l'état du script lors de sa finalisation,