萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP is_dir() 函式完整用法與常見誤區解析

函式簽名

bool is_dir(string $filename)

回傳 true 當且僅當 $filename 存在且為目錄。檔案、不存在、連結指向檔案皆回傳 false。

關鍵特性

  • 支援相對路徑(相對當前工作目錄)與絕對路徑。
  • 結果會被快取,呼叫 clearstatcache() 可清除。
  • Windows 下不區分大小寫;Linux 區分。

範例 1:基本判斷

<?php
var_dump(is_dir('a_file.txt'));      // bool(false) - 是檔案
var_dump(is_dir('bogus_dir/abc'));   // bool(false) - 不存在
var_dump(is_dir('..'));              // bool(true)  - 上層目錄存在
?>

範例 2:實務判斷目錄是否存在

$dir = "images";
if (is_dir($dir)) {
    echo "$dir is a directory";
} else {
    echo "$dir is not a directory";
}

常見誤區

  1. 誤以為 !is_dir() 就是檔案:可能是不存在、權限不足、符號連結指向檔案。正確判斷檔案用 is_file()。
  2. 忽略快取導致舊結果:在同一腳本中建立/刪除目錄後再判斷,必須 clearstatcache()。
  3. 路徑拼接錯誤:建議使用 realpath() 取得規範化絕對路徑再判斷。

最佳實務

function isDirSafe($path) {
    $path = realpath($path);
    if ($path === false) return false;
    clearstatcache(true, $path); // PHP 5.3+ 支援針對單一路徑清除
    return is_dir($path);
}
copyright © 萬盛學電腦網 all rights reserved