is_dir
(PHP 4, PHP 5, PHP 7, PHP 8)
is_dir — 判斷給定檔名是否是一個目錄
說明
is_dir(string
$filename): bool判斷給定檔名是否是一個目錄。
參數
-
filename -
如果檔名存在並且為目錄則返回
true。如果filename是一個相對路徑，則按照目前工作目錄檢查其相對路徑。 Iffilenameis 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警告。
註釋
注意: 此函式的結果會被快取。參見 clearstatcache() 以獲得更多細節。
小技巧
自 PHP 5.0.0 起, 此函式也用於某些 URL 包裝器。請參見 支援的協議和封裝協議以獲得支援 stat() 系列函式功能的包裝器列表。