diff --git a/language/control-structures/throw.xml b/language/control-structures/throw.xml index 71e77cb064..d9ba28855a 100644 --- a/language/control-structures/throw.xml +++ b/language/control-structures/throw.xml @@ -1,5 +1,5 @@ - + throw @@ -19,6 +19,10 @@ Tenter de lancer avec &throw; un objet qui n'est pas Throwable lève une erreur Error. + Comme les classes utilisateur ne peuvent pas implémenter directement + Throwable, l'objet lancé doit être une instance + de Error ou de Exception, + ou d'une sous-classe de l'une d'elles. Lancer un objet qui n'est pas <exceptionname>Throwable</exceptionname> @@ -42,7 +46,11 @@ Stack trace: Après l'utilisation de &throw;, le flux normal d'exécution est interrompu et la pile d'appels est dépilée jusqu'à ce que l'objet soit attrapé par un bloc - &catch; ou que la portée globale soit atteinte. Dans ce dernier cas, le + &catch; ou que la portée globale soit atteinte. Tous les blocs &finally; + rencontrés en chemin sont exécutés. + Si la portée globale est atteinte, l'objet est transmis au gestionnaire + d'exceptions défini avec set_exception_handler, s'il y en a un, + et le script se termine une fois le gestionnaire terminé. Sinon, le programme se termine avec une erreur fatale contenant la trace d'appels indiquant l'endroit où l'objet Throwable a été lancé. diff --git a/language/control-structures/try-catch.xml b/language/control-structures/try-catch.xml index d32d91f953..bfa01d9dba 100644 --- a/language/control-structures/try-catch.xml +++ b/language/control-structures/try-catch.xml @@ -1,5 +1,5 @@ - + try...catch @@ -15,18 +15,13 @@ Lorsqu'une erreur Throwable est lancée dans un bloc &try;, PHP tente de trouver le premier bloc &catch; correspondant pour - traiter l'erreur. S'il n'en trouve aucun, il dépile la pile d'appels - jusqu'à en trouver un ou jusqu'à atteindre un gestionnaire d'erreurs global. + traiter l'erreur. S'il n'en trouve aucun, la pile d'appels est dépilée + jusqu'à ce qu'un bloc &catch; correspondant soit trouvé ou que la portée + globale soit atteinte. + Un objet non attrapé est alors transmis au gestionnaire d'exceptions défini + avec set_exception_handler, s'il y en a un ; sinon, + le script se termine avec une erreur fatale. - - - Il est possible d'ajouter un gestionnaire pour toute erreur - Throwable non attrapée avec - set_exception_handler. - Ceci est similaire à l'encapsulation de l'ensemble du code dans un bloc - &try;-&catch;. - - catch @@ -45,6 +40,13 @@ L'exécution normale reprend après le bloc &catch;, sans entrer dans les autres blocs &catch; correspondants. + + + Il n'est pas recommandé d'attraper les objets + Error, car ils signalent une erreur de + programmation. + + Attraper une exception @@ -111,8 +113,6 @@ string(11) "MyException" Plusieurs blocs &catch; peuvent être utilisés pour traiter différemment différentes classes d'erreurs Throwable. - L'exécution normale (lorsqu'aucune erreur n'est lancée dans le bloc &try;) - se poursuit après le dernier bloc &catch; défini dans la séquence. Blocs catch multiples @@ -133,7 +133,6 @@ try { Des erreurs Throwable peuvent être lancées (ou relancées) avec &throw; dans un bloc &catch;. - Si rien n'est lancé, l'exécution reprend normalement. Exception imbriquée @@ -238,5 +237,11 @@ Une SpecificException a été lancée, mais les détails importent peu. ]]> + + Voir la section sur la + gestion des erreurs + pour la hiérarchie de Throwable et la manière + de définir des exceptions personnalisées. + diff --git a/language/error-handling.xml b/language/error-handling.xml index 691dd6cf39..8776f30b10 100644 --- a/language/error-handling.xml +++ b/language/error-handling.xml @@ -1,11 +1,8 @@ - + Gestion des erreurs - - Voir aussi la classe Exception - Les erreurs sont une partie normale du développement et du cycle de vie d'une application. PHP fournit donc plusieurs moyens de signaler et de @@ -20,7 +17,8 @@ en erreurs de programmation via la hiérarchie de classes Error et en erreurs récupérables via la hiérarchie de classes - Exception. + Exception. Ces erreurs peuvent être lancées + avec le mot-clé &throw; et attrapées avec le mot-clé &catch;. @@ -38,21 +36,18 @@ Une erreur Throwable est un événement d'exécution qui interrompt le flux normal des instructions. Lorsqu'une erreur - Throwable est lancée par &throw;, que ce soit - par le moteur ou manuellement, elle dépile la pile d'appels jusqu'à être - attrapée par un bloc &catch; ou jusqu'à atteindre la portée globale, auquel - cas le programme se termine avec une erreur fatale. + Throwable est lancée par &throw;, elle dépile + la pile d'appels jusqu'à être attrapée par un bloc &catch; ou jusqu'à + atteindre la portée globale. Tous les blocs &finally; rencontrés en chemin sont exécutés. + Une erreur Throwable non attrapée est transmise + au gestionnaire d'exceptions défini avec + set_exception_handler, s'il y en a un ; sinon, le + programme se termine avec une erreur fatale. Pour lancer une erreur Throwable depuis du - code PHP, il faut utiliser le mot-clé &throw; suivi d'une instance de la - classe Error ou - Exception, ou d'une sous-classe de l'une - d'elles. - Tenter de lancer un objet qui n'est pas de ce type lève une erreur - Error avec le message suivant : - Cannot throw objects that do not implement Throwable. + code PHP, utilisez le mot-clé &throw;. @@ -67,24 +62,18 @@ Il est possible de traiter une erreur Throwable dans PHP en entourant le code susceptible de lancer une erreur d'un bloc &try;. - Un bloc &try; doit avoir au moins un bloc &catch; ou &finally; correspondant. - - - Il n'est pas recommandé d'attraper les objets - Error, car ils signalent une erreur de - programmation. - - Les objets Throwable ne peuvent pas être clonés. Tenter de cloner un tel objet lance une erreur Error avec le message suivant : - Trying to clone an uncloneable object of class Exception. + Trying to clone an uncloneable object of class ClassName. Cela se produit même si une sous-classe déclare sa propre méthode __clone(). + Voir Exception::__clone et + Error::__clone. diff --git a/language/operators/increment.xml b/language/operators/increment.xml index 26dcb19dbb..7836f218ad 100644 --- a/language/operators/increment.xml +++ b/language/operators/increment.xml @@ -1,5 +1,5 @@ - + Opérateurs d'incrémentation et décrémentation Incrémentation et décrémentation @@ -107,12 +107,13 @@ int(4) Un E_WARNING est émis à partir de PHP 8.3.0, car cela convertira implicitement la valeur en int à l'avenir. - + L'opérateur de décrémentation n'a aucun effet sur les - chaînes non numériques. - Un E_WARNING est émis à partir de PHP 8.3.0, + chaînes non numériques, + à l'exception de la chaîne vide, qui devient -1. + Un E_DEPRECATED est émis à partir de PHP 8.3.0, car une TypeError sera levée à l'avenir. - + @@ -143,6 +144,11 @@ int(4) Par exemple, $a = 'Z'; $a++; transforme $a en 'AA'. + + À partir de PHP 8.3.0, incrémenter une chaîne vide ou non alphanumérique + émet E_DEPRECATED. + À partir de PHP 8.5.0, cela s'applique à toutes les chaînes non numériques. + Exemple d'incrémentation de chaîne PERL diff --git a/language/predefined/error/clone.xml b/language/predefined/error/clone.xml index 06cce93b77..aa6850f040 100644 --- a/language/predefined/error/clone.xml +++ b/language/predefined/error/clone.xml @@ -1,6 +1,5 @@ - - + Error::__clone @@ -13,9 +12,19 @@ private voidError::__clone - - Une erreur ne peut pas être clonée, cette méthode produit donc une erreur fatale. - + + Les erreurs ne prennent pas en charge le clonage ; cette méthode existe + uniquement pour l'empêcher. + + + + Les erreurs ne peuvent pas être clonées, qu'il s'agisse d'instances de + Error ou d'une sous-classe. + Tenter de cloner une + erreur lève une Error, qui peut être + interceptée. + + @@ -32,9 +41,11 @@ &reftitle.errors; - - Les erreurs ne sont pas clonables. - + + Tenter de cloner une erreur lève une Error + avec le message suivant : + Trying to clone an uncloneable object of class ClassName. + diff --git a/language/predefined/exception/clone.xml b/language/predefined/exception/clone.xml index 33de4babf9..164f5ec395 100644 --- a/language/predefined/exception/clone.xml +++ b/language/predefined/exception/clone.xml @@ -1,5 +1,5 @@ - + Exception::__clone @@ -41,9 +41,11 @@ &reftitle.errors; - - Les exceptions ne sont pas clonables. - + + Tenter de cloner une exception lève une Error + avec le message suivant : + Trying to clone an uncloneable object of class ClassName. + diff --git a/reference/curl/constants_curl_setopt.xml b/reference/curl/constants_curl_setopt.xml index 70b6bb6f11..eebfddcb60 100644 --- a/reference/curl/constants_curl_setopt.xml +++ b/reference/curl/constants_curl_setopt.xml @@ -1,5 +1,5 @@ - + <function>curl_setopt</function> @@ -810,6 +810,13 @@ est activé. Disponible à partir de cURL 7.1.0. + + À partir de PHP 8.5.0, la valeur est traitée comme un entier. + CURLFOLLOW_ALL équivaut à définir cette option sur &true;. + CURLFOLLOW_OBEYCODE suit les redirections de manière plus stricte + quant aux codes de redirection autorisés. + CURLFOLLOW_FIRSTONLY ne suit que la première redirection. + @@ -3790,6 +3797,19 @@ + + + CURLOPT_SSL_SIGNATURE_ALGORITHMS + (int) + + + + Une liste d'algorithmes de signature, séparés par des deux-points, à utiliser pour + l'authentification TLS. + Disponible à partir de PHP 8.5.0 et cURL 7.89.0. + + + CURLOPT_STDERR diff --git a/reference/curl/curlsharepersistenthandle.xml b/reference/curl/curlsharepersistenthandle.xml index 8d81c32e8b..411a7cf903 100644 --- a/reference/curl/curlsharepersistenthandle.xml +++ b/reference/curl/curlsharepersistenthandle.xml @@ -1,6 +1,5 @@ - - + La classe CurlSharePersistentHandle CurlSharePersistentHandle @@ -11,7 +10,11 @@
&reftitle.intro; - Représente un gestionnaire cURL "share" persistant. + Représente un gestionnaire cURL "share" persistant, créé par + curl_share_init_persistent. + Contrairement à CurlShareHandle (créé avec + curl_share_init), ce gestionnaire persiste entre les requêtes. + Utilisez curl_share_setopt pour configurer les données partagées.
@@ -53,6 +56,28 @@ +
+ &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.5.0 + + La classe a été ajoutée. + + + + + +
+ diff --git a/reference/curl/functions/curl-multi-get-handles.xml b/reference/curl/functions/curl-multi-get-handles.xml new file mode 100644 index 0000000000..c31a05fa30 --- /dev/null +++ b/reference/curl/functions/curl-multi-get-handles.xml @@ -0,0 +1,87 @@ + + + + + curl_multi_get_handles + Retourne un tableau d'objets CurlHandle actuellement attachés à un CurlMultiHandle + + + + &reftitle.description; + + arraycurl_multi_get_handles + CurlMultiHandlemulti_handle + + + Retourne tous les objets CurlHandle actuellement attachés au + CurlMultiHandle donné. Cela inclut les gestionnaires ajoutés avec + curl_multi_add_handle ainsi que ceux acceptés par une fonction de rappel + CURLMOPT_PUSHFUNCTION. + + + + + &reftitle.parameters; + + &curl.mh.description; + + + + + &reftitle.returnvalues; + + Retourne un tableau d'objets CurlHandle. + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.5.0 + + Cette fonction a été ajoutée. + + + + + + + + + &reftitle.seealso; + + curl_multi_add_handle + curl_multi_remove_handle + + + + + diff --git a/reference/ldap/functions/ldap-exop-sync.xml b/reference/ldap/functions/ldap-exop-sync.xml index 29670f995b..a0c93167fe 100644 --- a/reference/ldap/functions/ldap-exop-sync.xml +++ b/reference/ldap/functions/ldap-exop-sync.xml @@ -1,6 +1,5 @@ - - + @@ -91,10 +90,9 @@ &reftitle.returnvalues; - Lorsqu'utilisée avec response_data, - renvoie &true; en cas de succès ou &false; en cas d'erreur. - Lorsqu'utilisée sans response_data, - renvoie un identifiant de résultat ou &false; en cas d'erreur. + Retourne &true; en cas de succès ou &false; en cas d'erreur. + L'opération est toujours effectuée de manière synchrone, + aucun objet résultat n'est donc retourné. diff --git a/reference/ldap/functions/ldap-get-values.xml b/reference/ldap/functions/ldap-get-values.xml index c32b934175..4a973a5090 100644 --- a/reference/ldap/functions/ldap-get-values.xml +++ b/reference/ldap/functions/ldap-get-values.xml @@ -1,6 +1,5 @@ - - + ldap_get_values @@ -54,8 +53,9 @@ attribute - - + + Le nom de l'attribut, par exemple "cn". + @@ -133,11 +133,11 @@ for ($i=0; $i < $values["count"]; $i++) { &reftitle.seealso; - - - ldap_get_values_len - - + + ldap_get_values_len + ldap_get_attributes + ldap_first_attribute + diff --git a/reference/ldap/functions/ldap-mod-del.xml b/reference/ldap/functions/ldap-mod-del.xml index 11bd7d3c00..9fe5c5c312 100644 --- a/reference/ldap/functions/ldap-mod-del.xml +++ b/reference/ldap/functions/ldap-mod-del.xml @@ -1,10 +1,9 @@ - - + ldap_mod_del - Efface un attribut à l'entrée courante + Supprime des valeurs des attributs courants @@ -17,8 +16,8 @@ arraynullcontrols&null; - Efface un ou plusieurs attributs de l'entrée dn. - Les suppressions d'objets sont réalisées par + Supprime une ou plusieurs valeurs d'attribut de l'entrée dn. + Les suppressions d'objets sont réalisées par ldap_delete. @@ -46,8 +45,13 @@ entry - - + + Un tableau associatif listant les attributs à modifier, où chaque clé est un nom d'attribut + et chaque valeur est une valeur unique ou un tableau de valeurs à supprimer de cet attribut. + Envoyer un tableau vide comme valeur supprimera l'attribut entier. + Supprimer une valeur ou un attribut que l'entrée ne possède pas échoue. + Le tableau ne doit pas être vide, sinon une ValueError est levée. + diff --git a/reference/ldap/functions/ldap-next-entry.xml b/reference/ldap/functions/ldap-next-entry.xml index 2e2b452470..b239cddcd3 100644 --- a/reference/ldap/functions/ldap-next-entry.xml +++ b/reference/ldap/functions/ldap-next-entry.xml @@ -1,6 +1,5 @@ - - + ldap_next_entry @@ -70,7 +69,7 @@ &ldap.changelog.ldap-object; &ldap.changelog.entry-object; - &ldap.changelog.return-result-object; + &ldap.changelog.return-result-entry-object; diff --git a/reference/ldap/functions/ldap-parse-result.xml b/reference/ldap/functions/ldap-parse-result.xml index d9c88cddba..57ba228218 100755 --- a/reference/ldap/functions/ldap-parse-result.xml +++ b/reference/ldap/functions/ldap-parse-result.xml @@ -1,6 +1,5 @@ - - + ldap_parse_result @@ -57,10 +56,10 @@ matched_dn - + Une référence vers une variable qui sera valorisée du DN correspondant - s'il a été reconnu dans la requête, sinon, vaudra &null;. - + s'il a été reconnu dans la requête, sinon, vaudra une chaîne vide. + @@ -76,8 +75,8 @@ referrals - Une référence vers une variable qui sera valorisée d'un jeu de tableaux - contenant les chaînes de référence dans le résultat, ou un tableau + Une référence vers une variable qui sera valorisée d'un array + contenant toutes les chaînes de référence du résultat, ou un tableau vide si aucune référence n'est retournée. @@ -147,6 +146,15 @@ if (ldap_parse_result($ldap, $result, $errcode, $dn, $errmsg, $refs)) { + + &reftitle.seealso; + + ldap_err2str + ldap_error + ldap_parse_exop + + +