PHP 目錄操作函數完整詳解：chdir、scandir、opendir 等實用指南

PHP 目錄處理函數大全

PHP 提供豐富的目錄操作函數，適用於檔案掃描、路徑切換、目錄建立刪除等場景。本文整理核心函數用法與範例。

預定義常數

• DIRECTORY_SEPARATOR：系統目錄分隔符（Windows `\`，Linux `/`）
• PATH_SEPARATOR：路徑分隔符（Windows `;`，Linux `:`）

核心函數速查表

實用範例

1. 遞迴列出所有檔案（含子目錄）

<?php
function listAllFiles($dir) {
    $files = [];
    $items = scandir($dir);
    foreach ($items as $item) {
        if ($item === '.' || $item === '..') continue;
        $path = $dir . DIRECTORY_SEPARATOR . $item;
        if (is_dir($path)) {
            $files = array_merge($files, listAllFiles($path));
        } else {
            $files[] = $path;
        }
    }
    return $files;
}
print_r(listAllFiles(__DIR__));
?>

2. 使用 Directory 類別（物件導向風格）

<?php
$d = dir('/var/www/html');
echo "Handle: {$d->handle}\n";
echo "Path: {$d->path}\n";
while (false !== ($entry = $d->read())) {
    echo "$entry\n";
}
$d->close();
?>

3. 安全切換目錄並還原

<?php
$old = getcwd();
chdir('/tmp');
// 執行臨時操作...
chdir($old); // 還原
?>

最佳實踐提醒

• 路徑拼接務必使用 DIRECTORY_SEPARATOR 或 /（PHP 自動轉換），避免跨平台問題。
• 大量檔案操作時，scandir() 會一次載入所有檔名到記憶體，超大目錄建議用 opendir() + readdir() 迭代處理。
• 權限檢查：操作前用 is_readable()、is_writable() 確認權限。
• 刪除非空目錄需遞迴刪除檔案後再 rmdir()，參見 PHP 刪除非空目錄函數。

熟練掌握目錄函數，能高效實作檔案管理器、靜態站點生成器、自動部署腳本等工具。