is_dir

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

is_dir判斷給定文件名是否是一個目錄

說明

is_dir(string $filename): bool

判斷給定文件名是否是一個目錄。

參數(shù)

filename

如果文件名存在并且為目錄則返回 true。如果 filename 是一個相對路徑,則按照當前工作目錄檢查其相對路徑。 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.

返回值

如果文件名存在,并且是個目錄,返回 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
?>

以上例程會輸出:

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

錯誤/異常

失敗時拋出E_WARNING警告。

注釋

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

小技巧

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

參見

  • chdir() - 改變目錄
  • dir() - 返回一個 Directory 類實例
  • opendir() - 打開目錄句柄
  • is_file() - 判斷給定文件名是否為一個正常的文件
  • is_link() - 判斷給定文件名是否為一個符號連接