php_stream_stat
<<<		 php_stream_open_wrapper php_stream_read
>>>
9.1.4 Référence des API communes de flôts
9.1 API de flôts les auteurs d'extensions
9 PHP API: Interface pour les extensions
 Manuel PHP
. php_stream_stat_path
. php_stream_stat
->php_stream_open_wrapper
. php_stream_read
. php_stream_write
. php_stream_eof
. php_stream_getc
. php_stream_gets
. php_stream_close
. php_stream_flush
. php_stream_seek
. php_stream_tell
. php_stream_copy_to_stream
. php_stream_copy_to_mem
. php_stream_make_seekable
. php_stream_cast
. php_stream_can_cast
. php_stream_is_persistent
. php_stream_is
. php_stream_passthru
. php_register_url_stream_wrapper
. php_unregister_url_stream_wrapper
. php_stream_open_wrapper_ex
. php_stream_open_wrapper_as_file
. php_stream_filter_register_factory
. php_stream_filter_unregister_factory

9.1.4.3 php_stream_open_wrapper()Ouvre un flôt sur un fichier ou une URL

[ Exemples avec hp_stream_open_wrapper ]   CVS uniquement

php_stream *  php_stream_open_wrapper ( char *   path , char *   mode , int   options , char **   opened )

php_stream_open_wrapper ouvre un fichier, une URL ou n'importe quelle ressource géré, spécifiée par path . Suivant la valeur de mode , le flôt peut être ouvert en lecture, écriture, ajout ou une combinaison des trois. Voyez la table ci-dessous pour connaîtres les modes utilisées. De plus vous pouvez aussi intégrer le caractère 'b' comme deuxième ou dernière option. Sa présence indiquera que le flôt fonctionnera en mode binaire.

L'option 'b' est ignorée sur les systèmes POSIX, qui traitent les fichiers textes et binaires de la même façon. C'est une bonne idée que de spécifier 'b' à chaque fois que votre flôt accède à des données binaires, pour que votre code fonctionne lorsqu'il est compilé sur un système où 'b' serait important.

Tous les fichiers locaux créés par l'API des flôts recevront les droits par défaut du système : sous Unix, cela signifie que le masque utilisateur du processus sera utilisé. Sous Windows, le fichier sera donné au propriétaire du processus. Tous les fichiers distants seront créé suivant le protocole utilisé, et les droits utilisés seront ceux du serveur distant.

    r
    Ouvre le fichier texte en mode lecture. Le pointeur du flôt est placé au début du fichier.
    r+
    Ouvre le fichier texte en lecture et écriture. Le pointeur du flôt est placé au début du fichier.
    w
    Tronque le fichier à une taille de 0 ou bien crée le fichier, puis l'ouvre en mode écriture. Le pointeur du flôt est placé au début du fichier.
    w+
    Tronque le fichier à une taille de 0 ou bien crée le fichier, puis l'ouvre en mode écriture et lecture. Le pointeur du flôt est placé au début du fichier.
    a
    Ouvre le fichier en mode d'écriture. Le fichier est créé si il n'existe pas. Le pointeur de flôt est positionné à la fin du fichier.
    a+
    Ouvre le fichier en mode d'écriture et lecture. Le fichier est créé si il n'existe pas. Le pointeur de flôt est positionné à la fin du fichier.

options affecte l'interprétation du path ou de l'URL, les vérifications du safe_mode et les actions à prendre lorsqu'il y a une erreur. Voyez Stream open options pour plus de détails sur ces options.

Si opened est non NULL, il sera assigné avec le nom du fichier ou de la ressource qui aura été réellement ouverte. C'est important lorsque l'option inclus USE_PATH , qui permet de fouiller l'include_path pour rechercher le fichier. Vous, l'appelant, êtes responsable de l'appel de efree sur le nom de fichier retourné par ce paramètre.

Note

Si vous avez spécifié l'option STREAM_MUST_SEEK dans options , le chemin retourné dans opened peut ne pas être le même que celui qui vous a été réellemetn retourné. Toutefois, ce sera le nom de la ressource originale à partir de laquelle un flôt à pointeur variable a été créé.

<< php_stream_open_wrapper >>
php_stream_stat Référence des API communes de flôts php_stream_read