is_file

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

is_file — Prüft, ob der Dateiname eine reguläre Datei ist

Beschreibung

function is_file(string $filename): bool

Prüft, ob der Dateiname eine reguläre Datei ist.

Parameter-Liste

filename: Pfad zur Datei.

Rückgabewerte

Gibt true zurück, wenn der Dateiname existiert und eine reguläre Datei ist, sonst false.

Hinweis: Weil PHPs Integer Typ vorzeichenbehaftet ist und viele Platformen 32bit Integer verwenden, können einige Dateisystem-Funktionen für Dateien größer als 2GB unerwartete Ergebnisse liefern.

Fehler/Exceptions

Im Fehlerfall wird eine E_WARNING ausgegeben.

Beispiele

Beispiel #1 is_file()-Beispiel

<?php
var_dump(is_file('eine_datei.txt')) . "\n";
var_dump(is_file('/usr/bin/')) . "\n";
?>

Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

bool(true)
bool(false)

Anmerkungen

Hinweis: Die Ergebnisse dieser Funktion werden zwischengespeichert. Weitere Details sind bei clearstatcache() zu finden.

Tipp

Seit PHP 5.0.0 kann diese Funktion mit einigen URL-Wrappern benutzt werden. Schauen Sie in der Liste unter Unterstützte Protokolle und Wrapper nach, welcher Wrapper die Funktionalität von stat() unterstützt.

Siehe auch

is_dir() - Prüft, ob der angegebene Dateiname ein Verzeichnis ist
is_link() - Prüft, ob der Dateiname ein symbolischer Link ist
SplFileInfo