Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
12 changes: 9 additions & 3 deletions appendices/migration86/new-features.xml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: cb48df95d708f20d723ea1d444ddfa17f2e04ceb Maintainer: lacatoire Status: ready -->
<!-- EN-Revision: 8d7f211071c3b37962c15528835d9971f6b7eef9 Maintainer: lacatoire Status: ready -->
<sect1 xml:id="migration86.new-features" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Nouvelles fonctionnalités</title>

Expand All @@ -11,7 +11,11 @@

<simpara>
Les <link linkend="language.oop5.properties.readonly-properties">propriétés
en lecture seule</link> peuvent désormais déclarer des valeurs par défaut.
en lecture seule</link>, y compris celles des
<link linkend="language.oop5.basic.class.readonly">classes en lecture seule</link>,
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.
<!-- RFC: https://wiki.php.net/rfc/readonly_property_defaults -->
</simpara>

Expand Down Expand Up @@ -602,9 +606,11 @@ bool(true)
<member>Les énumérations <enumname>StreamErrorStore</enumname>, <enumname>StreamErrorMode</enumname> et <enumname>StreamErrorCode</enumname></member>
<member>Les fonctions <function>stream_last_errors</function> et <function>stream_clear_errors</function></member>
</simplelist>
Elle est contrôlée à l'aide des options de contexte de flux
Elle est contrôlée à l'aide des
<link linkend="context.stream">options de contexte de flux</link>
<literal>error_mode</literal>, <literal>error_store</literal> et
<literal>error_handler</literal>.
Voir <xref linkend="stream.errors"/> pour une vue d'ensemble.
<!-- RFC: https://wiki.php.net/rfc/stream_errors -->
</para>

Expand Down
21 changes: 20 additions & 1 deletion appendices/migration86/other-changes.xml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: cb48df95d708f20d723ea1d444ddfa17f2e04ceb Maintainer: lacatoire Status: ready -->
<!-- EN-Revision: 8d7f211071c3b37962c15528835d9971f6b7eef9 Maintainer: lacatoire Status: ready -->
<sect1 xml:id="migration86.other-changes">
<title>Autres changements</title>

Expand Down Expand Up @@ -87,6 +87,25 @@
Auparavant, de tels échecs étaient silencieusement ignorés.
</simpara>

<simpara>
<function>stream_select</function>,
<function>stream_copy_to_stream</function>,
<function>stream_socket_pair</function> et
<function>stream_is_local</function> ont désormais un argument
<parameter>context</parameter> optionnel supplémentaire.
<!-- RFC: https://wiki.php.net/rfc/stream_errors -->
</simpara>

<simpara>
<function>stream_context_set_default</function> lève désormais une
<exceptionname>ValueError</exceptionname> si
<parameter>options</parameter> contient l'une des
<link linkend="context.stream">options de contexte de flux</link>
<literal>error_mode</literal>, <literal>error_store</literal> ou
<literal>error_handler</literal>.
<!-- RFC: https://wiki.php.net/rfc/stream_errors -->
</simpara>

</sect3>

<sect3 xml:id="migration86.other-changes.functions.date">
Expand Down
5 changes: 2 additions & 3 deletions language/context.xml
Original file line number Diff line number Diff line change
@@ -1,7 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: 2e39b215fe0d147c5dce83c0e4216552747eb5ff Maintainer: yannick Status: ready -->
<!-- Reviewed: yes -->
<!-- EN-Revision: 8d7f211071c3b37962c15528835d9971f6b7eef9 Maintainer: yannick Status: ready -->

<reference xml:id="context" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink">
<title>Options et paramètres de contexte</title>
Expand All @@ -17,6 +15,7 @@
</para>
</partintro>

