is_dir
(PHP 4, PHP 5)
is_dir — Prüft, ob der angegebene Dateiname ein Verzeichnis ist
Beschreibung
$filename
)Prüft, ob der angegebene Dateiname ein Verzeichnis ist.
Parameter-Liste
-
filename -
Pfad zur Datei. Wenn
filenameein relativer Dateiname ist, so wird er auch relativ zu dem aktuellen Verzeichnis geprüft. Wennfilenameein symbolischer oder harter Link ist, so wird der Link aufgelöst und geprüft. Falls der Safe Mode oder open_basedir aktiviert ist, können weitere Einschränkungen berücksichtigt werden.
Rückgabewerte
Gibt TRUE zurück, wenn der Dateiname existiert und ein Verzeichnis
ist, sonst FALSE.
Beispiele
Beispiel #1 is_dir()-Beispiel
<?php
var_dump(is_dir('eine_datei.txt'));
var_dump(is_dir('kein_verzeichnis/abc'));
var_dump(is_dir('..')); //ein Verzeichnis hoch
?>
Das oben gezeigte Beispiel erzeugt folgende Ausgabe:
bool(false) bool(false) bool(true)
Fehler/Exceptions
Im Fehlerfall wird eine E_WARNING ausgegeben.
Anmerkungen
Hinweis: Die Ergebnisse dieser Funktion werden gecached. Weitere Details erhalten Sie bei clearstatcache().
Seit PHP 5.0.0 kann diese Funktion mit einigen URL-Wrappern benutzt werden. Schauen Sie in der Liste unter Unterstützte Protokolle and Wrappers nach, welcher Wrapper die Funktionalität von stat() unterstützt.