is_file

(PHP 4, PHP 5, PHP 7)

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

Beschreibung

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.

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)

Fehler/Exceptions

Im Fehlerfall wird eine E_WARNING ausgegeben.

Anmerkungen

Hinweis: Die Ergebnisse dieser Funktion werden gecached. Weitere Details erhalten Sie bei clearstatcache().

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