is_readable

(PHP 4, PHP 5, PHP 7, PHP 8)

is_readableОпределяет существование файла и доступен ли он для чтения

Описание

is_readable(string $filename): bool

Возвращает true, если файл существует и доступен для чтения.

Список параметров

filename

Путь к файлу.

Возвращаемые значения

Возвращает true, если файл или директория, указанная в filename существует и доступна для чтения, иначе возвращает false.

Ошибки

При сбое функция генерирует ошибку уровня E_WARNING.

Примеры

Пример #1 Пример использования функции is_readable()

<?php
$filename
= 'test.txt';
if (
is_readable($filename)) {
echo
'Файл доступен для чтения';
} else {
echo
'Файл недоступен для чтения';
}
?>

Примечания

Не забывайте, что PHP может обращаться к файлам от имени пользователя, от которого запущен веб-сервер (часто 'nobody').

Замечание: Результаты функции кешируются. Подробнее о кешировании рассказывает описание функции clearstatcache().

Подсказка

Начиная с PHP 5.0.0 функция научилась работать с отдельными URL-обёртками. Список обёрток, которые поддерживаются семейством функций stat(), приводит раздел «Протоколы и обёртки».

Замечание:

Проверка производится с использованием реальных UID/GID вместо эффективных.

Эта функция может возвращать true для директорий. Чтобы отличить файл от директории можно воспользоваться функцией is_dir().

Смотрите также

  • is_writable() - Определяет, доступен ли файл для записи
  • file_exists() - Проверяет, содержит ли файловая система файл или каталог
  • fgets() - Получает строку из указателя на файл