streamWrapper::url_stat
(PHP 4 >= 4.3.2, PHP 5)
streamWrapper::url_stat — Lit les informations sur un fichier
Description
$path
, int $flags
)Cette méthode est appelée en réponse à toutes les fonctions liées à stat(), telles que :
- chmod() (uniquement quand safe_mode est activé)
- copy()
- fileperms()
- fileinode()
- filesize()
- fileowner()
- filegroup()
- fileatime()
- filemtime()
- filectime()
- filetype()
- is_writable()
- is_readable()
- is_executable()
- is_file()
- is_dir()
- is_link()
- file_exists()
- lstat()
- stat()
- SplFileInfo::getPerms()
- SplFileInfo::getInode()
- SplFileInfo::getSize()
- SplFileInfo::getOwner()
- SplFileInfo::getGroup()
- SplFileInfo::getATime()
- SplFileInfo::getMTime()
- SplFileInfo::getCTime()
- SplFileInfo::getType()
- SplFileInfo::isWritable()
- SplFileInfo::isReadable()
- SplFileInfo::isExecutable()
- SplFileInfo::isFile()
- SplFileInfo::isDir()
- SplFileInfo::isLink()
- RecursiveDirectoryIterator::hasChildren()
Liste de paramètres
-
path
-
Le 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é.
-
flags
-
Les 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.
Valeurs de retour
Doit retourne autant d'éléments que stat() retourne.
Les valeurs inconnues ou indisponibles doivent prendre une valeur
raisonnable (généralement, 0
).
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
- stat() - Renvoie les informations à propos d'un fichier
- streamwrapper::stream_stat() - Lit les informations sur une ressource de fichier