file_exists - Проверяет наличие указанного файла или каталога
Вернуться к: Файловая система
file_exists
(PHP 4, PHP 5, PHP 7)
file_exists — Проверяет наличие указанного файла или каталога
Описание
$filename
)Проверяет наличие указанного файла или каталога.
Список параметров
-
filename
-
Путь к файлу или каталогу.
На платформах Windows, для проверки наличия файлов на сетевых ресурсах, используйте имена, подобные //computername/share/filename или \\computername\share\filename.
Возвращаемые значения
Возвращает TRUE
, если файл или каталог, указанный параметром
filename
, существует, иначе возвращает
FALSE
.
Замечание:
Данная функция возвращает
FALSE
для символических ссылок, указывающих на несуществующие файлы.
Если файлы недоступны из-за ограничений, налагаемых
безопасным режимом,
то данная функция вернет FALSE
. Однако, эти файлы все еще могут быть
подключены, если они
располагаются в каталоге
safe_mode_include_dir.
Замечание:
Проверка происходит с помощью реальных UID/GID, а не эффективных идентификаторов.
Замечание: Так как тип integer в PHP является целым числом со знаком и многие платформы используют 32-х битные целые числа, то некоторые функции файловых систем могут возвращать неожиданные результаты для файлов размером больше 2ГБ.
Примеры
Пример #1 Проверка существования файла
<?php
$filename = '/path/to/foo.txt';
if (file_exists($filename)) {
echo "Файл $filename существует";
} else {
echo "Файл $filename не существует";
}
?>
Ошибки
В случае неудачного завершения работы генерируется ошибка уровня E_WARNING
.
Примечания
Замечание: Результаты этой функции кэшируются. Более подробную информацию смотрите в разделе clearstatcache().
Начиная с PHP 5.0.0, эта функция также может быть использована с некоторыми обертками url. Список оберток, поддерживаемых семейством функций stat(), смотрите в Поддерживаемые протоколы и обработчики (wrappers).
Смотрите также
- is_readable() - Определяет существование файла и доступен ли он для чтения
- is_writable() - Определяет, доступен ли файл для записи
- is_file() - Определяет, является ли файл обычным файлом
- file() - Читает содержимое файла и помещает его в массив
Вернуться к: Файловая система