is_readable

(PHP 4, PHP 5)

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

Описание

bool is_readable ( string $filename )

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

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

filename: Путь к файлу.

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

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

Примеры

Пример #1 is_readable() example


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

Ошибки

В случае неудачного завершения работы генерируется ошибка уровня E_WARNING.

Примечания

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

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

Подсказка

Начиная с PHP 5.0.0, эта функция также может быть использована с некоторыми обертками url. Список оберток, поддерживаемых семейством функций stat(), смотрите в Поддерживаемые протоколы и обработчики (wrappers).

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

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

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

is_uploaded_file

is_link

[edit] Last updated: Fri, 25 May 2012

add a note User Contributed Notes is_readable

pgl at yoyo dot org 31-Jul-2009 07:13


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

jascha át gmx dót com 07-Nov-2006 06:58


Safe_mode restrictions ignored means:

cant read by read() so is_readable() = false.

even if safe_mode_include_dir is set and include does works, is_readable() is false to. :(

(php5)

jo at durchholz dot org 30-Jan-2006 09:15


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.

DrTebi at yahoo dot com 13-Oct-2005 09:22


Be careful when using is_readable on symbolic links.



is_readable will return true if the file the symbolic link is pointing to is readable.



The problem is that if the server does NOT allow to follow symbolic links, is_readable will still return true, but e.g. redirecting to the sybolic link will not work. For Apache, make sure that at the server, virtual host configuration level, or inside a directory container you have set

Options +FollowSymLinks



As an example, let's say you have at the document root directory:

index.php -- the script using is_readable

my_linked_page.html -- a regular HTML page

my_link -- a link pointing to my_linked_page.html



Now in index.php:

<?php

if (is_readable('my_link')) {

  header('Location: /my_link');

}

?>



If FollowSymLinks is forbidden, this will not work, if allowed, it will.

26-Jul-2005 07:08


Sometimes in situations where file_exists fails (returns false even though the file does exist) stat will work.

add a note