php_stream_copy_to_mem
<<<		 php_stream_make_seekable php_stream_cast
>>>
10.1.4 Référence des API communes de flux
10.1 API de flux les auteurs d'extensions
10 API PHP : 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

10.1.4.15 php_stream_make_seekable()Convertit un flux en flux avec un pointeur de position

[ Exemples avec hp_stream_make_seekable ]   CVS uniquement

int  php_stream_make_seekable ( php_stream *   origstream , php_stream **   newstream , int   flags )

php_stream_make_seekable vérifie si origstream dispose d'un pointeur de potision. Si ce n'est pas le cas, il va copier les données du flux dans un autre flux temporaire, et disposant d'un pointeur de position. Si cela fonctionne, newstream sera un flux valide même si le flux original avait déjà un pointeur de position.

flags vous permet de spécifier votre préférence pour le flux retourné : utilisez la constante PHP_STREAM_NO_PREFERENCE pour utiliser le flux à pointeur de position par défaut (qui utilise la mémoire, mais passe automatiquement sur un fichier si le fichier devient trop grand), ou bien utilisez PHP_STREAM_PREFER_STDIO pour utiliser un fichier temporaire classique.

Valeur Signification
PHP_STREAM_UNCHANGED Le flux original avait déjà son pointeur de position. newstream vaut origstream .
PHP_STREAM_RELEASED Le flux originl n'avait pas pointeur de position, et il a été détruit. Vous n'avez plus accès à origstream .
PHP_STREAM_FAILED Une erreur est survenue lors de la conversion. newstream vaut NULL; origstream est toujours valide.
PHP_STREAM_CRITICAL Une erreur est survenue lors de la conversion de origstream , qui est maintenant dans un état indéterminé. newstream vaut NULL et il est très recommandé que vous vous fermiez origstream .

Note

Si vous devez déplacer le pointeur et écrire dans le flux, n'utilisez pas cette fonction, car le flux retourné est un flux mis en cache. Il n'est pas garantit qu'il soit lié à la ressource originale.

Note

Si vous avez uniquement de déplacer le pointeur de position vers l'avant, il n'y a pas besoin d'appeler cette fonction, car l'API va automatiquement émuler ce fonctionnement avec le paramètre whence à la valeur SEEK_CUR .

Note

Si origstream repose sur le réseau, cette fonction va se bloquer jusqu'à ce que tout le contenu soit téléchargé.

Note

Ne JAMAIS appeler cette fonction avec un flux origstream qui est une référence à un pointeur de fichier dans un script PHP. Cette fonction pourrait alors fermer le fichier, ce qui conduira à un crash au prochain accès au pointeur.

Note

Dans de nombreux cas, cette fonction ne peut réussir que si origstream vient d'être tout juste ouvert, et qu'aucune données n'ont été mises dans les caches de la couche de flux. Pour cette raison, et parce que cette fonction est compliquée à utiliser correctement, il est recommandé que vous utilisiez la fonction php_stream_open_wrapper en lui passant la constante PHP_STREAM_MUST_SEEK dans vos options, au lieu d'appeler cette fonction directement.

<< php_stream_make_seekable >>
php_stream_copy_to_mem Référence des API communes de flux php_stream_cast