PHP dir() Function

Example

Use the dir() function:

<?php
$d = dir(getcwd());

echo "Handle: " . $d->handle . "<br>";
echo "Path: " . $d->path . "<br>";

while (($file = $d->read()) !== false){
echo "filename: " . $file . "<br>";
}
$d->close();
?>

Result:

Handle: Resource id #2
Path: /etc/php
filename: .
filename: ..
filename: ajax.gif
filename: books.xml
filename: cdcatalog.xml
filename: cd_catalog.xml
filename: default.html
filename: demo_array.html
filename: demo_array.htm
...
...
...

Definition and Usage

The dir() function returns an instance of the Directory class. This function is used to read a directory, which includes the following:

The given directory is opened
The two properties handle and path of dir() are available
Both handle and path properties have three methods: read(), rewind(), and close()

Syntax

dir( directory, context)

Parameter Values

Parameter	Description
directory	Required. Specifies the directory to open
context	Optional.

Technical Details

Return Value:	An instance of the Directory class. FALSE on failure
PHP Version:	4.0+

❮ PHP Directory Reference