From 6056592a4b59c0e087d0182b67c9f08d77920b03 Mon Sep 17 00:00:00 2001 From: lacatoire Date: Thu, 9 Jul 2026 20:23:13 +0200 Subject: [PATCH 1/2] =?UTF-8?q?Utiliser=20les=20entit=C3=A9s=20&true;/&fal?= =?UTF-8?q?se;/&null;=20pour=20les=20constantes=20bool=C3=A9ennes/null=20(?= =?UTF-8?q?#5641)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- language/control-structures/include.xml | 4 +--- language/enumerations.xml | 5 ++--- language/oop5/overloading.xml | 5 ++--- language/predefined/weakreference.xml | 5 ++--- language/types/array.xml | 5 ++--- language/types/declarations.xml | 9 ++++----- .../datetime/dateinterval/createfromdatestring.xml | 3 +-- reference/datetime/datetime/modify.xml | 3 +-- reference/datetime/datetimeimmutable/modify.xml | 3 +-- reference/filter/constants.xml | 6 +++--- reference/info/functions/ini-get.xml | 8 +++----- reference/intl/ini.xml | 10 ++++------ reference/mbstring/functions/mb-strcut.xml | 10 ++++------ reference/mbstring/functions/mb-substr.xml | 10 ++++------ reference/pdo/constants.fetch-modes.xml | 5 ++--- reference/pdo/pdo/getattribute.xml | 7 +++---- .../reflection/reflectionenum/getbackingtype.xml | 13 ++++++------- reference/swoole/swoole/coroutine/lock/lock.xml | 7 +++---- reference/swoole/swoole/coroutine/lock/trylock.xml | 7 +++---- reference/swoole/swoole/coroutine/lock/unlock.xml | 7 +++---- .../win32service/rightinfo/get-full-username.xml | 9 ++++----- 21 files changed, 58 insertions(+), 83 deletions(-) diff --git a/language/control-structures/include.xml b/language/control-structures/include.xml index 6d46daa280..0d0760d607 100644 --- a/language/control-structures/include.xml +++ b/language/control-structures/include.xml @@ -1,7 +1,5 @@ - - - + include diff --git a/language/enumerations.xml b/language/enumerations.xml index 7452394ff5..259448730c 100644 --- a/language/enumerations.xml +++ b/language/enumerations.xml @@ -1,6 +1,5 @@ - - + Les énumérations @@ -295,7 +294,7 @@ $ref = &$suit->value; tryFrom(int|string): ?self prend un scalaire et renvoie le - cas d'Enum correspondant. S'il n'en trouve pas, il retournera null. + cas d'Enum correspondant. S'il n'en trouve pas, il retournera &null;. Ceci est principalement utile dans les cas où le scalaire en entrée n'est pas fiable et que l'appelant souhaite implémenter sa propre gestion d'erreur ou sa logique de valeur par défaut. diff --git a/language/oop5/overloading.xml b/language/oop5/overloading.xml index 387d072b48..47dfc92d8b 100644 --- a/language/oop5/overloading.xml +++ b/language/oop5/overloading.xml @@ -1,6 +1,5 @@ - - + Surcharge magique @@ -115,7 +114,7 @@ PHP n'appellera pas une méthode surchargée à partir de la même méthode surchargée. Cela signifie, par exemple, qu'écrire return $this->foo à l'intérieur - de __get() retournera null + de __get() retournera &null; et lèvera un E_WARNING s'il n'y a pas de propriété foo définie, plutôt que d'appeler __get() une deuxième fois. Toutefois, les méthodes de surcharge peuvent invoquer d'autres méthodes de surcharge de manière implicite diff --git a/language/predefined/weakreference.xml b/language/predefined/weakreference.xml index 0219e497ac..ff144cf5c0 100644 --- a/language/predefined/weakreference.xml +++ b/language/predefined/weakreference.xml @@ -1,6 +1,5 @@ - - + La classe WeakReference @@ -96,7 +95,7 @@ NULL 8.4.0 - La sortie de WeakReference::__debugInfo inclut désormais l'objet référencé, ou NULL si la référence n'est plus valide. + La sortie de WeakReference::__debugInfo inclut désormais l'objet référencé, ou &null; si la référence n'est plus valide. diff --git a/language/types/array.xml b/language/types/array.xml index 1c9e1ceb5c..7e5e65c9cb 100644 --- a/language/types/array.xml +++ b/language/types/array.xml @@ -1,6 +1,5 @@ - - + Les tableaux @@ -121,7 +120,7 @@ var_dump($array1, $array2); La valeur Null sera modifiée en une chaîne vide, c.-à-d. la clé - null sera stockée sous la chaîne de caractères "". + &null; sera stockée sous la chaîne de caractères "". diff --git a/language/types/declarations.xml b/language/types/declarations.xml index ae1251d61a..e016b292fd 100755 --- a/language/types/declarations.xml +++ b/language/types/declarations.xml @@ -1,6 +1,5 @@ - - + Déclarations de type @@ -314,14 +313,14 @@ Stack trace: - + Il est également possible d’obtenir des arguments nullable en faisant de - null la valeur par défaut. + &null; la valeur par défaut. Ceci n’est pas recommandé, car si la valeur par défaut est modifiée dans une classe enfant, une violation de compatibilité de type sera déclenchée car le type null devra être ajouté à la déclaration de type. Ce comportement est également déprécié à partir de PHP 8.4. - + Ancienne façon de rendre les arguments nullables diff --git a/reference/datetime/dateinterval/createfromdatestring.xml b/reference/datetime/dateinterval/createfromdatestring.xml index e98abe82f5..d90026298d 100644 --- a/reference/datetime/dateinterval/createfromdatestring.xml +++ b/reference/datetime/dateinterval/createfromdatestring.xml @@ -1,6 +1,5 @@ - - + DateInterval::createFromDateString diff --git a/reference/datetime/datetime/modify.xml b/reference/datetime/datetime/modify.xml index 0466ce8eef..9ef4af8174 100644 --- a/reference/datetime/datetime/modify.xml +++ b/reference/datetime/datetime/modify.xml @@ -1,6 +1,5 @@ - - + DateTime::modify diff --git a/reference/datetime/datetimeimmutable/modify.xml b/reference/datetime/datetimeimmutable/modify.xml index 4f94d26b97..5b7a48d3cc 100644 --- a/reference/datetime/datetimeimmutable/modify.xml +++ b/reference/datetime/datetimeimmutable/modify.xml @@ -1,6 +1,5 @@ - - + DateTimeImmutable::modify diff --git a/reference/filter/constants.xml b/reference/filter/constants.xml index 889b0adc61..518ef9b721 100644 --- a/reference/filter/constants.xml +++ b/reference/filter/constants.xml @@ -1,5 +1,5 @@ - + &reftitle.constants; &extension.constants; @@ -280,14 +280,14 @@ Retourne &true; pour "1", 1, y compris les notations binaire, octale et hexadécimale, 1.0, y compris la notation scientifique, - "true", true, + "true", &true;, "on", et "yes". Retourne &false; pour "0", 0, y compris les notations binaire, octale et hexadécimale, 0.0, y compris la notation scientifique, - "false", false, + "false", &false;, "off", "no", et "". diff --git a/reference/info/functions/ini-get.xml b/reference/info/functions/ini-get.xml index 188741d7a5..b96b0d14d9 100644 --- a/reference/info/functions/ini-get.xml +++ b/reference/info/functions/ini-get.xml @@ -1,7 +1,5 @@ - - - + @@ -39,12 +37,12 @@ &reftitle.returnvalues; - + Retourne la valeur de l'option de configuration option en cas de succès, ou une &string; vide pour les valeurs &null;. Retourne &false; si l'option de configuration n'existe pas. - + diff --git a/reference/intl/ini.xml b/reference/intl/ini.xml index f972f25024..3fac425565 100644 --- a/reference/intl/ini.xml +++ b/reference/intl/ini.xml @@ -1,7 +1,5 @@ - - - +
@@ -53,14 +51,14 @@ xmlns:xlink="http://www.w3.org/1999/xlink"> string - + La locale à utiliser avec les fonctions intl lorsqu'aucune n'est spécifiée (soit si elle est omise dans l'argument correspondant, - soit si la valeur passée vaut NULL). + soit si la valeur passée vaut &null;). Ce sont des locales ICU, et non des locales système. Les locales ICU internes ainsi que leurs données peuvent être explorées ici . - + Par défaut, vaut vide, ce qui force l'utilisation de la locale ICU par défaut. Une fois définie, la configuration ini ne peut être réinitialisée diff --git a/reference/mbstring/functions/mb-strcut.xml b/reference/mbstring/functions/mb-strcut.xml index da710be530..f3e3b4d489 100644 --- a/reference/mbstring/functions/mb-strcut.xml +++ b/reference/mbstring/functions/mb-strcut.xml @@ -1,7 +1,5 @@ - - - + mb_strcut @@ -65,11 +63,11 @@ length - + Longueur en octets. Si ce - paramètre est omis, ou vaut NULL, + paramètre est omis, ou vaut &null;, tous les octets jusqu'à la fin de la chaîne seront extraits. - + Si length est négatif, la chaîne retournée se finira à la position length en comptant diff --git a/reference/mbstring/functions/mb-substr.xml b/reference/mbstring/functions/mb-substr.xml index f9169d623a..a9c62bf411 100644 --- a/reference/mbstring/functions/mb-substr.xml +++ b/reference/mbstring/functions/mb-substr.xml @@ -1,7 +1,5 @@ - - - + mb_substr @@ -60,12 +58,12 @@ length - + Nombre maximal de caractères à utiliser depuis string. Si ce paramètre - est omis, ou vaut NULL, tous les + est omis, ou vaut &null;, tous les caractères jusqu'à la fin de la chaîne seront extraits. - + diff --git a/reference/pdo/constants.fetch-modes.xml b/reference/pdo/constants.fetch-modes.xml index dfe7b2cd82..a50bfbbafd 100644 --- a/reference/pdo/constants.fetch-modes.xml +++ b/reference/pdo/constants.fetch-modes.xml @@ -1,6 +1,5 @@ - - +
Modes de récupération @@ -1122,7 +1121,7 @@ object(TestEntity)#3 (4) { - PDORow renverra NULL sans + PDORow renverra &null; sans aucun avertissement ou erreur lors de l'accès à des propriétés ou des clés qui ne sont pas définies. Cela peut rendre des erreurs telles que des fautes de frappe ou des requêtes ne renvoyant pas les données attendues plus difficiles à repérer et à déboguer. diff --git a/reference/pdo/pdo/getattribute.xml b/reference/pdo/pdo/getattribute.xml index d693ada489..b15d6857a4 100755 --- a/reference/pdo/pdo/getattribute.xml +++ b/reference/pdo/pdo/getattribute.xml @@ -1,6 +1,5 @@ - - + PDO::getAttribute @@ -66,10 +65,10 @@ &reftitle.returnvalues; - + Un appel réussi retourne la valeur de l'attribut PDO demandé. Un appel qui a échoué retourne la valeur &null;. - + diff --git a/reference/reflection/reflectionenum/getbackingtype.xml b/reference/reflection/reflectionenum/getbackingtype.xml index 9a1b3984ba..9b60e4ba2f 100644 --- a/reference/reflection/reflectionenum/getbackingtype.xml +++ b/reference/reflection/reflectionenum/getbackingtype.xml @@ -1,6 +1,5 @@ - - + ReflectionEnum::getBackingType @@ -13,11 +12,11 @@ public ReflectionNamedTypenullReflectionEnum::getBackingType - + Si l'énumération est une énumération avec valeur de base, cette méthode renverra une instance de ReflectionType pour le type de base de l'énumération. Si ce n'est pas une énumération avec valeur de base, elle renverra &null;. - + @@ -28,10 +27,10 @@ &reftitle.returnvalues; - + Une instance de ReflectionNamedType, ou &null; - si l'énumération n'a pas de type de base. - + si l'énumération n'a pas de type de base. + diff --git a/reference/swoole/swoole/coroutine/lock/lock.xml b/reference/swoole/swoole/coroutine/lock/lock.xml index c4e616b412..af82835cc6 100644 --- a/reference/swoole/swoole/coroutine/lock/lock.xml +++ b/reference/swoole/swoole/coroutine/lock/lock.xml @@ -1,6 +1,5 @@ - - + @@ -29,10 +28,10 @@ &reftitle.returnvalues; - + Renvoie &true; si le verrou a été acquis avec succès, sinon &false;. - + diff --git a/reference/swoole/swoole/coroutine/lock/trylock.xml b/reference/swoole/swoole/coroutine/lock/trylock.xml index f1955e4bf7..fb2d1047cc 100644 --- a/reference/swoole/swoole/coroutine/lock/trylock.xml +++ b/reference/swoole/swoole/coroutine/lock/trylock.xml @@ -1,6 +1,5 @@ - - + @@ -29,10 +28,10 @@ &reftitle.returnvalues; - + Renvoie &true; si le verrou a été acquis avec succès, &false; si le verrou n'est pas disponible. - + diff --git a/reference/swoole/swoole/coroutine/lock/unlock.xml b/reference/swoole/swoole/coroutine/lock/unlock.xml index 77e6b79f4f..b019b675ed 100644 --- a/reference/swoole/swoole/coroutine/lock/unlock.xml +++ b/reference/swoole/swoole/coroutine/lock/unlock.xml @@ -1,6 +1,5 @@ - - + @@ -40,10 +39,10 @@ &reftitle.returnvalues; - + Renvoie &true; si le verrou a été relâché avec succès, sinon &false;. - + diff --git a/reference/win32service/rightinfo/get-full-username.xml b/reference/win32service/rightinfo/get-full-username.xml index 2f29110759..7f690537b8 100644 --- a/reference/win32service/rightinfo/get-full-username.xml +++ b/reference/win32service/rightinfo/get-full-username.xml @@ -1,6 +1,5 @@ - - + Win32Service\RightInfo::getFullUsername @@ -25,9 +24,9 @@ &reftitle.returnvalues; - - Renvoie le domaine et le nom d'utilisateur ou le nom d'utilisateur si le domaine est &null; ou &null; si aucun nom d'utilisateur n'est trouvé. - + + Renvoie le domaine et le nom d'utilisateur. Si le domaine est &null;, renvoie uniquement le nom d'utilisateur ; renvoie &null; si aucun nom d'utilisateur n'est trouvé. + From 32ac791d046db780d9b80de2bf2dd75d2fdfd414 Mon Sep 17 00:00:00 2001 From: lacatoire Date: Thu, 9 Jul 2026 20:41:58 +0200 Subject: [PATCH 2/2] =?UTF-8?q?weakreference:=20aligner=20=20sur?= =?UTF-8?q?=20doc-en=20(d=C3=A9rive=20de=20structure)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- language/predefined/weakreference.xml | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/language/predefined/weakreference.xml b/language/predefined/weakreference.xml index ff144cf5c0..54c946aa25 100644 --- a/language/predefined/weakreference.xml +++ b/language/predefined/weakreference.xml @@ -20,9 +20,9 @@ compteur de références atteint zéro ; la création de références faibles n'augmente pas le compteur de références de l'objet référencé. - + Les WeakReferences ne peuvent pas être sérialisées. - +