is_file

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

is_fileTells 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().

Прогляньте також