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, если символическая ссылка указывает на файл, который не содержится в файловой системе.

Замечание:

Функция игнорирует текущие SUID- и GUID-биты файла или каталога и проверяет пути по реальным идентификаторам пользователя и группы PHP-процесса — 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