streamWrapper::url_stat
(PHP 4 >= 4.3.2, PHP 5, PHP 7, PHP 8)
streamWrapper::url_stat — Lit les informations sur un fichier
Description
Cette méthode est appelée en réponse à toutes les fonctions liées à stat(), telles que :
- 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 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.
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
add a note
