dir()函式—用法及示例

函式名稱：dir()

函式描述：dir()函式用於開啟目錄控制代碼，並返回一個Directory物件，可以用來迭代目錄中的檔案和子目錄。它是舊版本的目錄遍歷函式，在PHP 5.0.0之後被廢棄，推薦使用更現代化的函式來代替。

適用版本：PHP 4 – PHP 4.3.7（由於在PHP 4.3.0之後已不在主流版本中支援，因此這個函式應該被視為已經被廢棄和不推薦使用）

用法：

resource dir ( string $directory [, resource $context ] )

引數：

• $directory：要開啟的目錄路徑。
• $context（可選）：一個Stream context資源。

返回值： 如果成功開啟目錄，則返回Directory物件的資源控制代碼，否則返回FALSE。

示例：

$dir = dir("/path/to/directory");  // 開啟目錄控制代碼
if ($dir) {
    while (false !== ($file = $dir->read())) {
        echo $file . "<br>";  // 輸出目錄下的檔名/子目錄名
    }
    $dir->close();  // 關閉目錄控制代碼
}

注意事項：

• 應該謹慎使用該函式，因為它不支援流式上下文（stream context）。
• 推薦使用更先進和可靠的函式如opendir()和readdir()來替代dir()函式。