PHP opendir function

opendir

(PHP 3, PHP 4, PHP 5)

opendir -- Open directory handleDescriptionresource opendir ( string path [, resource context] )

Opens up a directory handle to be used in subsequent
closedir(), readdir(), and
rewinddir() calls.

Parameters

path

The directory path that is to be opened

context

For a description of the context parameter,
refer to the streams section of
the manual.

Return Values

Returns a directory handle resource on success, or
FALSE on failure.

If path is not a valid directory or the
directory can not be opened due to permission restrictions or
filesystem errors, opendir() returns FALSE and
generates a PHP error of level E_WARNING. You can suppress the error output of
opendir() by prepending
'@' to the
front of the function name.

ChangeLog

VersionDescription5.0.0 path supports the ftp://
URL wrapper.
4.3.0 path can also be any URL which supports
directory listing, however only the file://
URL wrapper supports this in PHP 4

Examples

Example 1. opendir() example

$dir = "/etc/php5/";

// Open a known directory, and proceed to read its contents
if (is_dir($dir)) {
if ($dh = opendir($dir)) {
while (($file = readdir($dh)) !== false) {
echo "filename: $file : filetype: " . filetype($dir . $file) . "\n";
}
closedir($dh);
}
}