BlaBla.cn

PHP: scandir - Manual

BlaBla.cn

DOM

Directories

Last updated: Wed, 19 Mar 2008

scandir

(PHP 5)

scandir — 列出指定路径中的文件和目录

说明

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

返回一个 array，包含有 directory 中的文件和目录。

参数

directory: 要被浏览的目录
sorting_order: 默认的排序顺序是按字母升序排列。如果使用了可选参数 sorting_order （设为 1），则排序顺序是按字母降序排列。
context: context 参数的说明见手册中的 Streams API 一章。

返回值

成功则返回包含有文件名的 array，如果失败则返回 FALSE 。如果 directory 不是个目录，则返回布尔值 FALSE 并生成一条 E_WARNING 级的错误。

范例

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

Example#2 scandir() 在 PHP 4 中的实现

  <?php 
$dir   =   "/tmp"  ; 
  $dh    =   opendir  (  $dir  ); 
while (  false   !== (  $filename   =   readdir  (  $dh  ))) { 
      $files  [] =   $filename  ; 
} 
 
  sort  (  $files  ); 
 
  print_r  (  $files  ); 
 
  rsort  (  $files  ); 
 
  print_r  (  $files  ); 
 
  ?>

上例的输出类似于：

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

注释

Tip

如果 “fopen wrappers”已经被激活，则在本函数中可以把 URL 作为文件名来使用。请参阅 fopen() 函数来获取怎样指定文件名的详细信息以及支持 URL 封装协议的列表：支持的协议／封装协议列表。

参见

DOM

Directories

Last updated: Wed, 19 Mar 2008

BlaBla.cn