萬盛學電腦網

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

PHP CLI / Cron 環境下相對路徑失效問題解決方案

問題根因

CLI / Cron 執行腳本時,**工作目錄 (CWD) 為調用進程所在目錄**,而非腳本文件所在目錄。導致相對路徑 require '../config.php' 找不到文件。

解決方案對比

方法代碼優點缺點
chdir(__DIR__) (推薦)chdir(__DIR__);一行解決,後續所有相對路徑、include_path、文件操作均以腳本目錄為基準改變全局 CWD,若多腳本並行需注意
設置 include_pathset_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();

Crontab 寫法規範

# 使用絕對路徑調用 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 重複執行。

copyright © 萬盛學電腦網 all rights reserved