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() - Получает строку из указателя на файл

Нашли ошибку?

Инструкция • Исправление • Сообщение об ошибке

＋Добавить

Примечания пользователей 4 notes

down

jo at durchholz dot org ¶

19 years ago

DrTebi at yahoo dot com is wrong. is_readable() checks whether you can do file_get_contents() or similar calls, no more, no less. If the location given returns a 500 or 403 error, you can still read() that (you'll simply get the error page), but it's still read()able. Using is_readable to check the validity of a URL is simply the wrong function.

down

pgl at yoyo dot org ¶

16 years ago

Note that is_readable() will return false for streams, eg, php://stdin.

down

johninen at gmail dot com ¶

5 months ago

This will return false on urls, even if file_get_contents() reads them. So, only for files.

down

arikan134 at gmail dot com ¶

9 years ago

is readable recursively. Check all sub directories and files readable
<?php
function is_readable_r($dir) {
    if (is_dir($dir)) {
        if(is_readable($dir)){
            $objects = scandir($dir);
            foreach ($objects as $object) {
                if ($object != "." && $object != "..") {
                    if (!is_readable_r($dir."/".$object)) return false;
                    else continue;
                }
            }    
            return true;    
        }else{
            return false;
        }
        
    }else if(file_exists($dir)){
        return (is_readable($dir));
        
    }
}

?>

＋Добавить