is_dir

(PHP 4, PHP 5, PHP 7, PHP 8)

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

is_dir(string $filename): bool

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

filename: 文件路径，如果 filename 是相对文件名，会相对于当前工作目录进行检查。如果 filename 是符号链接或者硬链接，然后解析链接并检查。如果启用了 open_basedir，则会应用更多限制。

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

失败时抛出 E_WARNING 警告。

示例 #1 is_dir() 例子

<?php
var_dump(is_dir('a_file.txt'));
var_dump(is_dir('bogus_dir/abc'));

var_dump(is_dir('..')); //one dir up
?>

以上示例会输出：

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

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

小技巧

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