is_dir
(PHP 4, PHP 5, PHP 7, PHP 8)
is_dir — Prüft, ob der angegebene Dateiname ein Verzeichnis ist
Beschreibung
$filename
): boolPrüft, ob der angegebene Dateiname ein Verzeichnis ist.
Parameter-Liste
-
filename
-
Pfad zur Datei. Wenn
filename
ein relativer Dateiname ist, so wird er auch relativ zu dem aktuellen Verzeichnis geprüft. Wennfilename
ein symbolischer oder harter Link ist, so wird der Link aufgelöst und geprüft. Falls 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
.
Fehler/Exceptions
Im Fehlerfall wird eine E_WARNING
ausgegeben.
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)
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.