(PHP 4 >= 4.3.2, PHP 5, PHP 7, PHP 8)
streamWrapper::url_stat — Lit les informations sur un fichier
Cette méthode est appelée en réponse à toutes les fonctions liées à stat(), telles que :
pathLe chemin du fichier ou l'URL à analyser. Noter que dans le cas des URLs, elles doivent être délimitées par ://. Tout autre format n'est pas supporté.
flagsLes options supplémentaires activées par l'API des flux. Elle peut contenir une ou plusieurs constantes des constantes suivantes, combinées par OR :
| Option | Description |
|---|---|
| STREAM_URL_STAT_LINK | Pour les ressources qui ont la capacité de se lier à d'autres ressources (comme une redirection HTTP ou bien un lien symbolique). Cette option indique que les informations lues doivent concerner le lien lui-même, et non pas la ressource pointée par le lien. Cette option est activée en réponse à un appel à lstat(), is_link() ou filetype(). |
| STREAM_URL_STAT_QUIET | Si cette option est activée, votre gestionnaire ne doit pas émettre d'erreurs. Si cette option n'est pas activée, vous êtes responsables du rapport d'erreur, en appelant la fonction trigger_error() durant l'analyse du chemin. |
Doit retourner un tableau avec autant d'éléments que stat() retourne.
Les valeurs inconnues ou indisponibles doivent prendre une valeur
raisonnable (généralement, 0). Portez une attention
particulière à mode comme documenté sous
stat().
Doit retourner false en cas d'échec.
É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.