在 laravel 中调用外部程序时，可以通过配置 config/process.php 中的 timeout 参数来设置全局超时时间，或者在运行时通过 process::settimeout() 方法为单个进程实例设置特定的超时限制。默认情况下，laravel 的 process 组件没有设置超时（即无限等待），因此必须显式指定一个秒数或 false 来禁用超时检查。
如何配置全局默认的进程超时时间？
要修改所有未单独设置超时的进程的默认行为，需要编辑 config/process.php 配置文件。在该文件中找到 timeout 键，并将其值设置为期望的秒数。例如，将超时时间设置为 30 秒，这样任何使用 Process facade 创建且未调用 setTimeout() 的进程都会在运行 30 秒后被强制终止并抛出异常。
namespace App\Http\Controllers;
use Illuminate\Support\Facades\Process;
use Symfony\Component\Process\Exception\ProcessTimedOutException;
public function runCommand()
{
try {
// 使用全局配置的 timeout (假设 config/process.php 中设为 30)
$process = Process::timeout(30)->run([
'curl', '-s', 'http://example.com/slow-endpoint'
]);
if (!$process->isSuccessful()) {
return response()->json(['error' => $process->getErrorOutput()]);
}
return response()->json(['output' => $process->getOutput()]);
} catch (ProcessTimedOutException $e) {
return response()->json(['error' => 'Process timed out'], 504);
}
}
如何为单个进程实例动态设置超时？
如果需要根据具体业务逻辑为不同的命令设置不同的超时时间，可以在构建 Process 实例时链式调用 timeout() 方法。该方法接受一个整数（秒）或 false。当传入 false 时，表示该特定进程不应用任何超时限制，即使全局配置了超时值。这种方式提供了更细粒度的控制，适用于那些偶尔需要长时间运行但通常快速完成的场景。
Laravel Cloud（cloud.laravel.com）。此技能用于处理所有 Laravel Cloud 请求，包括搜索和读取数据。只要任务涉及 Laravel Cloud，即使用此技能。
namespace App\Http\Controllers;
use Illuminate\Support\Facades\Process;
use Symfony\Component\Process\Exception\ProcessTimedOutException;
public function runFlexibleCommand()
{
// 为这个特定命令设置 60 秒超时
$process = Process::timeout(60)->run([
'php', 'artisan', 'queue:work', '--stop-when-empty'
]);
// 另一个命令可能不需要超时，设置为 false
$longRunningProcess = Process::timeout(false)->run([
'python', 'generate_large_report.py'
]);
return response()->json([
'short_timeout_result' => $process->isSuccessful(),
'no_timeout_result' => $longRunningProcess->isSuccessful()
]);
}
当进程因超时而失败时，如何捕获并处理异常？
当外部进程超过设定的超时时间时，Symfony Process 组件会抛出一个 ProcessTimedOutException。为了优雅地处理这种情况，必须在 try-catch 块中捕获此特定异常。捕获后，可以记录日志、返回适当的 HTTP 状态码（如 504 Gateway Timeout）或执行其他清理操作。如果不捕获此异常，它将导致应用程序崩溃或未处理的错误页面。此外，超时后进程会被自动终止，因此无需手动杀死它。
