函式原型
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 影響)
實務應用場景
- CLI 腳本切換專案目錄:部署腳本、建構工具
- 臨時檔案處理:
chdir(sys_get_temp_dir()) 後建立暫存檔
- 舊代碼相容:依賴相對路徑的 Legacy 程式庫