PHP 執行 Shell 腳本實戰：exec、shell_exec、passthru 選型與安全防範

三大函數比較

實戰範例：rsync 備份整合

<?php
// 1. 使用 passthru 執行 rsync 腳本，即時顯示進度，並取得狀態碼
$script = '/usr/local/bin/backup_rsync.sh';
passthru($script, $returnVar);
if ($returnVar !== 0) {
    error_log("Backup failed with code $returnVar");
    // 發送告警、寫入資料庫錯誤日誌
} else {
    // 成功：可選擇導向完成頁面
    header('Location: /backup/success');
}

// 2. 使用 exec 列出程序，解析輸出陣列
exec('ps aux | grep php-fpm', $output, $status);
foreach ($output as $line) {
    // 解析 PID、CPU、記憶體...
}

// 3. 使用 shell_exec 取得完整輸出字串
$disk = shell_exec('df -h /');
echo "
$disk
";

定時任務整合

獨立 PHP 腳本 + cron 比在 Web 請求中執行長時間任務更穩健：

# crontab -e
0 2 * * * /usr/bin/php /var/www/scripts/nightly_backup.php >> /var/log/backup.log 2>&1

腳本內用 exec() 呼叫備份指令，根據回傳碼寫入資料庫狀態、發送郵件通知。

安全防範：輸入過濾與最小權限

1. 絕不直接拼接使用者輸入：exec("ls $dir") 極度危險。
2. 白名單驗證：使用者只能從下拉選單選擇預設指令/參數。
3. 移除危險字元：escapeshellarg()、escapeshellcmd() 雙重防護。
4. 禁用 Shell 元字元：; & | ` $ ( ) < > 等。
5. 以低權限使用者執行 PHP-FPM：www-data、nginx，禁止 sudo。
6. open_basedir 限制可存取路徑。
7. 搭配 disable_functions 禁用 exec/shell_exec/passthru 等：若業務必須用，獨立出 Worker 服務，透過訊息佇列（RabbitMQ、Redis Stream）非同步處理，Web 端僅發送任務。

進階替代方案

• Symfony Process Component：物件導向封裝、超時控制、非同步、管道處理。
• proc_open()：雙向管道、長時間互動、需精細控制 STDIN/STDOUT/STDERR。
• Swoole/RoadRunner 協程 + Process：高併發下非阻塞執行外部程式。