stream_supports_lock
stream_wrapper_restore
Fonctions sur les flux
PHP Manual

# stream_wrapper_register

(PHP 4 >= 4.3.2, PHP 5)

stream_wrapper_register — Enregistre un gestionnaire d'URL

### Description

bool stream_wrapper_register ( string `$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` 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.

### 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

stream_supports_lock
stream_wrapper_restore
Fonctions sur les flux
PHP Manual