scandir
(PHP 5, PHP 7)
scandir — Получает список файлов и каталогов, расположенных по указанному пути
Описание
$directory
, int $sorting_order = SCANDIR_SORT_ASCENDING
, resource $context = ?
) : array
Возвращает массив (array), содержащий имена файлов и каталогов,
расположенных по пути, переданном в параметре directory.
Список параметров
-
directory -
Сканируемый каталог.
-
sorting_order -
По умолчанию сортировка производится в алфавитном порядке по возрастанию. Если необязательный параметр
sorting_orderустановлен в значениеSCANDIR_SORT_DESCENDING, сортировка производится в алфавитном порядке по убыванию. Если же он установлен в значениеSCANDIR_SORT_NONE, то сортировка не производится. -
context -
За описанием параметра
contextобратитесь к разделу Потоки данного руководства.
Возвращаемые значения
Возвращает массив (array) имен файлов в случае успеха или
false в случае ошибки. Если directory не
является каталогом, возвращается false и генерируется сообщение
об ошибке уровня E_WARNING.
Примеры
Пример #1 Простой пример использования функции scandir()
<?php
$dir = '/tmp';
$files1 = scandir($dir);
$files2 = scandir($dir, 1);
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(). Смотрите также список поддерживаемых оберток URL, их возможности, замечания по использованию и список предопределенных констант в разделе Поддерживаемые протоколы и обертки.