file_exists
(PHP 4, PHP 5, PHP 7, PHP 8)
file_exists — Prüft, ob eine Datei oder ein Verzeichnis existiert
Beschreibung
$filename
): boolPrü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.
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.
Fehler/Exceptions
Im Fehlerfall wird eine E_WARNING
ausgegeben.
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";
}
?>
Anmerkungen
Hinweis: Die Ergebnisse dieser Funktion werden zwischengespeichert. Weitere Details sind bei clearstatcache() zu finden.
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
- SplFileInfo