is_dir

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

is_dir判斷給定文件名是否是一個(gè)目錄

說(shuō)明

is_dir(string $filename): bool

判斷給定文件名是否是一個(gè)目錄。

參數(shù)

filename

如果文件名存在并且為目錄則返回 true。如果 filename 是一個(gè)相對(duì)路徑,則按照當(dāng)前工作目錄檢查其相對(duì)路徑。 If filename is a symbolic or hard link then the link will be resolved and checked.If you have enabled open_basedir further restrictions may apply.

返回值

如果文件名存在,并且是個(gè)目錄,返回 true,否則返回false

范例

示例 #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
?>

以上例程會(huì)輸出:

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

錯(cuò)誤/異常

失敗時(shí)拋出E_WARNING警告。

注釋

注意: 此函數(shù)的結(jié)果會(huì)被緩存。參見(jiàn) clearstatcache() 以獲得更多細(xì)節(jié)。

小技巧

自 PHP 5.0.0 起, 此函數(shù)也用于某些 URL 包裝器。請(qǐng)參見(jiàn) 支持的協(xié)議和封裝協(xié)議以獲得支持 stat() 系列函數(shù)功能的包裝器列表。

參見(jiàn)

  • chdir() - 改變目錄
  • dir() - 返回一個(gè) Directory 類(lèi)實(shí)例
  • opendir() - 打開(kāi)目錄句柄
  • is_file() - 判斷給定文件名是否為一個(gè)正常的文件
  • is_link() - 判斷給定文件名是否為一個(gè)符號(hào)連接