dir()

(PHP 4, PHP 5, PHP 7)

返回一个 Directory 类实例

说明

以面向对象的方式访问目录。打开$directory参数指定的目录。

参数

被打开的目录

Note:在 PHP 5.0.0中增加了对上下文（Context）的支持。有关上下文（Context）的说明参见Streams。

返回值

成功的话，返回一个Directory类实例,参数错误的情况下返回NULL，其它错误情况返回FALSE。

范例

Example #1dir()示例

请特别注意下面示例中Directory::read()函数返回值的判断方式。我们严格测试（值相等，并且类型相同，请参考比较运算符）返回值等于FALSE，因为有些情况下，目录名可能"等于"FALSE，导致跳出循环。

以上例程的输出类似于：

Handle: Resource id #2
Path: /etc/php5
.
..
apache
cgi
cli

注释

Note:

目录条目返回的顺序依赖于系统。

Regarding samuel's comment about the dir() function not supporting Unicode properly, it's all in the encoding. The function does NOT internally change Unicode characters into question marks (?), as I was first led to believe. If you simply try to output them in UTF-8, they'll show up just right.

This one's pretty nice. After getting frustrated for hunting down .jpg files in my massive music collection (PHP would run out of memory), I thought there should be a preg_ls function.
function preg_ls ($path=".", $rec=false, $pat="/.*/") {
  // it's going to be used repeatedly, ensure we compile it for speed.
  $pat=preg_replace("|(/.*/[^S]*)|s", "\\1S", $pat);
  //Remove trailing slashes from path
  while (substr($path,-1,1)=="/") $path=substr($path,0,-1);
  //also, make sure that $path is a directory and repair any screwups
  if (!is_dir($path)) $path=dirname($path);
  //assert either truth or falsehoold of $rec, allow no scalars to mean truth
  if ($rec!==true) $rec=false;
  //get a directory handle
  $d=dir($path);
  //initialise the output array
  $ret=Array();
  //loop, reading until there's no more to read
  while (false!==($e=$d->read())) {
    //Ignore parent- and self-links
    if (($e==".")||($e=="..")) continue;
    //If we're working recursively and it's a directory, grab and merge
    if ($rec && is_dir($path."/".$e)) {
      $ret=array_merge($ret,preg_ls($path."/".$e,$rec,$pat));
      continue;
    }
    //If it don't match, exclude it
    if (!preg_match($pat,$e)) continue;
    //In all other cases, add it to the output array
    $ret[]=$path."/".$e;
  }
  //finally, return the array
  return $ret;
}
Not bad for a mere 18 lines, don't you think?
Example use:
foreach (preg_ls("/etc/X11", true, "/.*\.conf/i") as $file) echo $file."\n";
Output: 
/etc/X11/xkb/README.config
/etc/X11/xorg.conf-vesa
/etc/X11/xorg.conf~
/etc/X11/gui.conf
/etc/X11/xorg.conf
/etc/X11/xorg.conf-fbdev

Here my solution how to do effective recursiv directory listing.
Have fun. 

鹏仔微信 15129739599 鹏仔QQ344225443 鹏仔前端 pjxi.com 共享博客 sharedbk.com