is_dir

(PHP 4, PHP 5, PHP 7)

is_dirPrüft, ob der angegebene Dateiname ein Verzeichnis ist

Beschreibung

is_dir ( string $filename ) : bool

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 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 und Wrapper 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