您现在的位置：程式碼之家 >> 編程語言 > >> 網頁程式設計 >> PHP 程式設計 >> PHP 相關知識

PHP 與 Shell 腳本協作實戰：exec、shell_exec、passthru 選型指南

編輯：PHP 相關知識

背景認知

Shell 既是命令解釋器，也是程式設計語言（變量、循環、分支）。PHP 透過進程控制函數調用 Shell 腳本，常見場景：備份、文件傳輸、系統管理、長耗時任務異步化。

核心函數對比與選型策略

函數	返回值	輸出處理	典型適用場景
`exec()`	最後一行輸出（字串）可選第二參數接收完整輸出數組	不直接輸出，需手動處理	需捕獲命令結果進一步處理（如解析輸出行）
`shell_exec()`	完整輸出（字串）	不直接輸出	簡單命令、不關心退出碼、需完整輸出文本
`passthru()`	退出碼（整數）直接輸出原始二進制流	直接輸出到瀏覽器/標準輸出	二進制輸出（圖片、PDF）、需即時流式傳輸、需檢查退出碼
`system()`	退出碼直接輸出最後一行	直接輸出	簡單交互命令、兼容舊代碼

實戰範例：rsync 文件傳輸與錯誤處理

<?php
// 權限檢查後，調用預寫好的 rsync 腳本
$script = '/usr/local/bin/xfer_rsync.sh';
$returnValue = 0;

// passthru 適合：需要即時輸出進度、且必須拿到退出碼判斷成敗
passthru($script, $returnValue);

if ($returnValue !== 0) {
    // 記錄錯誤碼、發送告警郵件、寫入錯誤日誌
    error_log("Rsync 失敗，退出碼: $returnValue");
    // 返回錯誤頁面或 JSON
} else {
    // 重定向成功頁面
    header('Location: /transfer/success');
}
?>

進階模式：Cron + PHP CLI 實現可靠批處理

Web 請求不應阻塞於耗時操作。推薦架構：

Web 端寫入任務隊列（DB/Redis）
Cron 定時觸發 PHP CLI 腳本消費隊列
腳本執行 Shell 命令（exec/passthru），捕獲退出碼與輸出
成功/失敗分別記錄日誌、更新任務狀態、發送通知

優勢：符合 KISS 原則、無內存洩漏風險、進程自動退出無卡殼、易於監控與重試。

安全紅線：嚴防命令注入

絕不直接拼接用戶輸入到命令字串
使用 escapeshellarg()、escapeshellcmd() 轉義參數
建立命令白名單，用戶僅能選擇預定義操作（如通過 checkbox 選文件，而非輸入路徑）
禁用 sudo、rm -rf 等高危命令
最小權限原則：Web 用戶不應擁有 Shell 寫入權限

總結

PHP 與 Shell 協作無固定模板，根據輸出類型、是否需要退出碼、是否需流式傳輸在 exec/shell_exec/passthru 中選型。安全永遠是第一位約束，架構上推薦「Web 寫隊列 + Cron 讀隊列 + CLI 執行」解耦模式，實現高可靠、可觀測的異步任務體系。