is_dir()

(PHP 4, PHP 5, PHP 7)

判断给定文件名是否是一个目录

说明

判断给定文件名是否是一个目录。

参数

如果文件名存在并且为目录则返回TRUE。如果$filename是一个相对路径，则按照当前工作目录检查其相对路径。If$filenameis a symbolic or hard link then the link will be resolved and checked. If you have enabled安全模式,oropen_basedirfurther restrictions may apply.

返回值

如果文件名存在，并且是个目录，返回TRUE，否则返回FALSE。

范例

Example #1is_dir()例子

以上例程会输出：

bool(false)
bool(false)
bool(true)

错误／异常

失败时抛出E_WARNING警告。

注释

Note:此函数的结果会被缓存。参见clearstatcache()以获得更多细节。

自 PHP 5.0.0 起,此函数也用于某些URL 包装器。请参见支持的协议和封装协议以获得支持stat()系列函数功能的包装器列表。

参见

• chdir() 改变目录
• dir() 返回一个 Directory 类实例
• opendir() 打开目录句柄
• is_file() 判断给定文件名是否为一个正常的文件
• is_link() 判断给定文件名是否为一个符号连接

Just a note for anyone who encounters is_dir() returning false on CIFS mount points or directories within those mount points on 2.6.31 and newer kernels: Apparently in new kernels they've started using the CIFS serverino option by default. With Windows shares this causes huge inode numbers and which apparently can cause is_dir() to return false. Adding the noserverino option to the CIFS mount will prevent this. This may only occur on 32 systems but I don't have a 64 bit install to test against.

Note that on Linux is_dir returns FALSE if a parent directory does not have +x (executable) set for the php process.

This is the "is_dir" function I use to solve the problems :
function Another_is_dir ($file)
{
  if ((fileperms("$file") & 0x4000) == 0x4000)
    return TRUE;
  else
    return FALSE;
}
or, more simple :
function Another_is_dir ($file)
{ 
return ((fileperms("$file") & 0x4000) == 0x4000);
}
I can't remember where it comes from, but it works fine.

Note that this functions follows symbolic links. It will return true if the file is actually a symlink that points to a directory.
An example:

Prints out:
bool(true)
(Windows Note: Under recent versions of Windows you can set symlinks as long as you're administrator, but you cannot remove directory symlinks with "unlink()", you will have to use "rmdir testlink" from the shell to get rid of it.)

My solution to the problem that you must include the full path to make "is_dir" work properly as a complete example: 

One note regarding checking for empty directories :
>>echo (count(glob("$dir/*")) === 0) ? 'Empty' : 'Not empty';
This does not work correctly on Linux.
The '.' and '..' will always be returned even if no files are present in the directory.

Running PHP 5.2.0 on Apache Windows, I had a problem (likely the same one as described by others) where is_dir returned a False for directories with certain permissions even though they were accessible.
Strangely, I was able to overcome the problem with a more complete path. For example, this only displays "Works" on subdirectories with particular permissions (in this directory about 1 out of 3):
$d = opendir("./albums/mydir");
while(false !== ($f = readdir($d))) {
  echo "
";
    if(is_dir($f)) {
      echo "Works:" . $f . "";
    }
}
However, this works properly for all directories:
$d = opendir("./albums/mydir");
while(false !== ($f = readdir($d))) {
  echo "
";
    $dName = "./albums/mydir/" . $f;
    if(is_dir($dName)) {
      echo "Works:" . $dName . "";
    }
}
I don't understand the hit-and-miss of the first code, but maybe the second code can help others having this problem.

When trying (no 'pear') to enumerate mounted drives on a win32 platform (Win XP SP3, Apache/2.2.11, PHP/5.2.9), I used:

which yielded:
A: C: D: E: F: G: H: I:

PITFALL in sub dir processing
After struggeling with a sub-dir processing (some subdirs were skipped) AND reading the posts, I realized that virutally no-one clearly told what were wrong.
The common traverse dir code was:
-----------------------------------------
opendir("myphotos"); // Top dir to process from (example)
 
while (false !== ($fname = readdir($h_dir))) { // process current dir (read a directory entry)
  if ($fname{0} == '.') continue; // skip dirs . and .. by first char test
  if (is_dir($fname)) call_own_subdir_process; // process this subdir by calling a routine
  }
PROBLEM IS :
The "is_dir()" must have the FULL PATH or it will skip some dirs. So the above code need to INSERT THE PATH before the filename. This would give this change in above...
  if (is_dir("myphotos\" . $fname)) call_own_subdir_process; // skip subdirs
The pitfall really was, that without full path some subdirs were found...hope this clears all up

Note that is_dir() also works with ftp://.
For example :

But note that if the connexion fails due to invalide credentials, this will consider that the folder doesn't exist and will return FALSE.

Note that there quite a few articles on the net that imply that commands like is_dir, opendir, readdir cannot read paths with spaces.
On a linux box, THAT is not an issue. 
Sample test code;
 $dir = "Images/Soma ALbum Name with spaces";
   
echo $dir."
";
// Open a directory, and read its contents
if (is_dir($dir)){
 echo $dir."
"; // will not appear if above fails
  if ($dh = opendir($dir)){
   echo $dir."
"; // will not appear if above fails
   while (($file = readdir($dh)) !== false){
    echo "filename:" . $file . "
";
    echo $dir."
"; // will not appear if above fails
   }
   closedir($dh);
  }
}

Here is another way to test if a directory is empty, which I think is much simpler than those posted below: 

better ;)

Ah ha! Maybe this is a bug, or limitation to be more precise, of php. See http://bugs.php.net/bug.php?id=27792
A workaround is posted on the page (above) and seems to work for me:
function is_dir_LFS($path){
 return (('d'==substr(exec("ls -dl '$path'"),0,1))?(true):(false));
}
PS: I'm using PHP 4.3.10-16, posts report this problem up to 5.0

this function bypasses open_basedir restrictions.

example:

output:
Warning: open_basedir restriction in effect

output:
true (or false, depending whether it is or not...)
---
visit puremango.co.uk for other such wonders

use this function to get all files inside a directory (including subdirectories) 

An even better (PHP 5 only) alternative to "Davy Defaud's function": 

NOTE: you should obviously be checking beforehand if $dir is actually a directory, and that it is readable, as only relying on this you would assume that in both cases you have a non-empty readable directory.

When I run a scandir I always run a simple filter to account for file system artifacts (especially from a simple ftp folder drop) and the "." ".." that shows up in every directory: 

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