(PHP 4 >= 4.3.2, PHP 5, PHP 7)
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()).
pathL'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.
modeLe mode utilisée pour ouvrir le fichier, tel que documenté pour fopen().
Note:
N'oubliez pas de vérifier si
modeest valide pour le cheminpathdemandé.
optionsContient 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.