萬盛學電腦網

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

PHP chdir() 改變工作目錄完整指南:相對路徑解析、跨平台差異與最佳實踐

函式原型

chdir(string $directory): bool
// 成功回傳 true,失敗 false (並觸發 Warning)

基本用法

<?php
echo "目前目錄: " . getcwd() . "\n"; // /home/user/project

chdir('public_html'); // 相對路徑
echo "變更後: " . getcwd() . "\n"; // /home/user/project/public_html

chdir('/tmp'); // 絕對路徑
echo "再變更: " . getcwd() . "\n"; // /tmp

核心概念:目前工作目錄 (CWD)

  • **進程級屬性**:影響同一進程內所有相對路徑操作 (fopen、include、scandir、exec 等)
  • **非執行緒安全**:多執行緒環境 (如 Apache worker MPM) 下寫入 CWD 會互相干擾
  • **PHP-FPM/CLI 各自獨立**:請求間不共享 CWD

跨平台差異與陷阱

Windows 路徑分隔符

// Windows 同時接受 / 和 \
chdir('C:/xampp/htdocs'); // 推薦用正斜線
chdir('C:\\xampp\\htdocs'); // 雙反斜線

// 避免單反斜線跳脫
chdir('C:\xampp\htdocs'); // 錯誤!\x 被視為十六進位跳脫

符號連結 (Symlink) 行為差異


// 假設 /var/www/html -> symlink -> /home/user/project
chdir('/var/www/html');
getcwd(); // PHP 5.3+ 回傳實際路徑 /home/user/project (已解析)
// 若需保留邏輯路徑,用 $_SERVER['DOCUMENT_ROOT'] 或自行追蹤

安全模式 (已移除) 與 open_basedir

// open_basedir 限制生效時
chdir('/etc'); // Warning: open_basedir restriction in effect
// 僅限允許路徑內操作

最佳實踐:避免全域狀態改變

❌ 不推薦:隨意 chdir

function processFiles($dir) {
    chdir($dir); // 副作用:改變全域 CWD
    foreach (glob('*.txt') as $f) { ... }
    // 返回時 CWD 已改變,呼叫端可能出錯
}

✅ 推薦:使用絕對路徑

function processFiles(string $dir): array {
    $dir = realpath($dir); // 正規化
    $files = glob($dir . '/*.txt');
    return array_map(fn($f) => realpath($f), $files);
}
// 無副作用、可測試、執行緒安全

✅ 必須 chdir 時:儲存並恢復

function withCwd(string $dir, callable $callback) {
    $old = getcwd();
    chdir($dir);
    try {
        return $callback();
    } finally {
        chdir($old); // 確保恢復
    }
}

withCwd('/tmp', function() {
    // 此處 CWD 為 /tmp
    file_put_contents('test.txt', 'data');
});
// 結束後 CWD 自動恢復

相關函式

  • getcwd():取得目前工作目錄
  • dirname(__FILE__) / __DIR__:腳本所在目錄 (不受 chdir 影響)
  • realpath():解析相對路徑、符號連結、返回絕對路徑
  • scandir()、glob():列出目錄內容 (受 CWD 影響)

實務應用場景

  1. CLI 腳本切換專案目錄:部署腳本、建構工具
  2. 臨時檔案處理:chdir(sys_get_temp_dir()) 後建立暫存檔
  3. 舊代碼相容:依賴相對路徑的 Legacy 程式庫
copyright © 萬盛學電腦網 all rights reserved