Linux 環境下 PHP exec() 返回值異常的深度排查與 proc_open 替代方案

問題重述

同 exec()，Linux 下第三參數 $return_var 無法接收負數，始終為 0-255 無符號值。

深度排查鏈路

1. C 程序返回 -5 → 編譯為 exit(251)。
2. Shell 驗證：echo $? 顯示 251。
3. PHP exec() 獲取：$code = 251。
4. PHP 源碼追踪：ext/standard/exec.c → php_exec() → waitpid() → WEXITSTATUS(status) 宏提取低 8 位 → 無符號化。
5. 結論：OS 層面限制，PHP 無法突破。

proc_open() 完整替代方案（推薦）

<?php
function executeCommand($cmd, $cwd = null, $timeout = 30) {
    $spec = [
        0 => ['pipe', 'r'],   // stdin
        1 => ['pipe', 'w'],   // stdout
        2 => ['pipe', 'w'],   // stderr
    ];
    
    $proc = proc_open($cmd, $spec, $pipes, $cwd);
    if (!is_resource($proc)) {
        throw new RuntimeException("Failed to start process: $cmd");
    }
    
    // 非阻塞讀取避免死鎖
    stream_set_blocking($pipes[1], false);
    stream_set_blocking($pipes[2], false);
    
    $stdout = '';
    $stderr = '';
    $start = time();
    
    while (true) {
        $status = proc_get_status($proc);
        if (!$status['running']) break;
        
        if (time() - $start > $timeout) {
            proc_terminate($proc, SIGKILL);
            throw new RuntimeException("Command timeout: $cmd");
        }
        
        $stdout .= stream_get_contents($pipes[1]);
        $stderr .= stream_get_contents($pipes[2]);
        usleep(10000); // 10ms
    }
    
    // 讀取剩餘輸出
    $stdout .= stream_get_contents($pipes[1]);
    $stderr .= stream_get_contents($pipes[2]);
    
    foreach ($pipes as $pipe) { fclose($pipe); }
    
    $exitCode = proc_close($proc); // 0-255
    
    return [
        'exit_code' => $exitCode,
        'stdout' => $stdout,
        'stderr' => $stderr,
        'success' => $exitCode === 0,
    ];
}

// 使用
$result = executeCommand('/home/wwwroot/test/rtest.out');
if (!$result['success']) {
    // 解析 stderr/stdout 獲取真實錯誤
    echo "Exit: {$result['exit_code']}\n";
    echo "Err: {$result['stderr']}\n";
}
?>

proc_open 優勢

• 獨立捕獲 stdout/stderr，避免混合。
• 支持工作目錄 (cwd)、環境變量、超時控制、信號發送。
• 非阻塞讀取防止大輸出死鎖。
• 可作為守護進程啟動器（不關閉管道）。

Symfony Process 組件（生產級封裝）

<?php
// composer require symfony/process
use Symfony\Component\Process\Process;
use Symfony\Component\Process\Exception\ProcessFailedException;

$process = new Process(['/home/wwwroot/test/rtest.out']);
$process->setTimeout(30);
$process->setWorkingDirectory('/home/wwwroot/test');
$process->run();

if (!$process->isSuccessful()) {
    throw new ProcessFailedException($process);
}
echo $process->getOutput();
// $process->getExitCode() 仍為 0-255
?>

避坑指南

• 不要依賴負數退出碼**跨平台兼容**。
• 大輸出命令必須非阻塞讀取**，否則管道滿導致進程掛起。
• 超時機制必須有**，防止殭屍進程佔用資源。
• 權限最小化**：Web 用戶不可直接執行 root 命令，使用 sudoers 指定免密命令或消息隊列異步處理。