PHP readdir Function: Reading Directory Entries

Function signature: string readdir(resource $dir_handle) Returns the next filename from the directory handle opened by opendir(). Filenames are returned in the order they appear in the filesystem. On failure, the function returns FALSE.

Parameter $dir_handle – a directory handle resource previously obtained via opendir().

Return value

On success, the filename string.

On failure, FALSE.

Example (correct usage)

<?php
// Note: before 4.0.0-RC2 the !== operator does not exist
$handle = opendir('/path/to/files');
echo "Directory handle: $handle
";
echo "Files:
";
/* This is the correct way to iterate a directory */
while (false !== ($file = readdir($handle))) {
    echo "$file
";
}
closedir($handle);
?>

Example (incorrect usage)

<?php
while ($file = readdir($handle)) {
    echo "$file
";
}
closedir($handle);
?>