file_exists

(PHP 4, PHP 5, PHP 7)

file_existsPrüft, ob eine Datei oder ein Verzeichnis existiert

Beschreibung

file_exists ( string $filename ) : bool

Prüft, ob eine Datei oder ein Verzeichnis existiert.

Parameter-Liste

filename

Pfad zu der Datei oder dem Verzeichnis

Zum Prüfen von Dateien auf Windows network shares verwenden Sie bitte //computername/share/filename oder \\computername\share\filename.

Rückgabewerte

Gibt TRUE zurück, wenn die Datei oder das Verzeichnis, die durch filename spezifiziert sind, existieren; ansonsten FALSE.

Hinweis:

Diese Funktion gibt FALSE für symbolische Links zurück, die auf nicht existierende Dateien verweisen.

Warnung

Diese Funktion gibt FALSE für Dateien zurück, die wegen safe mode-Einschränkungen nicht zugänglich sind. Diese Dateien können jedoch trotzdem mit include inkludiert werden, wenn sie in safe_mode_include_dir. gespeichert sind.

Hinweis:

Die Prüfung wird mit der realen UID/GID anstelle der effektiven durchgeführt.

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 Prüfung, ob eine Datei existiert

<?php
$filename 
'/path/to/foo.txt';

if (
file_exists($filename)) {
    echo 
"Die Datei $filename existiert";
} else {
    echo 
"Die Datei $filename existiert nicht";
}
?>

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_readable() - Prüft, ob eine Datei existiert und lesbar ist
  • is_writable() - Prüft, ob in eine Datei geschrieben werden kann
  • is_file() - Prüft, ob der Dateiname eine reguläre Datei ist
  • file() - Liest eine komplette Datei in ein Array