is_dir

(PHP 4, PHP 5)

is_dir — Prüft, ob der angegebene Dateiname ein Verzeichnis ist

Beschreibung

bool is_dir ( string $filename )

Prü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. Wenn filename ein 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().

Tipp

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.

Siehe auch

chdir() - Wechseln des Verzeichnisses
dir() - Gibt eine Instanz der Directory Klasse zurück
opendir() - Öffnen eines Verzeichnis-Handles
is_file() - Prüft, ob der Dateiname eine reguläre Datei ist
is_link() - Prüft, ob der Dateiname ein symbolischer Link ist