stream_wrapper_register
(PHP 4 >= 4.3.2, PHP 5)
stream_wrapper_register — Enregistre un gestionnaire d'URL
Description
$protocol
, string $classname
[, int $flags
= 0
] )stream_wrapper_register() permet d'implémenter des gestionnaires de protocole et de flux, à utiliser avec toutes les autres fonctions de fichiers, comme fopen(), fread(), etc.
Liste de paramètres
-
protocol
-
Le nom du gestionnaire à enregistrer.
-
classname
-
La classe qui implémente le protocole
protocol
. -
flags
-
Doit être configuré à
STREAM_IS_URL
siprotocol
est un protocole à URL. Par défaut, cette option vaut 0, et est valable pour les flux locaux.
Valeurs de retour
Cette fonction retourne TRUE
en cas de
succès ou FALSE
si une erreur survient.
stream_wrapper_register() retourne FALSE
si
le protocole protocol
a déjà un gestionnaire.
Historique
Version | Description |
---|---|
5.2.4 |
Ajout du paramètre flags .
|
Exemples
Exemple #1 Comment enregistrer un gestionnaire de flux
<?php $existed = in_array("var", stream_get_wrappers()); if ($existed) { stream_wrapper_unregister("var"); } stream_wrapper_register("var", "VariableStream"); $myvar = ""; $fp = fopen("var://myvar", "r+"); fwrite($fp, "line1\n"); fwrite($fp, "line2\n"); fwrite($fp, "line3\n"); rewind($fp); while (!feof($fp)) { echo fgets($fp); } fclose($fp); var_dump($myvar); if ($existed) { stream_wrapper_restore("var"); } ?>
L'exemple ci-dessus va afficher :
line1 line2 line3 string(18) "line1 line2 line3 "
Voir aussi
- Le prototype de classe streamWrapper
- Exemple de classe enregistrée comme gestionnaire de flux
- stream_wrapper_unregister() - Supprime un gestionnaire d'URL
- stream_wrapper_restore() - Restaure un gestionnaire d'URL supprimé
- stream_get_wrappers() - Liste les gestionnaires de flux