大网数据广告活动
PHP 语言与运行手册

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

· 52CE 我爱测

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

is_dir

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

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

说明

function 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() 系列函数功能的包装器列表。

参见

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

来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
PHP Documentation Group
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。