scandir

(PHP 5, PHP 7)

scandir - 列出指定路径内的文件和目录

描述

array scandir ( string $directory [, int $sorting_order = SCANDIR_SORT_ASCENDING [, resource $context ]] )

从中返回一组文件和目录directory。

参数

directory

将被扫描的目录。

sorting_order

默认情况下，排序的顺序是按升序排列的字母顺序。如果可选sorting_order设置为SCANDIR_SORT_DESCENDING，则排序顺序按字母顺序降序排列。如果设置为SCANDIR_SORT_NONE，则结果未排序。

context

有关context参数的说明，请参阅手册的流部分。

返回值

成功返回时文件名数组或失败时返回FALSE。如果directory不是目录，则返回布尔值FALSE，并生成级别错误E_WARNING。

Changelog

版本	描述
5.4.0	sorting_order 常量被添加。在以前的版本中，任何非零值都会导致降序。因此，对于所有 PHP 版本，升序使用0，降序使用1。在PHP 5.4.0之前，不存在SCANDIR_SORT_NONE行为的选项。

示例

Example #1 A simple scandir() example

<?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] => .
)

注意

提示

如果fopen包装已经启用，那么可以使用URL作为文件名。有关如何指定文件名的更多详细信息，请参阅fopen()。请参阅支持的协议和包装以获取有关各种包装具有哪些功能的信息的链接，关于它们的用法的注释以及它们可能提供的任何预定义变量的信息。

另请参阅

readdir() - 从目录句柄中读取条目

glob() - 查找与模式匹配的路径名

is_dir() - 告诉文件名是否是一个目录

sort() - 对数组进行排序

← rewinddir

Fileinfo →