From bea62799ac169469202d7acedc49f5327430fa6c Mon Sep 17 00:00:00 2001 From: lacatoire Date: Thu, 19 Nov 2026 09:11:58 +0100 Subject: [PATCH] [Sync-En] stream, readonly: document stream error handling and readonly property defaults --- appendices/migration86/new-features.xml | 12 +- appendices/migration86/other-changes.xml | 21 +- language/context.xml | 5 +- language/context/stream.xml | 276 ++++++++ language/oop5/basic.xml | 7 +- language/oop5/properties.xml | 50 +- reference/stream/book.xml | 8 +- reference/stream/entities.ent | 21 + reference/stream/errors.xml | 104 ++- .../stream/functions/stream-clear-errors.xml | 95 +++ .../functions/stream-context-set-default.xml | 15 +- .../functions/stream-copy-to-stream.xml | 15 +- .../stream/functions/stream-is-local.xml | 36 +- .../stream/functions/stream-last-errors.xml | 108 ++++ reference/stream/functions/stream-select.xml | 19 +- .../stream/functions/stream-socket-pair.xml | 37 +- reference/stream/streamerror.xml | 146 +++++ reference/stream/streamerrorcode.xml | 605 ++++++++++++++++++ reference/stream/streamerrormode.xml | 78 +++ reference/stream/streamerrorstore.xml | 93 +++ reference/stream/streamexception.xml | 91 +++ .../stream/streamexception/geterrors.xml | 94 +++ 22 files changed, 1898 insertions(+), 38 deletions(-) create mode 100644 language/context/stream.xml create mode 100644 reference/stream/entities.ent create mode 100644 reference/stream/functions/stream-clear-errors.xml create mode 100644 reference/stream/functions/stream-last-errors.xml create mode 100644 reference/stream/streamerror.xml create mode 100644 reference/stream/streamerrorcode.xml create mode 100644 reference/stream/streamerrormode.xml create mode 100644 reference/stream/streamerrorstore.xml create mode 100644 reference/stream/streamexception.xml create mode 100644 reference/stream/streamexception/geterrors.xml diff --git a/appendices/migration86/new-features.xml b/appendices/migration86/new-features.xml index 6c42ef77d4..54847f9f5b 100644 --- a/appendices/migration86/new-features.xml +++ b/appendices/migration86/new-features.xml @@ -1,5 +1,5 @@ - + Nouvelles fonctionnalités @@ -11,7 +11,11 @@ Les propriétés - en lecture seule peuvent désormais déclarer des valeurs par défaut. + en lecture seule, y compris celles des + classes en lecture seule, + peuvent désormais déclarer des valeurs par défaut. + La valeur par défaut compte comme l'initialisation de la propriété, donc la + propriété ne peut plus être assignée, pas même depuis le constructeur. @@ -602,9 +606,11 @@ bool(true) Les énumérations StreamErrorStore, StreamErrorMode et StreamErrorCode Les fonctions stream_last_errors et stream_clear_errors - Elle est contrôlée à l'aide des options de contexte de flux + Elle est contrôlée à l'aide des + options de contexte de flux error_mode, error_store et error_handler. + Voir pour une vue d'ensemble. diff --git a/appendices/migration86/other-changes.xml b/appendices/migration86/other-changes.xml index 9e09dce99f..c0a8ff3660 100644 --- a/appendices/migration86/other-changes.xml +++ b/appendices/migration86/other-changes.xml @@ -1,5 +1,5 @@ - + Autres changements @@ -87,6 +87,25 @@ Auparavant, de tels échecs étaient silencieusement ignorés. + + stream_select, + stream_copy_to_stream, + stream_socket_pair et + stream_is_local ont désormais un argument + context optionnel supplémentaire. + + + + + stream_context_set_default lève désormais une + ValueError si + options contient l'une des + options de contexte de flux + error_mode, error_store ou + error_handler. + + + diff --git a/language/context.xml b/language/context.xml index f26ffe584c..6be62bae53 100644 --- a/language/context.xml +++ b/language/context.xml @@ -1,7 +1,5 @@ - - - + Options et paramètres de contexte @@ -17,6 +15,7 @@ + &language.context.stream; &language.context.socket; &language.context.http; &language.context.ftp; diff --git a/language/context/stream.xml b/language/context/stream.xml new file mode 100644 index 0000000000..f1a8265dde --- /dev/null +++ b/language/context/stream.xml @@ -0,0 +1,276 @@ + + + + + Options de contexte de flux + Liste des options de contexte de gestion des erreurs de flux + + + + &reftitle.description; + + Les options situées sous la clé stream sont disponibles + pour toutes les enveloppes. Elles contrôlent la manière dont les erreurs + des opérations sur les flux utilisant le contexte sont signalées. + Voir pour une vue d'ensemble. + + + + + &reftitle.options; + + + error_mode StreamErrorMode + + + Manière dont les erreurs sont signalées : sous forme de diagnostics tels + que E_WARNING + (StreamErrorMode::Error), + en lançant une StreamException pour les + erreurs fatales (StreamErrorMode::Exception), + ou pas du tout (StreamErrorMode::Silent). + + + Vaut par défaut StreamErrorMode::Error. + + + + + error_store StreamErrorStore + + + Erreurs qui sont conservées pour être récupérées avec + stream_last_errors. + + + Vaut par défaut StreamErrorStore::Auto, qui ne + conserve aucune erreur avec StreamErrorMode::Error, + les erreurs non fatales avec StreamErrorMode::Exception, + et toutes les erreurs avec StreamErrorMode::Silent. + + + + + error_handler callable + + + Une fonction de rappel appelée une fois pour chaque opération ayant + signalé des erreurs, avec la signature suivante : + + + voidhandler + arrayerrors + + + + errors + + + Une liste d'objets StreamError + contenant toutes les erreurs de l'opération, dans l'ordre dans lequel + elles ont été signalées. + + + + + + Le gestionnaire est appelé indépendamment de + error_store, après que les erreurs ont été + signalées sous forme de diagnostics. Il n'est pas appelé si une + StreamException est lancée. + Sa valeur de retour est ignorée. + + + + + + + + &reftitle.errors; + + Les valeurs de ces options ne sont pas validées lors de la création du + contexte. Si une opération signale une erreur et que + error_mode n'est pas une + StreamErrorMode, que error_store + n'est pas une StreamErrorStore, ou que + error_handler n'est pas un + callable valide, une TypeError + est lancée. + + + + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.6.0 + + Ajout de error_mode, + error_store et + error_handler. + + + + + + + + + &reftitle.notes; + + + Ces options ne peuvent pas être définies avec + stream_context_set_default, qui lance une + ValueError si ces options sont passées. + + + + + Seules les erreurs de la couche de flux sont concernées. Les autres + erreurs d'une fonction, comme une ValueError + ou une TypeError pour un argument invalide, + sont lancées comme d'habitude. + + + + + + &reftitle.examples; + + Lancer des exceptions pour les erreurs de flux + + [ + 'error_mode' => StreamErrorMode::Exception, + ], +]); + +try { + $stream = fopen('/nonexistent/file.txt', 'r', false, $context); +} catch (StreamException $exception) { + echo $exception->getMessage(), PHP_EOL; + + foreach ($exception->getErrors() as $error) { + echo $error->wrapperName, ': ', $error->code->name, PHP_EOL; + } +} +]]> + + &example.outputs; + + + + + + Récupérer les erreurs sans diagnostics + + [ + 'error_mode' => StreamErrorMode::Silent, + ], +]); + +$stream = fopen('/nonexistent/file.txt', 'r', false, $context); +var_dump($stream); + +foreach (stream_last_errors() as $error) { + echo $error->code->name, ': ', $error->message, PHP_EOL; +} +]]> + + &example.outputs; + + + + + + Recevoir les erreurs dans un gestionnaire d'erreurs + + [ + 'error_mode' => StreamErrorMode::Silent, + 'error_store' => StreamErrorStore::None, + 'error_handler' => function (array $errors): void { + print_r($errors); + }, + ], +]); + +fopen('/nonexistent/file.txt', 'r', false, $context); +]]> + + &example.outputs; + + StreamError Object + ( + [code] => StreamErrorCode Enum + ( + [name] => OpenFailed + ) + + [message] => Failed to open stream: No such file or directory + [wrapperName] => plainfile + [severity] => 2 + [terminating] => 1 + ) + +) +]]> + + + + + + &reftitle.seealso; + + stream_context_create + stream_last_errors + StreamError + StreamException + + + + + diff --git a/language/oop5/basic.xml b/language/oop5/basic.xml index ed794a97b2..aacd1cb272 100644 --- a/language/oop5/basic.xml +++ b/language/oop5/basic.xml @@ -1,5 +1,5 @@ - + Syntaxe de base @@ -183,6 +183,11 @@ readonly class Foo ]]> + + À partir de PHP 8.6.0, les propriétés d'une classe readonly + peuvent déclarer des + valeurs par défaut. + Une classe readonly peut être étendue si, diff --git a/language/oop5/properties.xml b/language/oop5/properties.xml index 1a8657f14f..5c1db4941e 100644 --- a/language/oop5/properties.xml +++ b/language/oop5/properties.xml @@ -1,5 +1,5 @@ - + Propriétés @@ -294,34 +294,52 @@ new Test('abc 42'); - - - Spécifier une valeur par défaut explicite à une propriété en lecture seule - n'est pas autorisé, car une propriété en lecture seule avec une valeur par - défaut est essentiellement identique à une constante, et par conséquent - pas particulièrement utile. - - + + À partir de PHP 8.6.0, une propriété en lecture seule peut déclarer une + valeur par défaut. + La valeur par défaut compte comme l'initialisation de la propriété, donc la + propriété ne peut plus être assignée, pas même depuis le constructeur. + Cela permet d'implémenter une + propriété d'interface + en lecture seule avec une valeur fixe, sans avoir à l'assigner dans un constructeur. + Avant PHP 8.6.0, déclarer une valeur par défaut sur une propriété en lecture + seule provoquait une erreur de compilation. + + + +$test = new Test(); +var_dump($test->prop); // int(42) + +// La propriété a déjà été initialisée par sa valeur par défaut. +$test->prop = 43; +// Erreur : Cannot modify readonly property Test::$prop ]]> - - - + + + + + + Une valeur par défaut sur un + paramètre de constructeur promu + est la valeur par défaut du paramètre, et non celle de la propriété. + - + Les propriétés en lecture seule ne peuvent pas être unset une fois qu'elles ont été initialisées. Cependant, il est possible de unset une propriété en lecture seule avant son initialisation, depuis la portée où la propriété a été déclarée. - + Une propriété en lecture seule avec une valeur par défaut est initialisée + à la création de l'objet, et ne peut donc jamais être unset. + Les modifications ne sont pas nécessairement des affectations simples, diff --git a/reference/stream/book.xml b/reference/stream/book.xml index 495dd23b97..fab4e74d65 100644 --- a/reference/stream/book.xml +++ b/reference/stream/book.xml @@ -1,6 +1,5 @@ - - + @@ -71,6 +70,11 @@ &reference.stream.php-user-filter; &reference.stream.streamwrapper; &reference.stream.streambucket; + &reference.stream.streamerror; + &reference.stream.streamexception; + &reference.stream.streamerrorcode; + &reference.stream.streamerrormode; + &reference.stream.streamerrorstore; &reference.stream.reference; diff --git a/reference/stream/entities.ent b/reference/stream/entities.ent new file mode 100644 index 0000000000..3e7dbc2889 --- /dev/null +++ b/reference/stream/entities.ent @@ -0,0 +1,21 @@ + + + + + + + + Un contexte resource créé avec + stream_context_create, ou &null;. + Ses options de gestion des erreurs + déterminent comment les erreurs de flux de cet appel sont signalées. + + + + diff --git a/reference/stream/errors.xml b/reference/stream/errors.xml index 5b62e8982e..d35e64f092 100644 --- a/reference/stream/errors.xml +++ b/reference/stream/errors.xml @@ -1,7 +1,5 @@ - - - + Erreurs de flux @@ -17,6 +15,106 @@ E_WARNING sera généré pour indiquer la nature de l'erreur. + +
+ Configuration de la gestion des erreurs + + À partir de PHP 8.6.0, la façon dont les erreurs de flux sont signalées peut + être modifiée pour chaque opération qui utilise un + contexte de flux, en définissant les + options de contexte de flux + error_mode, error_store + et error_handler. + Chaque erreur est décrite par un objet StreamError, + dont la propriété code + est un cas de StreamErrorCode. + + + Une erreur est soit fatale (elle met fin à l'opération), + comme un fichier qui ne peut pas être ouvert, soit non fatale, + auquel cas elle est signalée mais ne lance pas d'exception avec le mode + StreamErrorMode::Exception. Une même opération peut + signaler plusieurs erreurs. + + + L'option error_mode prend un cas de + StreamErrorMode et définit comment les erreurs sont + signalées : + + + + + StreamErrorMode::Error, la valeur par défaut, émet + des diagnostics tels que E_WARNING et + E_NOTICE. + + + + + StreamErrorMode::Exception lance une + StreamException si l'opération a + signalé une erreur fatale. Les erreurs non fatales ne lancent pas + d'exception et n'émettent aucun diagnostic. + + + + + StreamErrorMode::Silent n'émet aucun diagnostic + et ne lance aucune exception. + + + + + L'option error_store prend un cas de + StreamErrorStore et définit quelles erreurs + sont conservées pour stream_last_errors. Avec la valeur + par défaut, StreamErrorStore::Auto, cela dépend du + mode d'erreur : + + + + + + Mode d'erreur + Erreurs stockées avec StreamErrorStore::Auto + + + + + StreamErrorMode::Error + Aucune + + + StreamErrorMode::Exception + Les erreurs non fatales + + + StreamErrorMode::Silent + Toutes les erreurs + + + + + + L'option error_handler est un + callable qui reçoit la liste des objets + StreamError de chaque opération qui a + signalé des erreurs, sauf si une + StreamException est lancée. + + + + stream_context_set_default rejette ces options. + Elles doivent être définies sur un contexte créé avec + stream_context_create et passé à la + fonction, ou avec lequel le flux a été ouvert. + + + + Voir les options de contexte de flux + pour des exemples de chaque mode d'erreur et d'un gestionnaire d'erreurs. + +
+ + + + stream_clear_errors + Efface les erreurs de flux stockées + + + + &reftitle.description; + + voidstream_clear_errors + + + + Efface les erreurs que stream_last_errors retournerait. + + + Comme les erreurs stockées sont conservées jusqu'à ce qu'une autre opération + en stocke de nouvelles, les effacer avant une opération permet de savoir + ensuite si cette opération en a stocké. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + &return.void; + + + + + &reftitle.examples; + + Exemple de <function>stream_clear_errors</function> + + [ + 'error_mode' => StreamErrorMode::Silent, + ], +]); + +fopen('/nonexistent/file.txt', 'r', false, $context); +var_dump(count(stream_last_errors())); + +stream_clear_errors(); +var_dump(count(stream_last_errors())); +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + stream_last_errors + + + + + diff --git a/reference/stream/functions/stream-context-set-default.xml b/reference/stream/functions/stream-context-set-default.xml index 658f826137..5004553e36 100644 --- a/reference/stream/functions/stream-context-set-default.xml +++ b/reference/stream/functions/stream-context-set-default.xml @@ -1,5 +1,5 @@ - + @@ -59,6 +59,13 @@ $arr['wrapper']['option'] = $value, c'est-à-dire si l'un de ses éléments n'est pas un tableau ou a une clé entière. + + Lève une ValueError si + options contient l'une des + options de gestion des erreurs de flux + error_mode, error_store + ou error_handler. + @@ -72,6 +79,12 @@ + + 8.6.0 + + Le paramètre optionnel context a été ajouté. + + 8.0.0 diff --git a/reference/stream/functions/stream-copy-to-stream.xml b/reference/stream/functions/stream-copy-to-stream.xml index 101392030a..a1c4a310b3 100644 --- a/reference/stream/functions/stream-copy-to-stream.xml +++ b/reference/stream/functions/stream-copy-to-stream.xml @@ -1,5 +1,5 @@ - + stream_copy_to_stream @@ -14,6 +14,7 @@ resourceto intnulllength&null; intoffset0 + resourcenullcontext&null; Fait une copie jusqu'à length octets de @@ -68,6 +69,12 @@ + + context + + &ext.stream.context-error-handling; + + @@ -90,6 +97,12 @@ + + 8.6.0 + + Le paramètre optionnel context a été ajouté. + + 8.0.0 diff --git a/reference/stream/functions/stream-is-local.xml b/reference/stream/functions/stream-is-local.xml index 230d758b23..3e901c9138 100644 --- a/reference/stream/functions/stream-is-local.xml +++ b/reference/stream/functions/stream-is-local.xml @@ -1,7 +1,5 @@ - - - + stream_is_local @@ -13,6 +11,7 @@ boolstream_is_local resourcestringstream + resourcenullcontext&null; stream_is_local vérifie si le flux ou @@ -32,6 +31,15 @@ + + context + + &ext.stream.context-error-handling; + + Uniquement utilisé si stream est une &string;. + + + @@ -43,6 +51,28 @@ + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.6.0 + + Le paramètre optionnel context a été ajouté. + + + + + + + &reftitle.examples; diff --git a/reference/stream/functions/stream-last-errors.xml b/reference/stream/functions/stream-last-errors.xml new file mode 100644 index 0000000000..8acb3169e9 --- /dev/null +++ b/reference/stream/functions/stream-last-errors.xml @@ -0,0 +1,108 @@ + + + + + + stream_last_errors + Retourne les erreurs stockées de la dernière opération sur un flux + + + + &reftitle.description; + + arraystream_last_errors + + + + Retourne les erreurs stockées par la dernière opération sur un flux qui + en a stocké. Les erreurs qu'une opération stocke sont contrôlées par les + options de contexte de flux + error_store + et + error_mode. + Avec les options par défaut, aucune erreur n'est stockée. + + + Les erreurs stockées sont remplacées lorsqu'une opération ultérieure stocke + des erreurs. Elles sont conservées lorsqu'une opération ultérieure réussit + ou ne stocke pas ses erreurs, et peuvent être effacées avec + stream_clear_errors. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Retourne une liste d'objets StreamError dans + l'ordre où les erreurs ont été signalées, + ou un tableau vide si aucune erreur n'est stockée. + + + + + &reftitle.examples; + + Exemple de <function>stream_last_errors</function> + + [ + 'error_mode' => StreamErrorMode::Silent, + ], +]); + +$stream = fopen('/nonexistent/file.txt', 'r', false, $context); +var_dump($stream); + +foreach (stream_last_errors() as $error) { + echo $error->code->name, ': ', $error->message, PHP_EOL; +} +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + stream_clear_errors + StreamError + StreamException::getErrors + + + + + + diff --git a/reference/stream/functions/stream-select.xml b/reference/stream/functions/stream-select.xml index ec2c140154..84e862a560 100644 --- a/reference/stream/functions/stream-select.xml +++ b/reference/stream/functions/stream-select.xml @@ -1,5 +1,5 @@ - + stream_select @@ -14,6 +14,7 @@ arraynullexcept intnullseconds intnullmicroseconds&null; + resourcenullcontext&null; stream_select accepte un tableau de flux et @@ -128,6 +129,16 @@ + + context + + &ext.stream.context-error-handling; + + L'avertissement émis lorsque l'appel système sous-jacent échoue n'est + pas affecté par ces options. + + + @@ -155,6 +166,12 @@ + + 8.6.0 + + Le paramètre optionnel context a été ajouté. + + 8.1.0 diff --git a/reference/stream/functions/stream-socket-pair.xml b/reference/stream/functions/stream-socket-pair.xml index 77f05bd7b5..d76231e148 100755 --- a/reference/stream/functions/stream-socket-pair.xml +++ b/reference/stream/functions/stream-socket-pair.xml @@ -1,7 +1,5 @@ - - - + @@ -17,6 +15,7 @@ intdomain inttype intprotocol + resourcenullcontext&null; stream_socket_pair crée une paire de sockets connectées @@ -64,6 +63,16 @@ + + context + + &ext.stream.context-error-handling; + + L'avertissement émis lorsque les sockets ne peuvent pas être créés + n'est pas affecté par ces options. + + + @@ -82,6 +91,28 @@ + + &reftitle.changelog; + + + + + &Version; + &Description; + + + + + 8.6.0 + + Le paramètre optionnel context a été ajouté. + + + + + + + &reftitle.examples; diff --git a/reference/stream/streamerror.xml b/reference/stream/streamerror.xml new file mode 100644 index 0000000000..8f894ef698 --- /dev/null +++ b/reference/stream/streamerror.xml @@ -0,0 +1,146 @@ + + + + + La classe StreamError + StreamError + + + +
+ &reftitle.intro; + + Un objet StreamError décrit une erreur unique + signalée par une opération sur un flux. Les instances sont créées par PHP et + sont retournées par stream_last_errors et + StreamException::getErrors, et passées à l'option + de contexte de flux + error_handler. + +
+ +
+ &reftitle.classsynopsis; + + + + final + readonly + StreamError + + + &Properties; + + public + StreamErrorCode + code + + + public + string + message + + + public + string + wrapperName + + + public + int + severity + + + public + bool + terminating + + +
+ +
+ &reftitle.properties; + + + code + + + Le cas de StreamErrorCode identifiant le type d'erreur. + + + + + message + + + Le message d'erreur. Il s'agit du texte du diagnostic émis + avec StreamErrorMode::Error, sans le préfixe + du nom de la fonction. + + + + + wrapperName + + + Le nom de l'enveloppe de flux qui a signalé l'erreur, + par exemple plainfile pour les fichiers locaux. + + + + + severity + + + Le niveau avec lequel l'erreur est signalée dans le mode + StreamErrorMode::Error, + sous la forme d'une des constantes E_*, + comme E_WARNING ou E_NOTICE. + + + + + terminating + + + &true; si l'erreur a mis fin à l'opération et lance une + StreamException dans le mode + StreamErrorMode::Exception, &false; sinon. + + + + +
+ +
+ &reftitle.seealso; + + stream_last_errors + StreamException::getErrors + + +
+ +
+ +
+ diff --git a/reference/stream/streamerrorcode.xml b/reference/stream/streamerrorcode.xml new file mode 100644 index 0000000000..0083d20c25 --- /dev/null +++ b/reference/stream/streamerrorcode.xml @@ -0,0 +1,605 @@ + + + + L'énumération StreamErrorCode + StreamErrorCode + + +
+ &reftitle.intro; + + L'énumération StreamErrorCode identifie le type + d'erreur signalée par une opération sur un flux. Elle est disponible via + StreamError::$code. + + + Un même cas peut être signalé par différentes enveloppes pour des + raisons différentes ; StreamError::$message + décrit l'échec précis. + +
+ +
+ &reftitle.enumsynopsis; + + + StreamErrorCode + + + None + + Aucune erreur. + + + + + Generic + + Une erreur générique. + + + + + ReadFailed + + La lecture depuis le flux a échoué. + + + + + WriteFailed + + L'écriture dans le flux a échoué. + + + + + SeekFailed + + Le positionnement dans le flux a échoué. + + + + + SeekNotSupported + + Le flux ne supporte pas le positionnement. + + + + + FlushFailed + + Le vidage du flux a échoué. + + + + + TruncateFailed + + La troncature du flux a échoué. + + + + + ConnectFailed + + La connexion du socket a échoué. + + + + + BindFailed + + La liaison du socket à une adresse a échoué. + + + + + ListenFailed + + L'écoute sur le socket a échoué. + + + + + AcceptFailed + + L'acceptation d'une connexion sur le socket a échoué. + + + + + NotWritable + + Le flux n'est pas accessible en écriture. + + + + + NotReadable + + Le flux n'est pas accessible en lecture. + + + + + Disabled + + L'enveloppe ou l'opération est désactivée par la configuration. + + + + + NotFound + + La ressource n'existe pas. + + + + + PermissionDenied + + Permission refusée. + + + + + AlreadyExists + + Le fichier ou le dossier existe déjà. + + + + + InvalidPath + + Le chemin est invalide. + + + + + PathTooLong + + Le chemin est trop long. + + + + + OpenFailed + + L'ouverture a échoué. + + + + + CreateFailed + + La création de la ressource a échoué. + + + + + DupFailed + + La duplication d'un descripteur de fichier a échoué. + + + + + UnlinkFailed + + La suppression du fichier a échoué. + + + + + RenameFailed + + Le renommage du fichier ou du dossier a échoué. + + + + + MkdirFailed + + La création du dossier a échoué. + + + + + RmdirFailed + + La suppression du dossier a échoué. + + + + + StatFailed + + La récupération des informations du fichier a échoué. + + + + + MetaFailed + + La modification des métadonnées du fichier a échoué. + + + + + ChmodFailed + + La modification des permissions du fichier a échoué. + + + + + ChownFailed + + La modification du propriétaire du fichier a échoué. + + + + + CopyFailed + + La copie du fichier a échoué. + + + + + TouchFailed + + La modification des dates du fichier a échoué. + + + + + InvalidMode + + Le mode d'ouverture est invalide. + + + + + InvalidMeta + + L'option de métadonnées est invalide. + + + + + ModeNotSupported + + Le mode d'ouverture n'est pas supporté. + + + + + Readonly + + La ressource est en lecture seule. + + + + + RecursionDetected + + Une récursion infinie a été évitée. + + + + + NotImplemented + + L'opération n'est pas implémentée par l'enveloppe. + + + + + NoOpener + + L'enveloppe ne peut pas ouvrir de flux. + + + + + PersistentNotSupported + + Les flux persistants ne sont pas supportés. + + + + + WrapperNotFound + + L'enveloppe n'existe pas. + + + + + WrapperDisabled + + L'enveloppe est désactivée. + + + + + ProtocolUnsupported + + Le protocole n'est pas supporté. + + + + + WrapperRegistrationFailed + + L'enregistrement de l'enveloppe a échoué. + + + + + WrapperUnregistrationFailed + + La désinscription de l'enveloppe a échoué. + + + + + WrapperRestorationFailed + + La restauration de l'enveloppe a échoué. + + + + + FilterNotFound + + Le filtre de flux n'existe pas. + + + + + FilterFailed + + Un filtre de flux a échoué. + + + + + CastFailed + + La conversion du flux a échoué. + + + + + CastNotSupported + + Le flux ne peut pas être converti vers le type demandé. + + + + + MakeSeekableFailed + + Le rendu du flux positionnable a échoué. + + + + + BufferedDataLost + + Des données en tampon ont été perdues lors d'une conversion. + + + + + NetworkSendFailed + + L'envoi de données a échoué. + + + + + NetworkRecvFailed + + La réception de données a échoué. + + + + + SslNotSupported + + Le flux ne supporte pas le chiffrement. + + + + + ResumptionFailed + + La reprise a échoué. + + + + + SocketPathTooLong + + Le chemin du socket est trop long. + + + + + OobNotSupported + + Le flux ne supporte pas les données hors bande. + + + + + ProtocolError + + Une erreur de protocole est survenue. + + + + + InvalidUrl + + L'URL est invalide. + + + + + InvalidResponse + + La réponse est invalide. + + + + + InvalidHeader + + Un en-tête est invalide. + + + + + InvalidParam + + Un paramètre ou une option est invalide. + + + + + RedirectLimit + + La limite de redirections a été atteinte. + + + + + AuthFailed + + L'authentification a échoué. + + + + + TimeOut + + L'opération a expiré. + + + + + ArchivingFailed + + L'archivage a échoué. + + + + + EncodingFailed + + L'encodage a échoué. + + + + + DecodingFailed + + Le décodage a échoué. + + + + + InvalidFormat + + Le format des données est invalide. + + + + + AllocationFailed + + L'allocation a échoué. + + + + + TemporaryFileFailed + + La création d'un fichier temporaire a échoué. + + + + + LockFailed + + Le verrouillage du flux a échoué. + + + + + LockNotSupported + + Le flux ne supporte pas le verrouillage. + + + + + UserspaceNotImplemented + + L'enveloppe utilisateur n'implémente pas la méthode. + + + + + UserspaceInvalidReturn + + Une méthode de l'enveloppe utilisateur a retourné une valeur invalide. + + + + + UserspaceCallFailed + + L'appel d'une fonction de rappel utilisateur a échoué. + + + +
+ +
+ &reftitle.seealso; + + StreamError + stream_last_errors + + +
+
+
+ diff --git a/reference/stream/streamerrormode.xml b/reference/stream/streamerrormode.xml new file mode 100644 index 0000000000..ad1e5c89e4 --- /dev/null +++ b/reference/stream/streamerrormode.xml @@ -0,0 +1,78 @@ + + + + L'énumération StreamErrorMode + StreamErrorMode + + +
+ &reftitle.intro; + + L'énumération StreamErrorMode spécifie comment les erreurs d'une + opération sur un flux sont signalées. C'est la valeur de l'option + de contexte de flux + error_mode. + +
+ +
+ &reftitle.enumsynopsis; + + + StreamErrorMode + + + Error + + Les erreurs sont signalées sous forme de diagnostics, comme E_WARNING. + C'est la valeur par défaut. + + + + + Exception + + Une StreamException est lancée pour les + erreurs fatales à l'opération. + + + + + Silent + + Les erreurs ne sont pas signalées. + + + +
+ +
+ &reftitle.seealso; + + StreamErrorStore + + + +
+
+
+ diff --git a/reference/stream/streamerrorstore.xml b/reference/stream/streamerrorstore.xml new file mode 100644 index 0000000000..54f3a729a4 --- /dev/null +++ b/reference/stream/streamerrorstore.xml @@ -0,0 +1,93 @@ + + + + L'énumération StreamErrorStore + StreamErrorStore + + +
+ &reftitle.intro; + + L'énumération StreamErrorStore spécifie quelles erreurs d'une + opération sur un flux sont conservées pour être récupérées avec + stream_last_errors. C'est la valeur de l'option + de contexte de flux + error_store. + +
+ +
+ &reftitle.enumsynopsis; + + + StreamErrorStore + + + Auto + + Les erreurs conservées dépendent du mode d'erreur. + C'est la valeur par défaut. + + + + + None + + Aucune erreur n'est conservée. + + + + + NonTerminating + + Seules les erreurs non fatales à l'opération sont conservées. + + + + + Terminating + + Seules les erreurs fatales à l'opération sont conservées. + + + + + All + + Toutes les erreurs sont conservées. + + + +
+ +
+ &reftitle.seealso; + + StreamErrorMode + stream_last_errors + + + +
+
+
+ diff --git a/reference/stream/streamexception.xml b/reference/stream/streamexception.xml new file mode 100644 index 0000000000..704f2ab0fa --- /dev/null +++ b/reference/stream/streamexception.xml @@ -0,0 +1,91 @@ + + + + + La classe StreamException + StreamException + + + +
+ &reftitle.intro; + + Une StreamException est lancée lorsqu'une opération + sur un flux signale une erreur fatale à l'opération et que l'option de contexte de flux + error_mode + vaut StreamErrorMode::Exception. + + + Le message de l'exception est le message de la première erreur de l'opération. + Toutes les erreurs de l'opération sont disponibles via + StreamException::getErrors. + + + + Le code de l'exception est un nombre interne qui peut changer entre les + versions de PHP. Pour identifier l'erreur, il faut utiliser la propriété + code des + erreurs retournées par StreamException::getErrors. + + +
+ +
+ &reftitle.classsynopsis; + + + + StreamException + + + + extends + Exception + + + &InheritedProperties; + + + &Methods; + + + &InheritedMethods; + + + +
+ +
+ &reftitle.seealso; + + StreamError + + + +
+ +
+ + &reference.stream.entities.streamexception; + +
+ diff --git a/reference/stream/streamexception/geterrors.xml b/reference/stream/streamexception/geterrors.xml new file mode 100644 index 0000000000..22786c15b8 --- /dev/null +++ b/reference/stream/streamexception/geterrors.xml @@ -0,0 +1,94 @@ + + + + + StreamException::getErrors + Retourne les erreurs de l'opération sur le flux ayant échoué + + + + &reftitle.description; + + public arrayStreamException::getErrors + + + + Retourne toutes les erreurs signalées par l'opération sur le flux qui a lancé + l'exception, qu'elles soient fatales ou non à l'opération. + + + + + &reftitle.parameters; + &no.function.parameters; + + + + &reftitle.returnvalues; + + Retourne une liste d'objets StreamError dans + l'ordre où les erreurs ont été signalées. + + + + + &reftitle.examples; + + Exemple avec <methodname>StreamException::getErrors</methodname> + + [ + 'error_mode' => StreamErrorMode::Exception, + ], +]); + +try { + $stream = fopen('/nonexistent/file.txt', 'r', false, $context); +} catch (StreamException $exception) { + echo $exception->getMessage(), PHP_EOL; + + foreach ($exception->getErrors() as $error) { + echo $error->wrapperName, ': ', $error->code->name, PHP_EOL; + } +} +]]> + + &example.outputs; + + + + + + + + &reftitle.seealso; + + stream_last_errors + + + +