PHP Manual»Функції для роботи з теками»opendir

opendir

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

opendir — Open directory handle

Опис

function opendir(string $directory, ?resource $context = null): resource|false

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

Параметри

directory: The directory path to open.
context: For a description of the context parameter, refer to the streams section of the manual.

Значення, що повертаються

Returns a directory handle on success, або false в разі помилки

Помилки/виключення

Під час збоїв буде видаватись E_WARNING.

This may happen if directory is not a valid directory, the directory can not be opened due to permission restrictions, or due to filesystem errors.

Журнал змін

Версія	Опис
8.0.0	`context` is now nullable.

Приклади

Приклад #1 List all entries in a directory, skipping the special . and .. directories

Because file and directory names can be strings that PHP considers "falsy" (e.g. a directory named "0") and readdir() returns false when it has read all entries in a directory one needs to use the === comparison operator to properly distinguish between a directory entry whose name is "falsy" and having read all entries of the directory.

<?php

if ($handle = opendir('/path/to/files')) {
    echo "Entries:\n";

    /* Correctly handling directory entries that may be considered falsy */
    while (false !== ($entry = readdir($handle))) {
        if ($entry === '.' || $entry === '..') {
            continue;
        }
        echo "$entry\n";
    }

    closedir($handle);
}
?>

Поданий вище приклад виведе щось схоже на:

Entries:
base
en
fr
output.md
test.php

Прогляньте також

readdir() - Read entry from 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