streamWrapper::url_stat

(PHP 4 >= 4.3.2, PHP 5, PHP 7, PHP 8)

streamWrapper::url_stat — Отримання інформації про файл

Опис

public streamWrapper::url_stat(string $path, int $flags): array|false

Цей метод викликається в процесі виконання будь-якої 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()

Значення, що повертаються

Має повертатися масив (array) з тими самими елементами, що у stat(). Невідомі або недоступні значення необхідно призводити до розумних значень (зазвичай до ). Обратите особое внимание наmode, як описано в розділі stat(). У разі виникнення помилки повертає false

Помилки

Викликає помилку рівня E_WARNING, якщо виклик до цього методу не вдалося (наприклад, не реалізовано).

Примітки

Зауваження :

Властивість streamWrapper::$context буде оновлено, якщо коректний контекст був переданий у функцію, що викликається.

Дивіться також

• stat() - Повертає інформацію про файл
• streamwrapper::stream_stat() - Отримання інформації про файловий ресурс