<?xml version="1.0" encoding="utf-8"?>

<reference xml:id="class.streamwrapper" role="class" xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xmlns:xi="http://www.w3.org/2001/XInclude">

<title>La classe streamWrapper</title>

<titleabbrev>streamWrapper</titleabbrev>

<partintro>

<section xml:id="streamwrapper.intro">

&reftitle.intro;

<para>

Permet la création de gestionnaires de protocoles et de flux,

à utiliser avec toutes les fonctions système, telles que

<function>fopen</function>, <function>fread</function> etc.).

</para>

<note>

<para>

Cette classe <emphasis>n'est pas</emphasis> une classe concrète :

c'est juste un prototype d'une classe qui définirait son propre

protocole.

</para>

</note>

<note>

<para>

Implémenter les méthodes d'une manière qui n'est pas décrite

dans la documentation peut mener à des comportements indéfinis.

</para>

</note>

<para>

Une instance de cette classe est initialisée aussitôt que

les fonctions de flux tentent d'accéder à une ressource avec

un protocole.

</para>

</section>

<section xml:id="streamwrapper.synopsis">

&reftitle.classsynopsis;

<classsynopsis>

<ooclass><classname>streamWrapper</classname></ooclass>

<classsynopsisinfo>

<ooclass>

<classname><replaceable>streamWrapper</replaceable></classname>

</ooclass>

</classsynopsisinfo>

<classsynopsisinfo role="comment">&Properties;</classsynopsisinfo>

<fieldsynopsis>

<modifier>public</modifier>

<type>resource</type>

<varname linkend="streamwrapper.props.context">context</varname>

</fieldsynopsis>

<classsynopsisinfo role="comment">&Methods;</classsynopsisinfo>

<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.streamwrapper')/db:refentry/db:refsect1[@role='description']/descendant::db:constructorsynopsis[not(@role='procedural')])" />

<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.streamwrapper')/db:refentry/db:refsect1[@role='description']/descendant::db:methodsynopsis[not(@role='procedural')])" />

<xi:include xpointer="xmlns(db=http://docbook.org/ns/docbook) xpointer(id('class.streamwrapper')/db:refentry/db:refsect1[@role='description']/descendant::db:destructorsynopsis[not(@role='procedural')])" />

</classsynopsis>

</section>

<section xml:id="streamwrapper.props">

&reftitle.properties;

<variablelist>

<varlistentry xml:id="streamwrapper.props.context">

<term>resource <varname>context</varname></term>

<listitem>

<para>

Le <link linkend="context">contexte</link> courant, ou &null;

si aucun contexte n'a été passé à la fonction.

</para>

<para>

Utiliser la fonction <function>stream_context_get_options</function>

pour analyser le contexte.

</para>

<note>

<para>

Cette propriété <emphasis>doit</emphasis> être public, pour

que PHP puisse la remplir avec la ressource de contexte.

</para>

</note>

</listitem>

</varlistentry>

</variablelist>

</section>

<section role="seealso"><!-- {{{ -->

&reftitle.seealso;

<para>

<simplelist>

<member><xref linkend="stream.streamwrapper.example-1" /></member>

<member><function>stream_wrapper_register</function></member>

<member><function>stream_wrapper_unregister</function></member>

<member><function>stream_wrapper_restore</function></member>

</simplelist>

</para>

</section><!-- }}} -->

</partintro>

&reference.stream.entities.streamwrapper;

</reference>