(PHP 4 >= 4.3.2, PHP 5)
streamWrapper::stream_open — Opens file or URL
$path
, string $mode
, int $options
, string &$opened_path
)Cette méthode est appelée immédiatement après l'initialisation du gestionnaire (par exemple, par fopen() et file_get_contents()).
path
L'URL qui est passée à la fonction originale.
Note:
L'URL peut être découpée à l'aide de parse_url(). Noter que seules les URLs délimitées par :// sont supportées. : et :/, bien que techniquement valides, ne sont pas supportés.
mode
Le mode utilisée pour ouvrir le fichier, tel que documenté pour fopen().
Note:
N'oubliez pas de vérifier si
mode
est valide pour le cheminpath
demandé.
options
Contient les options supplémentaires pour le flux. Il peut contenir une ou plusieurs constantes parmi les suivantes, combinées par des OR.
Option | Description |
---|---|
STREAM_USE_PATH |
Si path est relatif
recherche la ressource en incluant l'include_path.
|
STREAM_REPORT_ERRORS |
Si cette option est active, vous êtes responsable pour émettre une erreur, avec trigger_error() durant l'ouverture du flux. Si cette option n'est pas activée, vous ne devez pas émettre d'erreur. |
opened_path
Si le chemin path
est ouvert correctement,
et que la constante STREAM_USE_PATH
est configurée via
options
, alors opened_path
doit contenir le chemin complet qui a été réellement ouvert.
Cette fonction retourne TRUE
en cas de
succès ou FALSE
si une erreur survient.
Émet une alerte
E_WARNING
si l'appel à cette méthode échoue
(i.e. pas implémenté).
Note:
La propriété streamWrapper::$context est mise à jour si un contexte valide est passé à la fonction.