From d9029ffa5bce04f7aac77240df947c13d195030e Mon Sep 17 00:00:00 2001 From: lacatoire Date: Tue, 20 Oct 2026 09:51:07 +0200 Subject: [PATCH] [Sync-En] DOM, GMP, OpenSSL and SysV semaphores: sync recent doc-en changes --- reference/dom/domdocument/loadxml.xml | 21 ++++++----- reference/gmp/functions/gmp-random-seed.xml | 36 +++++++++---------- .../functions/openssl-random-pseudo-bytes.xml | 11 +++--- reference/sem/functions/sem-get.xml | 19 +++++++--- 4 files changed, 51 insertions(+), 36 deletions(-) diff --git a/reference/dom/domdocument/loadxml.xml b/reference/dom/domdocument/loadxml.xml index 5a9100aa5c..5307c7af6a 100644 --- a/reference/dom/domdocument/loadxml.xml +++ b/reference/dom/domdocument/loadxml.xml @@ -1,6 +1,5 @@ - - + DOMDocument::loadXML @@ -52,12 +51,10 @@ &reftitle.errors; - - Si une chaîne vide est passée comme paramètre source, - une alerte sera générée. Cette alerte n'est pas générée - par libxml, et ne peut être gérée en utilisant les fonctions de gestion - d'erreur de libxml. - + + Lève une ValueError si source + est une chaîne vide. + &reftitle.changelog; @@ -76,6 +73,14 @@ Cette fonction a maintenant un type de retour bool provisoire. + + 8.0.0 + + Passer une chaîne vide comme paramètre source lève désormais une + ValueError ; auparavant, une E_WARNING + était émise et &false; était retourné. + + 8.0.0 diff --git a/reference/gmp/functions/gmp-random-seed.xml b/reference/gmp/functions/gmp-random-seed.xml index cb519f3516..a62583d626 100644 --- a/reference/gmp/functions/gmp-random-seed.xml +++ b/reference/gmp/functions/gmp-random-seed.xml @@ -1,7 +1,5 @@ - - - + gmp_random_seed @@ -23,11 +21,10 @@ seed - - La graine à définir pour les fonctions gmp_random, - gmp_random_bits, et + + La graine à définir pour les fonctions gmp_random_bits et gmp_random_range. - + &gmp.parameter; @@ -43,13 +40,13 @@ - + &reftitle.errors; Lève une exception ValueError si le paramètre seed est invalide. - + &reftitle.changelog; @@ -67,7 +64,7 @@ Si le paramètre seed est invalide, gmp_random_seed lève une exception ValueError dorénavant. - Précédemment une alerte E_WARNING était émise. + Précédemment une alerte E_WARNING était émise et &false; était retourné. @@ -86,25 +83,27 @@ // Définition de la graine gmp_random_seed(100); -var_dump(gmp_strval(gmp_random(1))); +var_dump(gmp_strval(gmp_random_bits(10))); // Définition de la graine avec une autre valeur gmp_random_seed(gmp_init(-100)); -var_dump(gmp_strval(gmp_random_bits(10))); +var_dump(gmp_strval(gmp_random_range(0, 100))); // Définition de la graine avec une valeur invalide -var_dump(gmp_random_seed('not a number')); +try { + gmp_random_seed('not a number'); +} catch (\ValueError $e) { + echo $e->getMessage(), PHP_EOL; +} ]]> &example.outputs; @@ -115,7 +114,6 @@ bool(false) &reftitle.seealso; gmp_init - gmp_random gmp_random_bits gmp_random_range diff --git a/reference/openssl/functions/openssl-random-pseudo-bytes.xml b/reference/openssl/functions/openssl-random-pseudo-bytes.xml index 75c864c976..00d52be95b 100644 --- a/reference/openssl/functions/openssl-random-pseudo-bytes.xml +++ b/reference/openssl/functions/openssl-random-pseudo-bytes.xml @@ -1,7 +1,5 @@ - - - + openssl_random_pseudo_bytes @@ -22,7 +20,8 @@ Indique également si l'algorithme fort de cryptologie a été utilisé pour produire ces octets pseudo-aléatoires, en utilisant le paramètre - strong_result. + strong_result. Il est rare que cette valeur soit &false;, + mais certains systèmes peuvent être défectueux ou anciens. @@ -66,6 +65,10 @@ openssl_random_pseudo_bytes lance une Exception en cas d'échec. + + Lance une ValueError si length + est inférieur à 1. + diff --git a/reference/sem/functions/sem-get.xml b/reference/sem/functions/sem-get.xml index 5f203ac894..633c501b69 100644 --- a/reference/sem/functions/sem-get.xml +++ b/reference/sem/functions/sem-get.xml @@ -1,7 +1,5 @@ - - - + sem_get @@ -68,7 +66,7 @@ Le paramètre optionnel auto_release spécifie - si le sémaphore doit être automatiquement libéré à la fermeture. + si le sémaphore doit être automatiquement libéré à la fin de la requête. @@ -78,7 +76,8 @@ &reftitle.returnvalues; - Retourne une ressource de sémaphore en cas de succès, et &false; en cas d'erreur. + Retourne un identifiant de sémaphore positif en cas de succès, ou &false; + en cas d'erreur. @@ -125,6 +124,16 @@ sémaphore. + + + Si auto_release est activé, les acquisitions détenues + par un objet SysvSemaphore sont également libérées dès + que l'objet est libéré, par exemple lorsque la variable qui le contient est + détruite avec unset, écrasée ou sort de la portée, et pas + seulement à la fin de la requête. Conservez une référence à l'objet aussi + longtemps que le sémaphore doit rester acquis. + +