PHP: streamWrapper::url_stat

Description

public array streamWrapper::url_stat ( string $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

L'URL du fichier dont il faut lire les informations.

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