is_file

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

is_file — Tells whether the filename is a regular file

Опис

is_file(string $filename): bool

Tells whether the given file is a regular file. If filename is a symbolic link, it will resolve the symlink and will give information about the referred file.

Параметри

filename: Path to the file.

Значення, що повертаються

Returns true if the filename exists and is a regular file, false otherwise.

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

Помилки/виключення

Під час збоїв буде видаватись E_WARNING.

Приклади

Приклад #1 is_file() example

<?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() - Tells whether the filename is a directory
is_link() - Tells whether the filename is a symbolic link
SplFileInfo