W3cubDocs

/PHP

readdir

(PHP 4, PHP 5, PHP 7, PHP 8)

readdir — Read entry from directory handle

Description

readdir(?resource $dir_handle = null): string|false

Returns the name of the next entry in the directory. The entries are returned in the order in which they are stored by the filesystem.

Parameters

dir_handle
A directory handle resource previously opened with opendir(). If dir_handle is null the last handle opened using opendir() will be used.

Return Values

Returns the entry name on success, or false on failure.

Warning

This function may return Boolean false, but may also return a non-Boolean value which evaluates to false. Please read the section on Booleans for more information. Use the === operator for testing the return value of this function.

Changelog

Version Description
8.5.0 Using null for dir_handle is now deprecated. Instead, the last opened directory handle should be explicitly provided.
8.0.0 dir_handle is now nullable.

Examples

For a complete example refer to the opendir() documentation.

See Also

  • opendir() - Open directory handle
  • rewinddir() - Rewind directory handle
  • closedir() - Close directory handle
  • dir() - Return an instance of the Directory class
  • is_dir() - Tells whether the filename is a directory
  • glob() - Find pathnames matching a pattern
  • scandir() - List files and directories inside the specified path

© 1997–2025 The PHP Documentation Group
Licensed under the Creative Commons Attribution License v3.0 or later.
https://www.php.net/manual/en/function.readdir.php