opendir
(PHP 3, PHP 4 , PHP 5)
opendir -- Open directory handle
Description
resource
opendir ( string path )
Returns a directory handle to be used in subsequent
closedir(), readdir(), and
rewinddir() calls.
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.
Example 1. opendir() example
<?php
$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);
}
}
?>
|
The above example will output
something similar to: filename: . : filetype: dir
filename: .. : filetype: dir
filename: apache : filetype: dir
filename: cgi : filetype: dir
filename: cli : filetype: dir |
|
As of PHP 4.3.0 path can also
be any URL which supports directory listing, however only the file://
URL wrapper supports this in PHP 4.3. As of
PHP 5.0.0, support for the ftp://
URL wrapper is included as well.
See also is_dir(),
readdir(), and
Dir