(PHP 4, PHP 5, PHP 7, PHP 8)
is_file — Сообщает, ведёт ли путь к стандартному файлу
Функция определяет, ведёт ли путь к стандартному файлу. Функция разрешит символическую ссылку
и вернёт информацию о файле, на который указывает ссылка, если в аргументе
filename
указали путь к символической ссылке.
filename
Путь к файлу.
Функция возвращает true
, если локальная система содержит
стандартный файл по заданному пути, иначе возвращает false
.
Замечание: На 32-разрядных платформах отдельные PHP-функции для работы с файловой системой иногда возвращают неожиданные результаты для файлов размером больше 2 ГБ, поскольку в PHP тип integer хранит числа со знаком, а архитектура платформы ограничивает диапазон положительных значений типа.
При сбое функция генерирует ошибку уровня E_WARNING
.
Пример #1 Пример проверки функцией is_file() того, ведёт ли путь к стандартному файлу
<?php
var_dump(is_file('a_file.txt')) . "\n";
var_dump(is_file('/usr/bin/')) . "\n";
?>
Результат выполнения приведённого примера:
bool(true) bool(false)
Замечание: Результаты функции кешируются. Подробнее о кешировании рассказывает описание функции clearstatcache().
Начиная с PHP 5.0.0, эта функция также может быть использована с некоторыми обёртками url. Список обёрток, поддерживаемых семейством функций stat(), смотрите в разделе Протоколы и обёртки.