From e610e6d6d660f05bc503797e0b5982c1a726af09 Mon Sep 17 00:00:00 2001 From: lacatoire Date: Thu, 1 Oct 2026 08:59:22 +0200 Subject: [PATCH] [Sync-En] features: fix typos and grammar --- features/commandline.xml | 90 ++++++++++++++++---------------- features/connection-handling.xml | 11 ++-- features/cookies.xml | 14 +++-- features/dtrace.xml | 16 +++--- features/file-upload.xml | 24 ++++----- features/gc.xml | 17 +++--- features/http-auth.xml | 6 +-- 7 files changed, 85 insertions(+), 93 deletions(-) diff --git a/features/commandline.xml b/features/commandline.xml index a52d7884d4..e27bee5188 100755 --- a/features/commandline.xml +++ b/features/commandline.xml @@ -1,5 +1,5 @@ - + Utiliser PHP en ligne de commande @@ -88,7 +88,7 @@ Les différences les plus notables entre le &cli; SAPI et les - SAPI sont : + autres SAPI sont : @@ -137,7 +137,7 @@ 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 HTML - non-interprétées. + non interprétées. @@ -224,7 +224,7 @@ if (php_sapi_name() === 'cli') { &false; - 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. @@ -313,11 +313,11 @@ $ php -f autre_dossier/test.php - + Le CGI SAPI se comporte de la même façon que le &cli.sapi;, en lui passant l'option , lorsqu'il est invoqué en ligne de commande. - + @@ -405,7 +405,7 @@ Usage: php [options] [-f] [--] [args...] --bindpath - Lie le chemin pour les externes, en mode serveur FASTCGI + Chemin de liaison pour le mode serveur FASTCGI externe (CGI uniquement). @@ -540,8 +540,8 @@ string(15) "doesntmakesense" -h et -? --help et --usage - 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. @@ -735,9 +735,9 @@ array(370) { Il y a deux variables spéciales de disponibles dans ce mode : $argn et $argi. - $argn doit contenir la ligne PHP + $argn contiendra la ligne PHP traitée à ce moment donné, tandis que - $argi doit contenir le numéro de la ligne. + $argi contiendra le numéro de la ligne. @@ -755,7 +755,7 @@ array(370) { --process-end - Code PHP à exécuter après avoir effectué l'entrée. + Code PHP à exécuter après le traitement de l'entrée. @@ -878,7 +878,7 @@ Additional .ini files parsed: (none) 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). Cette option n'est disponible que si PHP a été compilé avec le support @@ -1003,7 +1003,7 @@ Extension [ extension #19 json version 1.2.1 ] { Affiche les informations de configuration pour l'extension donnée (les mêmes informations retournées par la fonction phpinfo). - Les informations de configurations internes + Les informations de configuration du cœur sont disponibles en utilisant le nom d'extension "main". @@ -1034,7 +1034,7 @@ date.sunrise_zenith => 90.583333 => 90.583333 - + @@ -1059,9 +1059,9 @@ date.sunrise_zenith => 90.583333 => 90.583333 @@ -1080,12 +1080,12 @@ php -f mon_script.php - 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. @@ -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 , la valeur de $argv[0] - sera "Standard input code"; antérieur à PHP 7.2.0, + sera "Standard input code" ; antérieur à PHP 7.2.0, c'était un tiret ("-") à la place. Cela est aussi vrai si le code est exécuté via un pipe depuis STDIN. @@ -1170,7 +1170,7 @@ array(2) { - 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 #!/usr/bin/php (à 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");'
- Shell Interactif + Shell interactif 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 PHP_HISTFILE. @@ -1513,8 +1511,10 @@ php > $foo[TAB]ThisIsAReallyLongVariableName - 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 ~/.php_history. + À partir de PHP 8.4.0, le chemin vers le fichier d'historique peut être défini en utilisant la + variable d'environnement PHP_HISTFILE. @@ -1523,7 +1523,7 @@ php > $foo[TAB]ThisIsAReallyLongVariableName La directive cli.pager permet la définition d'un programme externe (comme less) à utiliser comme pager pour la sortie au lieu d'afficher directement sur l'écran. La directive - cli.prompt autorise la modification du prompte + cli.prompt autorise la modification du prompt php >. @@ -1545,7 +1545,7 @@ hello world :> En utilisant des backticks, il est possible d'exécuter du code PHP - dans le prompte : + dans le prompt : \e - utilisé pour ajouter des couleurs au prompte. Exemple : + utilisé pour ajouter des couleurs au prompt. Exemple : \e[032m\v \e[031m\b \e[34m\> \e[0m @@ -1597,16 +1597,16 @@ php > Indique dans quel bloc de PHP nous nous trouvons. Par exemple, /* 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 php. \> - 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 >, 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 : ' " { ( > @@ -1621,7 +1621,7 @@ php > Les fichiers inclus via auto_prepend_file et auto_append_file 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. @@ -1629,8 +1629,8 @@ php >
Mode interactif - Si l'extension readline n'est pas disponible, antérieur à PHP 8.1.0, - invoquer le &cli.sapi; avec l'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 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 > Z suivi de ENTER (Windows), ce script sera évalué. - Ceci est basiquement identique à invoquer le &cli.sapi; sans l'option . + Ceci est essentiellement identique à invoquer le &cli.sapi; sans l'option . À partir de PHP 8.1.0, invoquer le &cli.sapi; avec l'option - échoue, si l'extension readline n'est pas disponible. + échoue si l'extension readline n'est pas disponible.
@@ -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. @@ -1707,7 +1707,7 @@ php > - 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 : .3gp .apk @@ -1767,15 +1767,15 @@ php > - À 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 PHP_CLI_SERVER_WORKERS sur le - nombre de travailleurs souhaité avant de démarrer le serveur. + nombre de processus de travail souhaité avant de démarrer le serveur. - 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. @@ -1788,7 +1788,7 @@ php > Cette fonctionnalité expérimentale n'est pas - 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 pas destiné à une utilisation en production. @@ -1886,7 +1886,7 @@ $ php -S localhost:8000 router.php Vérification de l'utilisation CLI du serveur Web - 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 : @@ -1895,7 +1895,7 @@ $ php -S localhost:8000 router.php ]]> diff --git a/features/connection-handling.xml b/features/connection-handling.xml index 43eb4b6b44..dd0269d21e 100644 --- a/features/connection-handling.xml +++ b/features/connection-handling.xml @@ -1,6 +1,5 @@ - - + @@ -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 set_time_limit), le script prend le + dépassée (voir set_time_limit), le script prend le statut TIMEOUT. @@ -40,9 +39,9 @@ seule exception est si une fonction de fermeture a été enregistrée, avec register_shutdown_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, diff --git a/features/cookies.xml b/features/cookies.xml index 84dddd89dc..eee6d89e67 100644 --- a/features/cookies.xml +++ b/features/cookies.xml @@ -1,7 +1,5 @@ - - - + Cookies @@ -19,20 +17,20 @@ tant que l'envoi d'un cookie ou d'en-têtes n'a pas été décidé. - + Tous les cookies envoyés au serveur par le client seront automatiquement inclus dans un tableau auto-global $_COOKIE si variables_order contient "C". + linkend="ini.variables-order">variables_order contient "C". Pour affecter plusieurs valeurs à un seul cookie, il suffit d'ajouter [] au nom du cookie. - + - + Pour plus de détails, y compris des notes sur les bogues des navigateurs, voir les fonctions setcookie et setrawcookie. - + + DTrace Traçage dynamique @@ -45,7 +45,7 @@ - Les sondes DTrace statiques dans PHP peuvent alternativement être utilisées avec la fonction + Les sondes DTrace statiques dans PHP peuvent alternativement être utilisées avec la fonctionnalité SystemTap sur certaines distributions Linux. @@ -80,7 +80,7 @@ - Construire PHP avec le paramètre de configuration --enable-dtrace: + Construire PHP avec le paramètre de configuration --enable-dtrace : - + Pour activer les sondes, définissez la variable d'environnement pour les processus PHP ciblés. - + Sondes statiques DTrace dans le cœur de PHP Les sondes statiques suivantes sont disponibles dans PHP - + Nom de la sonde @@ -365,7 +365,7 @@ php*:::request-startup Lorsque la surveillance est terminée, le script D peut être interrompu par une commande - CTRLC + CTRLC. @@ -434,7 +434,7 @@ php*:::function-entry Liste des sondes statiques avec SystemTap - Les sondes statiques dans PHP peuvent être listées en utilisant stap: + Les sondes statiques dans PHP peuvent être listées en utilisant stap : - + @@ -90,9 +90,9 @@ La variable globale $_FILES va contenir toutes les informations sur le fichier téléchargé. Son contenu est détaillé - dans notre exemple ci-dessous. Il est à noter que l'on suppose que le nom + dans l'exemple du formulaire ci-dessus. Il est à noter que l'on suppose que le nom de la variable du fichier téléchargé est userfile, tel que - défini dans le formulaire ci-dessus, mais peut être n'importe quel nom. + défini dans le script ci-dessus, mais il peut s'agir de n'importe quel nom. $_FILES['userfile']['name'] @@ -105,12 +105,12 @@ $_FILES['userfile']['type'] - + Le type MIME du fichier, si le navigateur a fourni cette information. Par exemple, cela pourra être "image/gif". Ce type mime n'est cependant pas vérifié du côté de PHP et, donc, sa valeur ne doit pas être considérée comme acquise. - + @@ -176,11 +176,9 @@ $uploadfile = $uploaddir . basename($_FILES['userfile']['name']); echo '
';
 if (move_uploaded_file($_FILES['userfile']['tmp_name'], $uploadfile)) {
-    echo "Le fichier est valide, et a été téléchargé
-           avec succès. Voici plus d'informations :\n";
+    echo "Le fichier est valide, et a été téléchargé avec succès.\n";
 } else {
-    echo "Attaque potentielle par téléchargement de fichiers.
-          Voici plus d'informations :\n";
+    echo "Attaque potentielle par téléchargement de fichiers !\n";
 }
 
 echo 'Voici quelques informations de débogage :';
@@ -220,8 +218,8 @@ echo '
'; Envoi d'un tableau de fichiers - PHP supporte les tableaux en HTML - ainsi qu'avec les fichiers. + PHP supporte les tableaux en HTML, + même avec les fichiers. - Normalement, cela signifie que le client distant souhaite sauver + Normalement, cela signifie que le client distant souhaite enregistrer les données qui suivent dans le fichier : /path/filename.html de l'arborescence web. Ce n'est évidemment pas très sécurisé de laisser Apache ou PHP écraser n'importe @@ -492,7 +490,7 @@ Script PUT /put.php de chargement par méthode PUT au script put.php. Bien entendu, cela présuppose que PHP a été activé pour qu'il - prenne en charge les fichiers de type .php, + supporte les fichiers de type .php, et que PHP est actif. La ressource de destination pour toutes les requêtes PUT de ce script doit être le script lui-même, et non le nom du fichier que le fichier téléchargé doit avoir. diff --git a/features/gc.xml b/features/gc.xml index eaf417ae8d..8d75b97ed1 100644 --- a/features/gc.xml +++ b/features/gc.xml @@ -1,6 +1,5 @@ - - + Ramasse-miettes (Garbage Collection) @@ -101,7 +100,7 @@ a: (refcount=2, is_ref=0)='new string' Les conteneurs sont détruits lorsque leur "refcount" atteint zéro. Le "refcount" est décrémenté de un lorsque n'importe quel symbole lié à un conteneur sort du scope (ex. : lorsque la fonction se termine) ou - lorsqu'un symbole est déalloué (ex. : par l'appel de unset). + lorsqu'un symbole est désalloué (ex. : par l'appel de unset). L'exemple qui suit le démontre : @@ -346,13 +345,13 @@ a: (refcount=2, is_ref=1)=array ( Nettoyage de Cycles - + Traditionnellement, les mécanismes de comptage de références, comme utilisés auparavant dans PHP, ne savent pas gérer les fuites mémoires dues à des références circulaires ; - cependant à partir de PHP 5.3.0, un algorithme synchrone issu de l'analyse + cependant à partir de PHP 5.3.0, un algorithme synchrone issu de l'article Concurrent Cycle Collection in Reference Counted Systems est utilisé pour répondre à ce problème particulier. - + Une explication complète du fonctionnement de l'algorithme irait un peu au-delà du cadre de cette section, mais nous allons ici présenter les principes de base. Avant tout, nous allons établir quelques règles de base. @@ -401,8 +400,8 @@ a: (refcount=2, is_ref=1)=array ( décrit ci-dessus est exécuté à chaque fois que le tampon est plein. Le tampon de racines a une taille fixée à 10.000 racines (ce paramètre est changeable grâce à GC_THRESHOLD_DEFAULT dans Zend/zend_gc.c - dans le code source de PHP, une recompilation est donc nécessaire). Si le ramasse- - miettes est désactivé, la recherche des cycles l'est aussi. Cependant, les racines + dans le code source de PHP, une recompilation est donc nécessaire). Si le ramasse-miettes + est désactivé, la recherche des cycles l'est aussi. Cependant, les racines possibles seront toujours enregistrées dans le tampon, ceci ne dépend pas de l'activation du ramasse-miettes. @@ -557,7 +556,7 @@ echo memory_get_peak_usage(), "\n"; Nous allons lancer ce script 2 fois, une fois avec - zend.enable_gc à on, et une fois à off: + zend.enable_gc à on, et une fois à off : diff --git a/features/http-auth.xml b/features/http-auth.xml index b5529568f8..95a76a8735 100644 --- a/features/http-auth.xml +++ b/features/http-auth.xml @@ -1,7 +1,5 @@ - - - + Identification HTTP avec PHP @@ -15,7 +13,7 @@ appelée, avec les variables prédéfinies PHP_AUTH_USER, PHP_AUTH_PW et AUTH_TYPE contenant respectivement le nom d'utilisateur, le mot de passe et - le type d'identification. Ces variables prédéfinies sont trouvées dans les tableaux + le type d'identification. Ces variables prédéfinies sont trouvées dans le tableau $_SERVER. Seule la méthode d'identification simple ("Basic") est supportée. Se reporter à la fonction