CLI / Cron 執行腳本時,**工作目錄 (CWD) 為調用進程所在目錄**,而非腳本文件所在目錄。導致相對路徑 require '../config.php' 找不到文件。
| 方法 | 代碼 | 優點 | 缺點 |
|---|---|---|---|
| chdir(__DIR__) (推薦) | chdir(__DIR__); | 一行解決,後續所有相對路徑、include_path、文件操作均以腳本目錄為基準 | 改變全局 CWD,若多腳本並行需注意 |
| 設置 include_path | set_include_path(__DIR__ . PATH_SEPARATOR . get_include_path()); | 不改變 CWD,僅影響 include/require | 不影響 file_get_contents、fopen 等文件系統函數 |
| 絕對路徑常量 | define('ROOT', __DIR__); require ROOT . '/config.php'; | 最顯式、無副作用 | 需改造所有引用處 |
| 自動加載器 | Composer PSR-4 | 現代標準,徹底解決路徑問題 | 需引入 Composer |
// bootstrap.php (所有 CLI 腳本首行引入)
load();
// 4. 通用服務初始化 (DB, Redis, Log, Config...)
\App\Kernel::boot();
每個 Cron 腳本:
#!/usr/bin/env php
processPending();
# 使用絕對路徑調用 PHP 二進制與腳本
* * * * * /usr/bin/php /var/www/project/bin/order_process.php >> /var/www/project/storage/logs/cron.log 2>&1
# 或使用 flock 防止重複執行
* * * * * flock -n /tmp/order_process.lock -c '/usr/bin/php /var/www/project/bin/order_process.php'
// 臨時打印調試
error_log('CWD: ' . getcwd() . ' SCRIPT: ' . __FILE__ . ' DIR: ' . __DIR__);
// 檢查 include_path
error_log('include_path: ' . get_include_path());
**chdir(__DIR__) 是最簡單有效的修復**,但現代專案應採用 **Composer 自動加載 + 統一引導文件 + 絕對路徑常量** 架構,從根源消除路徑依賴,並配合 flock 防止 Cron 重複執行。