array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.file-exists.php', 1 => 'file_exists', 2 => 'Проверяет, содержит ли файловая система файл или каталог', ), 'up' => array ( 0 => 'ref.filesystem.php', 1 => 'Функции файловой системы', ), 'prev' => array ( 0 => 'function.file.php', 1 => 'file', ), 'next' => array ( 0 => 'function.file-get-contents.php', 1 => 'file_get_contents', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/filesystem/functions/file-exists.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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(), приводит раздел «Протоколы и обёртки».

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