streamWrapper::stream_open
(PHP 4 >= 4.3.2, PHP 5)
streamWrapper::stream_open — Opens file or URL
Description
$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()).
Liste de paramètres
-
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
modeest valide pour le cheminpathdemandé. -
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_PATHSi pathest relatif recherche la ressource en incluant l'include_path.STREAM_REPORT_ERRORSSi 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
pathest ouvert correctement, et que la constanteSTREAM_USE_PATHest configurée viaoptions, alorsopened_pathdoit contenir le chemin complet qui a été réellement ouvert.
Valeurs de retour
Cette fonction retourne TRUE en cas de
succès ou FALSE si une erreur survient.
Erreurs / Exceptions
Émet une alerte
E_WARNING si l'appel à cette méthode échoue
(i.e. pas implémenté).
Notes
Note:
La propriété streamWrapper::$context est mise à jour si un contexte valide est passé à la fonction.
Voir aussi
- fopen() - Ouvre un fichier ou une URL
- parse_url() - Analyse une URL et retourne ses composants
