is_file

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

is_fileСообщает, ведёт ли путь к стандартному файлу

Описание

is_file(string $filename): bool

Функция определяет, ведёт ли путь к стандартному файлу. Функция разрешит символическую ссылку и вернёт информацию о файле, на который указывает ссылка, если в аргументе 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(), смотрите в разделе Протоколы и обёртки.

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

  • is_dir() - Определяет, является ли имя файла директорией
  • is_link() - Определяет, является ли файл символической ссылкой
  • SplFileInfo