array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.scandir.php', 1 => 'scandir', 2 => 'Получает список файлов и каталогов, расположенных по указанному пути', ), 'up' => array ( 0 => 'ref.dir.php', 1 => 'Функции для работы с каталогами', ), 'prev' => array ( 0 => 'function.rewinddir.php', 1 => 'rewinddir', ), 'next' => array ( 0 => 'book.fileinfo.php', 1 => 'FileInfo', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/dir/functions/scandir.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

scandir

(PHP 5, PHP 7, PHP 8)

scandir — Получает список файлов и каталогов, расположенных по указанному пути

Описание

scandir(string $directory, int $sorting_order = SCANDIR_SORT_ASCENDING, ?resource $context = null): array|false

Возвращает массив (array), содержащий имена файлов и каталогов, расположенных по пути, переданном в параметре directory.

Список параметров

directory

Сканируемый каталог.

sorting_order

По умолчанию сортировка производится в алфавитном порядке по возрастанию. Если необязательный параметр sorting_order установлен в значение SCANDIR_SORT_DESCENDING, сортировка производится в алфавитном порядке по убыванию. Если же он установлен в значение SCANDIR_SORT_NONE, то сортировка не производится.

context

За описанием параметра context обратитесь к разделу Потоки данного руководства.

Возвращаемые значения

Возвращает массив (array) имён файлов в случае успешного выполнения или false в случае возникновения ошибки. Если directory не является каталогом, возвращается false и генерируется сообщение об ошибке уровня E_WARNING.

Список изменений

Версия Описание
8.0.0 context теперь допускает значение null.

Примеры

Пример #1 Простой пример использования функции scandir()

<?php
$dir = '/tmp';
$files1 = scandir($dir);
$files2 = scandir($dir, SCANDIR_SORT_DESCENDING);

print_r($files1);
print_r($files2);
?>

Вывод приведённого примера будет похож на: 

Array
(
    [0] => .
    [1] => ..
    [2] => bar.php
    [3] => foo.txt
    [4] => somedir
)
Array
(
    [0] => somedir
    [1] => foo.txt
    [2] => bar.php
    [3] => ..
    [4] => .
)

Примечания

Подсказка

Вместо названий файлов функция принимает URL-адреса, если включили директиву fopen wrappers. Подробнее об определении названия файла рассказывает описание функции fopen(). Раздел «Протоколы и обёртки» также даёт ссылки на информацию о поддерживаемых обёртках, содержит замечания по работе с обёртками и приводит список предопределённых переменных, которые они дают.

Смотрите также