stream_wrapper_register

(PHP 4 >= 4.3.2, PHP 5, PHP 7, PHP 8)

stream_wrapper_register Enregistre un gestionnaire d'URL

Description

stream_wrapper_register(string$protocol, string$class, int$flags = 0): bool

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. Les noms de protocoles valides doivent contenir uniquement des caractères alphanumériques, points (.), plus (+), ou tiret (-).

class

La classe qui implémente le protocole protocol.

flags

Doit être configuré à STREAM_IS_URL si protocol 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.

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

To Top