streamWrapper::url_stat
(PHP 4 >= 4.3.2, PHP 5, PHP 7)
streamWrapper::url_stat — Получение информации о файле
Описание
$path
, int $flags
) : arrayЭтот метод вызывается в процессе выполнения любой из stat() функций, таких как:
- 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()
Список параметров
-
path -
Путь к файлу или его URL. Помните, что URL должен быть отделен символами :// , другие формы URL не поддерживаются.
-
flags -
Хранит дополнительные флаги, установленные API потоков. Может хранить одно или несколько приведенных ниже значений, объединенных операцией ИЛИ.
Флаг Описание STREAM_URL_STAT_LINK Для ресурсов, которые могут ссылаться на другие ресурсы (как например HTTP Location: forward, или символические ссылки файловой системы). Этот флаг указывает, что возвращаемая информация относится к самой ссылке, а не к ресурсу, на который она указывает. Этот используется при вызове функций lstat(), is_link() или filetype(). STREAM_URL_STAT_QUIET Если флаг установлен, обертка не должна вызывать никаких ошибок. Если нет, можно вызывать сообщения об ошибках с помощью функции trigger_error().
Возвращаемые значения
Должна возвращать столько элементов, сколько возвращает вызывающая
stat(). Неизвестные или недоступные значения
необходимо приводить к разумным значениям
(обычно к 0). Обратите особое внимание на mode, как описано в разделе stat().
Ошибки
Вызывает ошибку уровня
E_WARNING, если вызов к этому методу не удался
(например, не реализован).
Примечания
Замечание:
Свойство streamWrapper::$context будет обновлено, если корректный контекст был передан в вызываемую функцию.
Смотрите также
- stat() - Возвращает информацию о файле
- streamwrapper::stream_stat() - Получение информации о файловом ресурсе