(PHP 4, PHP 5, PHP 7)
readdir — Liest einen Eintrag aus einem Verzeichnis-Handle
$dir_handle
] ) : stringGibt den Namen des nächsten Eintrags des Verzeichnisses zurück. Die Einträge werden in der Reihenfolge zurück gegeben, in der sie innerhalb des Filesystems angelegt wurden.
Gibt bei Erfolg den Namen des Eintrags zurück. Im Fehlerfall wird FALSE zurückgegeben.
Diese Funktion kann sowohl das
boolsche FALSE zurückliefern, als auch einen nicht-boolschen Wert, welcher zu FALSE ausgewertet wird.
Weitere Informationen entnehmen Sie bitte dem Abschnitt über die
boolschen Typen. Benutzen Sie deshalb
den === Operator,
um den Rückgabewert dieser Funktion zu überprüfen.
Beispiel #1 Alle Einträge eines Verzeichnisses auflisten
Bitte beachten Sie die Art und Weise, in der die Rückgabewerte von
readdir() in untenstehenden Beispielen geprüft werden.
Wir testen explizit, ob der Rückgabewert identisch (also inhaltlich und
typgleich -- siehe Kapitel Vergleichs-Operatoren
für weitere Informationen) zu FALSE ist, andernfalls würde jeder
Verzeichnis-Eintrag, dessen Name als FALSE ausgewertet wird, das
Durchlaufen der Schleife beenden (z.B. ein Verzeichnis namens "0").
<?php
if ($handle = opendir('/path/to/files')) {
echo "Verzeichnis-Handle: $handle\n";
echo "Einträge:\n";
/* Das ist der korrekte Weg, ein Verzeichnis zu durchlaufen. */
while (false !== ($entry = readdir($handle))) {
echo "$entry\n";
}
/* Dies ist der FALSCHE Weg, ein Verzeichnis zu durchlaufen. */
while ($entry = readdir($handle)) {
echo "$entry\n";
}
closedir($handle);
}
?>
Beispiel #2 Listet alle Einträge des aktuellen Verzeichnisses auf und blendet dabei . und .. aus.
<?php
if ($handle = opendir('.')) {
while (false !== ($entry = readdir($handle))) {
if ($entry != "." && $entry != "..") {
echo "$entry\n";
}
}
closedir($handle);
}
?>