From 49b42cf780387b86948b5bfdd73add14db9134dc Mon Sep 17 00:00:00 2001 From: lacatoire Date: Tue, 13 Oct 2026 13:46:32 +0200 Subject: [PATCH] [Sync-En] try/catch, error handling, Error, Exception, quotemeta, match: sync with doc-en --- language/control-structures/finally.xml | 22 +++++++------- language/control-structures/match.xml | 4 +-- language/control-structures/throw.xml | 6 ++-- language/control-structures/try-catch.xml | 10 +++--- language/error-handling.xml | 20 ++++++------ language/predefined/error.xml | 21 ++++++------- language/predefined/exception.xml | 17 ++++------- reference/strings/functions/quotemeta.xml | 37 ++++++++++++++++++----- 8 files changed, 74 insertions(+), 63 deletions(-) diff --git a/language/control-structures/finally.xml b/language/control-structures/finally.xml index fea36c4495..01bce64d67 100644 --- a/language/control-structures/finally.xml +++ b/language/control-structures/finally.xml @@ -1,5 +1,5 @@ - + finally @@ -13,7 +13,7 @@ relancée. Il est exécuté avant la reprise du flux d'exécution normal. La seule exception à cette règle est l'arrêt brutal du script, comme lors d'un - appel à exit ou d'une erreur fatale (par exemple lorsque + appel à exit ou d'une erreur fatale (par exemple, lorsque le temps d'exécution maximal est dépassé). @@ -28,7 +28,7 @@ function inverse($x) { try { echo inverse(5) . "\n"; } catch (\DivisionByZeroError $e) { - echo 'Erreur attrapée : ', $e->getMessage(), "\n"; + echo 'Erreur attrapée : ', $e->getMessage(), "\n"; } finally { echo "Premier finally.\n"; } @@ -36,7 +36,7 @@ try { try { echo inverse(0) . "\n"; } catch (\DivisionByZeroError $e) { - echo 'Erreur attrapée : ', $e->getMessage(), "\n"; + echo 'Erreur attrapée : ', $e->getMessage(), "\n"; } finally { echo "Second finally.\n"; } @@ -250,7 +250,7 @@ function generate() try { yield 1; yield 2; - } catch(\Exception $e) { + } catch (\Exception $e) { echo 'catch'; } finally { echo "finally\n"; @@ -262,7 +262,7 @@ try { echo $i, "\n"; throw new Exception(); } -} catch(Exception $e) { +} catch (Exception $e) { echo 'catch externe'; } ]]> @@ -297,7 +297,7 @@ function generate() try { yield 1; yield 2; - } catch(\Exception $e) { + } catch (\Exception $e) { echo 'catch'; } finally { echo "finally\n"; @@ -310,7 +310,7 @@ try { echo $i, "\n"; throw new Exception(); } -} catch(Exception $e) { +} catch (Exception $e) { echo 'catch externe'; } ]]> @@ -410,10 +410,10 @@ quitter Lorsque exit est appelé dans un bloc &finally;, tous les - autres blocs &finally; externes sont ignorés. + blocs &finally; externes sont ignorés. - Ignorer le bloc &finally; externe en appelant <function>exit</function> + Ignorer un bloc &finally; externe en appelant <function>exit</function> - + match @@ -208,7 +208,7 @@ try { 1, 2 => foo(), 3, 4 => bar(), }; -} catch (\UnhandledMatchError $e) { +} catch (UnhandledMatchError $e) { var_dump($e); } ]]> diff --git a/language/control-structures/throw.xml b/language/control-structures/throw.xml index d443397a70..71e77cb064 100644 --- a/language/control-structures/throw.xml +++ b/language/control-structures/throw.xml @@ -1,17 +1,17 @@ - + throw Le mot-clé &throw; est une expression et peut être utilisé dans n'importe - quel contexte d'expression. Il prend en argument une instance d'un objet + quel contexte d'expression. Il prend en argument un objet Throwable. - Antérieurement à PHP 8.0, le mot-clé &throw; était une instruction et non + Antérieurement à PHP 8.0.0, le mot-clé &throw; était une instruction et non une expression. diff --git a/language/control-structures/try-catch.xml b/language/control-structures/try-catch.xml index 795afcb9f0..d32d91f953 100644 --- a/language/control-structures/try-catch.xml +++ b/language/control-structures/try-catch.xml @@ -1,8 +1,8 @@ - + - Try...Catch + try...catch try @@ -37,7 +37,7 @@ Il spécifie une ou plusieurs sous-classes de Throwable (le plus souvent Exception) qu'il peut traiter, et - éventuellement une variable à laquelle assigner l'exception. + éventuellement une variable à laquelle l'exception est assignée. Le premier bloc &catch; qui correspond à la classe de l'objet @@ -185,9 +185,9 @@ class B extends Exception {} try { throw new A; -} catch(A $e) { +} catch (A $e) { throw new B; -} catch(B) { +} catch (B) { echo 'Bonjour'; } diff --git a/language/error-handling.xml b/language/error-handling.xml index 6d454a9b2d..691dd6cf39 100644 --- a/language/error-handling.xml +++ b/language/error-handling.xml @@ -1,5 +1,5 @@ - + Gestion des erreurs @@ -80,15 +80,16 @@ Les objets Throwable ne peuvent pas être clonés. Tenter de cloner un tel - objet lance une erreur Error, même si une - sous-classe déclare sa propre méthode - __clone(), avec le message suivant : + objet lance une erreur Error avec le message + suivant : Trying to clone an uncloneable object of class Exception. + Cela se produit même si une sous-classe déclare sa propre méthode + __clone(). - <literal>Gestionnaire d'exceptions global</literal> + Gestionnaire d'exceptions global Il est possible d'ajouter un gestionnaire pour toute erreur Throwable non attrapée avec @@ -104,9 +105,6 @@ Une exception définie par l'utilisateur peut être créée en étendant la classe native Exception. - Pour connaître les méthodes et propriétés accessibles dans une classe fille - dérivée de Exception, il faut consulter sa - page. Si une classe étend la classe native Exception @@ -232,7 +230,7 @@ Une fonction personnalisée pour ce type d'exception Les erreurs de diagnostic, aussi appelées erreurs traditionnelles, servent à signaler un certain nombre de conditions différentes, et peuvent être affichées et/ou enregistrées dans un journal selon les besoins. - Par défaut, PHP signale tous les diagnostics. (Antérieurement à PHP 8.0, + Par défaut, PHP signale tous les diagnostics. (Antérieurement à PHP 8.0.0, les diagnostics E_NOTICE et E_DEPRECATED n'étaient pas signalés par défaut.) @@ -270,7 +268,7 @@ Une fonction personnalisée pour ce type d'exception display_errors détermine si le diagnostic est affiché dans la sortie du script. Ceci devrait toujours être désactivé dans un environnement de production, - car il peut contenir des informations confidentielles, telles que les mots de + car la sortie peut contenir des informations confidentielles, telles que les mots de passe de base de données. Il est cependant souvent utile de l'activer lors du développement, car cela assure un signalement immédiat des problèmes. @@ -334,7 +332,7 @@ Une fonction personnalisée pour ce type d'exception - - + Error Error @@ -10,10 +9,12 @@
&reftitle.intro; - - Error est la classe de base pour toutes - les erreurs internes de PHP. - + + Error est la classe de base des + erreurs qui indiquent des erreurs de programmation. Ces erreurs nécessitent + généralement une correction du programme plutôt qu'un traitement pendant le + fonctionnement normal. +
@@ -74,12 +75,8 @@ &Methods; - - - - - - + + diff --git a/language/predefined/exception.xml b/language/predefined/exception.xml index 0c97b488cb..e9d43bd076 100644 --- a/language/predefined/exception.xml +++ b/language/predefined/exception.xml @@ -1,6 +1,5 @@ - - + Exception Exception @@ -10,10 +9,10 @@
&reftitle.intro; - + Exception est la classe de base - pour toutes les exceptions utilisateur. - + des exceptions qui peuvent être traitées pendant le fonctionnement normal. +
@@ -74,12 +73,8 @@ &Methods; - - - - - - + + diff --git a/reference/strings/functions/quotemeta.xml b/reference/strings/functions/quotemeta.xml index f6fce96f0c..5a2d0ac0d8 100644 --- a/reference/strings/functions/quotemeta.xml +++ b/reference/strings/functions/quotemeta.xml @@ -1,7 +1,5 @@ - - - + quotemeta @@ -40,11 +38,34 @@ &reftitle.returnvalues; - - Retourne la chaîne dont les métacaractères ont été protégés ou - &false; si une chaîne vide est fournie dans le paramètre - string. - + + Retourne la chaîne dont les métacaractères ont été protégés. Si une chaîne + vide est fournie dans le paramètre string, une chaîne + vide est retournée. + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.0.0 + + Retourne une chaîne vide, au lieu de &false;, lorsque + string est vide. + + + + +