&language.context.stream;
&language.context.socket;
&language.context.http;
&language.context.ftp;
Expand Down
276 changes: 276 additions & 0 deletions language/context/stream.xml
Original file line number Diff line number Diff line change
@@ -0,0 +1,276 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 8d7f211071c3b37962c15528835d9971f6b7eef9 Maintainer: lacatoire Status: ready -->
<refentry xml:id="context.stream" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" annotations="verify_info:false" role="stream_context_option">
<refnamediv>
<refname>Options de contexte de flux</refname>
<refpurpose>Liste des options de contexte de gestion des erreurs de flux</refpurpose>
</refnamediv>

<refsect1 role="description">
&reftitle.description;
<simpara>
Les options situées sous la clé <literal>stream</literal> 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 <xref linkend="stream.errors"/> pour une vue d'ensemble.
</simpara>
</refsect1>

<refsect1 role="options">
&reftitle.options;
<variablelist>
<varlistentry xml:id="context.stream.error-mode">
<term><parameter>error_mode</parameter> <type>StreamErrorMode</type></term>
<listitem>
<simpara>
Manière dont les erreurs sont signalées : sous forme de diagnostics tels
que <constant>E_WARNING</constant>
(<constant>StreamErrorMode::Error</constant>),
en lançant une <exceptionname>StreamException</exceptionname> pour les
erreurs fatales (<constant>StreamErrorMode::Exception</constant>),
ou pas du tout (<constant>StreamErrorMode::Silent</constant>).
</simpara>
<simpara>
Vaut par défaut <constant>StreamErrorMode::Error</constant>.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="context.stream.error-store">
<term><parameter>error_store</parameter> <type>StreamErrorStore</type></term>
<listitem>
<simpara>
Erreurs qui sont conservées pour être récupérées avec
<function>stream_last_errors</function>.
</simpara>
<simpara>
Vaut par défaut <constant>StreamErrorStore::Auto</constant>, qui ne
conserve aucune erreur avec <constant>StreamErrorMode::Error</constant>,
les erreurs non fatales avec <constant>StreamErrorMode::Exception</constant>,
et toutes les erreurs avec <constant>StreamErrorMode::Silent</constant>.
</simpara>
</listitem>
</varlistentry>
<varlistentry xml:id="context.stream.error-handler">
<term><parameter>error_handler</parameter> <type>callable</type></term>
<listitem>
<simpara>
Une fonction de rappel appelée une fois pour chaque opération ayant
signalé des erreurs, avec la signature suivante :
</simpara>
<methodsynopsis>
<type>void</type><methodname><replaceable>handler</replaceable></methodname>
<methodparam><type>array</type><parameter>errors</parameter></methodparam>
</methodsynopsis>
<variablelist>
<varlistentry>
<term><parameter>errors</parameter></term>
<listitem>
<simpara>
Une liste d'objets <exceptionname>StreamError</exceptionname>
contenant toutes les erreurs de l'opération, dans l'ordre dans lequel
elles ont été signalées.
</simpara>
</listitem>
</varlistentry>
</variablelist>
<simpara>
Le gestionnaire est appelé indépendamment de
<parameter>error_store</parameter>, après que les erreurs ont été
signalées sous forme de diagnostics. Il n'est pas appelé si une
<exceptionname>StreamException</exceptionname> est lancée.
Sa valeur de retour est ignorée.
</simpara>
</listitem>
</varlistentry>
</variablelist>
</refsect1>

<refsect1 role="errors">
&reftitle.errors;
<simpara>
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
<parameter>error_mode</parameter> n'est pas une
<enumname>StreamErrorMode</enumname>, que <parameter>error_store</parameter>
n'est pas une <enumname>StreamErrorStore</enumname>, ou que
<parameter>error_handler</parameter> n'est pas un
<type>callable</type> valide, une <exceptionname>TypeError</exceptionname>
est lancée.
</simpara>
</refsect1>

