From d631deb91cb8fc9288dd91e1b34288ac19ef4da1 Mon Sep 17 00:00:00 2001 From: lacatoire Date: Tue, 25 Aug 2026 09:41:11 +0200 Subject: [PATCH] [Sync-En] info: fix assert/dl/getrusage return docs and E_ALL value MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - assert.xml: use simpara, update return values, fix classname→exceptionname - dl.xml: E_ERROR→E_WARNING, update return value description - get-defined-constants.xml: E_ALL 2047→30719 - getrusage.xml: update RUSAGE_CHILDREN note wording --- reference/info/functions/assert.xml | 90 +++++++++---------- reference/info/functions/dl.xml | 16 ++-- .../info/functions/get-defined-constants.xml | 8 +- reference/info/functions/getrusage.xml | 11 +-- 4 files changed, 57 insertions(+), 68 deletions(-) diff --git a/reference/info/functions/assert.xml b/reference/info/functions/assert.xml index 60d46f5310..a2b180b8d5 100644 --- a/reference/info/functions/assert.xml +++ b/reference/info/functions/assert.xml @@ -1,6 +1,5 @@ - - + assert @@ -14,32 +13,32 @@ mixedassertion Throwablestringnulldescription&null; - + assert permet de définir des attentes : des assertions qui prennent effet dans les environnements de développement et de test, mais qui sont optimisées pour ne pas avoir de coût en production. - - + + Les assertions peuvent être utilisées pour aider au débogage. Un cas d'utilisation pour les assertions est de servir de vérifications de cohérence pour des préconditions qui devraient toujours être &true;, et si elles ne sont pas respectées, cela indique des erreurs de programmation. Un autre cas d'utilisation est de garantir la présence de certaines fonctionnalités telles que des fonctions d'extension ou certaines limites et fonctionnalités du système. - - + + Comme les assertions peuvent être configurées pour être éliminées, elles ne doivent pas être utilisées pour des opérations normales en cours d'exécution, telles que des vérifications des paramètres d'entrée. En règle générale, le code doit se comporter comme prévu même si la vérification des assertions est désactivée. - - + + assert vérifiera que l'attente donnée dans assertion est satisfaite. Si ce n'est pas le cas et donc que le résultat est &false;, elle prendra l'action appropriée en fonction de la configuration de assert. - + Le comportement de assert est dicté par les paramètres INI suivants : @@ -120,7 +119,7 @@ assert.exception&true; - Si &true;, lancera une AssertionError si l'attente n'est pas respectée. + Si &true;, lancera une AssertionError si l'attente n'est pas respectée. Déprécié à partir de PHP 8.3.0. @@ -162,20 +161,20 @@ assertion - + Ceci est une expression quelconque qui retourne une valeur, qui sera exécutée et dont le résultat sera utilisé pour indiquer si l'assertion a réussi ou échoué. - + - + Antérieur à PHP 8.0.0, si assertion était une string, elle était interprétée comme du code PHP et exécutée via eval. Cette chaîne était transmise à la fonction de rappel en tant que troisième argument. Ce comportement était OBSOLÈTE dans PHP 7.2.0, et est SUPPRIMÉ à partir de PHP 8.0.0 - + @@ -184,40 +183,40 @@ Si description est une instance de - Throwable, elle sera lancée uniquement si + Throwable, elle sera lancée uniquement si assertion est exécutée et échoue. - + À partir de PHP 8.0.0, cela est fait avant d'appeler la fonction de rappel d'assertion éventuellement définie - + - + À partir de PHP 8.0.0, l'objet &object; sera lancé indépendamment de la configuration de assert.exception. - + - + À partir de PHP 8.0.0, le paramètre assert.bail n'a aucun effet dans ce cas. - + - + Si description est une &string;, ce message sera utilisé si une exception ou un avertissement est émis. Une description optionnelle, qui sera incluse dans le message d'échec si l'assertion échoue. - - + + Si description est omis. Une description par défaut équivalente au code source de l'appel de assert est créée au moment de la compilation. - + @@ -226,21 +225,18 @@ &reftitle.returnvalues; - + assert renverra toujours &true; si au moins l'une des conditions suivantes est vraie : - + zend.assertions=0 zend.assertions=-1 assert.active=0 - assert.exception=1 - assert.bail=1 - Un objet d'exception personnalisé est passé à description. - + Si aucune des conditions n'est vraie, assert renverra &true; si assertion est vrai, et &false; sinon. - + @@ -275,7 +271,7 @@ 8.0.0 Si description est une instance de - Throwable, l'objet est lancé si l'assertion échoue, indépendamment de la valeur de + Throwable, l'objet est lancé si l'assertion échoue, indépendamment de la valeur de assert.exception. @@ -283,7 +279,7 @@ 8.0.0 Si description est une instance de - Throwable, aucune fonction de rappel utilisateur + Throwable, aucune fonction de rappel utilisateur n'est appelée même si elle est définie. @@ -332,10 +328,10 @@ echo 'Hi!'; ?> ]]> - + Si les assertions sont activées (zend.assertions=1) l'exemple ci-dessus afficherait : - + 2) in example.php:2 @@ -345,10 +341,10 @@ Stack trace: thrown in example.php on line 2 ]]> - + Si les assertions sont désactivées (zend.assertions=0 ou zend.assertions=-1) l'exemple ci-dessus afficherait : - + ]]> - + Si les assertions sont activées, l'exemple ci-dessus afficherait : - + - + Si les assertions sont désactivées, l'exemple ci-dessus afficherait : - + - + Si les assertions sont activées, l'exemple ci-dessus afficherait : - + - + Si les assertions sont désactivées, l'exemple ci-dessus affichera : - + - - - + dl @@ -95,16 +93,16 @@ &reftitle.returnvalues; - + &return.success; Si la fonctionnalité de chargement de module n'est pas disponible, ou a été désactivée (en désactivant la directive enable_dl - dans le &php.ini;) une E_ERROR sera émise et - l'exécution du script sera stoppée. Si la fonction + dans le &php.ini;) une E_WARNING sera émise et + &false; sera retourné. Si la fonction dl échoue parce que la bibliothèque n'a pu être - trouvée, dl retourne &false; et émet un - message d'alerte E_WARNING. - + trouvée, en plus de &false; un message d'alerte E_WARNING + sera émis. + diff --git a/reference/info/functions/get-defined-constants.xml b/reference/info/functions/get-defined-constants.xml index 5a76658d2b..660949ae4e 100644 --- a/reference/info/functions/get-defined-constants.xml +++ b/reference/info/functions/get-defined-constants.xml @@ -1,7 +1,5 @@ - - - + @@ -60,7 +58,7 @@ Array [E_USER_ERROR] => 256 [E_USER_WARNING] => 512 [E_USER_NOTICE] => 1024 - [E_ALL] => 2047 + [E_ALL] => 30719 [TRUE] => 1 ) @@ -128,7 +126,7 @@ Array [E_USER_ERROR] => 256 [E_USER_WARNING] => 512 [E_USER_NOTICE] => 1024 - [E_ALL] => 2047 + [E_ALL] => 30719 [TRUE] => 1 ) ]]> diff --git a/reference/info/functions/getrusage.xml b/reference/info/functions/getrusage.xml index 20228ddaa3..35b2259897 100644 --- a/reference/info/functions/getrusage.xml +++ b/reference/info/functions/getrusage.xml @@ -1,7 +1,5 @@ - - - + getrusage @@ -105,12 +103,11 @@ echo $dat["ru_stime.tv_sec"]; // temps système utilisé (en secondes) - + Si getrusage est appelé avec le paramètre mode valant 1 (RUSAGE_CHILDREN), alors l'utilisation - de la ressource pour les threads est collectée (ce qui signifie que, en interne, - la fonction est appelée avec RUSAGE_THREAD). - + de la ressource pour les processus enfants est collectée. +