file_exists

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

file_existsПроверяет существование указанного файла или каталога

Описание

file_exists(string $filename): bool

Проверяет наличие указанного файла или каталога.

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

filename

Путь к файлу или каталогу.

На платформах Windows, для проверки наличия файлов на сетевых ресурсах, используйте имена, подобные //computername/share/filename или \\computername\share\filename.

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

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

Замечание:

Данная функция возвращает false для символических ссылок, указывающих на несуществующие файлы.

Замечание:

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

Замечание: На 32-разрядных платформах отдельные PHP-функции для работы с файловой системой иногда возвращают неожиданные результаты для файлов размером больше 2 ГБ, поскольку в PHP тип integer хранит числа со знаком, а архитектура платформы ограничивает диапазон положительных значений типа.

Ошибки

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

Примеры

Пример #1 Проверка существования файла

<?php
$filename
= '/path/to/foo.txt';

if (
file_exists($filename)) {
echo
"Файл $filename существует";
} else {
echo
"Файл $filename не существует";
}
?>

Примечания

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

Подсказка

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

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

  • is_readable() - Определяет существование файла и доступен ли он для чтения
  • is_writable() - Определяет, доступен ли файл для записи
  • is_file() - Сообщает, ведёт ли путь к стандартному файлу
  • file() - Читает содержимое файла и помещает его в массив
  • SplFileInfo