<refsect1 role="changelog">
&reftitle.changelog;
<informaltable>
<tgroup cols="2">
<thead>
<row>
<entry>&Version;</entry>
<entry>&Description;</entry>
</row>
</thead>
<tbody>
<row>
<entry>8.6.0</entry>
<entry>
Ajout de <parameter>error_mode</parameter>,
<parameter>error_store</parameter> et
<parameter>error_handler</parameter>.
</entry>
</row>
</tbody>
</tgroup>
</informaltable>
</refsect1>

<refsect1 role="notes">
&reftitle.notes;
<note>
<simpara>
Ces options ne peuvent pas être définies avec
<function>stream_context_set_default</function>, qui lance une
<exceptionname>ValueError</exceptionname> si ces options sont passées.
</simpara>
</note>
<note>
<simpara>
Seules les erreurs de la couche de flux sont concernées. Les autres
erreurs d'une fonction, comme une <exceptionname>ValueError</exceptionname>
ou une <exceptionname>TypeError</exceptionname> pour un argument invalide,
sont lancées comme d'habitude.
</simpara>
</note>
</refsect1>

<refsect1 role="examples">
&reftitle.examples;
<example xml:id="context.stream.example.exception">
<title>Lancer des exceptions pour les erreurs de flux</title>
<programlisting role="php">
<![CDATA[
<?php
$context = stream_context_create([
'stream' => [
'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;
}
}
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
Failed to open stream: No such file or directory
plainfile: OpenFailed
]]>
</screen>
</example>
<example xml:id="context.stream.example.silent">
<title>Récupérer les erreurs sans diagnostics</title>
<programlisting role="php">
<![CDATA[
<?php
$context = stream_context_create([
'stream' => [
'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;
}
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
bool(false)
OpenFailed: Failed to open stream: No such file or directory
]]>
</screen>
</example>
<example xml:id="context.stream.example.handler">
<title>Recevoir les erreurs dans un gestionnaire d'erreurs</title>
<programlisting role="php">
<![CDATA[
<?php
$context = stream_context_create([
'stream' => [
'error_mode' => StreamErrorMode::Silent,
'error_store' => StreamErrorStore::None,
'error_handler' => function (array $errors): void {
print_r($errors);
},
],
]);

fopen('/nonexistent/file.txt', 'r', false, $context);
]]>
</programlisting>
&example.outputs;
<screen>
<![CDATA[
Array
(
[0] => StreamError Object
(
[code] => StreamErrorCode Enum
(
[name] => OpenFailed
)

[message] => Failed to open stream: No such file or directory
[wrapperName] => plainfile
[severity] => 2
[terminating] => 1
)

)
]]>
</screen>
</example>
</refsect1>

<refsect1 role="seealso">
&reftitle.seealso;
<simplelist>
<member><function>stream_context_create</function></member>
<member><function>stream_last_errors</function></member>
<member><exceptionname>StreamError</exceptionname></member>
<member><exceptionname>StreamException</exceptionname></member>
</simplelist>
</refsect1>

</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"~/.phpdoc/manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->
7 changes: 6 additions & 1 deletion language/oop5/basic.xml
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: f8ecb73c5ebab866fb4b67d7873709612a518827 Maintainer: lacatoire Status: ready -->
<!-- EN-Revision: e4676cd5278b301e0f83938a4d5798ab29198868 Maintainer: lacatoire Status: ready -->
<sect1 xml:id="language.oop5.basic" xmlns="http://docbook.org/ns/docbook">
<title>Syntaxe de base</title>
<sect2 xml:id="language.oop5.basic.class">
Expand Down Expand Up @@ -183,6 +183,11 @@ readonly class Foo
]]>
</programlisting>
</informalexample>
<simpara>
À partir de PHP 8.6.0, les propriétés d'une classe <modifier>readonly</modifier>
peuvent déclarer des
<link linkend="language.oop5.properties.readonly-properties">valeurs par défaut</link>.
</simpara>
<para>
Une classe <modifier>readonly</modifier> peut être
<link linkend="language.oop5.basic.extends">étendue</link> si,
Expand Down
Loading
Loading