Laravel 11：如何在PHPUnit中模拟CTRL+C操作以触发Artisan命令的信号处理方法？

嘿，我完全懂你现在的处境——自己写的长运行Artisan命令已经完美支持CTRL+C中断了，但PHPUnit测试里死活模拟不了这个操作，导致shutdown方法的代码一直是红的，看着就闹心对吧😤。下面给你两种解决方案，从快速凑覆盖到贴近真实场景的完整测试都有，你按需选：

1. 快速凑代码覆盖：直接调用shutdown方法 #

如果你只是单纯想让代码覆盖的绿条拉满，懒得折腾完整的信号流程，那最简单的方式就是在测试里直接实例化命令类，手动调用shutdown方法就行。这种方式虽然没测试信号触发的完整链路，但胜在快，能立刻把红条变绿。

比如测试代码可以这么写：

public function test_shutdown_method_is_covered(): void
{
    $command = $this->app->make(YourLongRunningCommand::class);
    // 直接调用shutdown方法
    $command->shutdown();
    
    // 这里可以加一些针对shutdown执行结果的断言，比如检查是否清理了资源、写入了日志等
    $this->assertTrue(true); // 替换成你的实际断言逻辑
}

2. 贴近真实场景：模拟完整的信号触发流程 #

如果你想测试从信号注册到触发shutdown的完整链路，那可以用PCNTL和POSIX扩展的函数来模拟发送SIGINT信号（也就是CTRL+C对应的信号）。步骤如下：

步骤1：先确保测试环境支持必要的扩展 #

在测试类的setUp方法或者测试方法开头，先检查PCNTL和POSIX扩展是否可用，不然直接跳过测试：

protected function setUp(): void
{
    parent::setUp();
    
    if (!extension_loaded('pcntl') || !extension_loaded('posix')) {
        $this->markTestSkipped('PCNTL和POSIX扩展是这个测试的必要条件，当前环境未安装');
    }
}

步骤2：模拟信号发送与处理 #

如果你的命令是在handle()方法里注册的信号，那直接调用handle()会因为长循环卡住测试，这时候可以用pcntl_fork()创建子进程来运行handle，父进程发送信号给子进程：

public function test_sync_process_can_be_interrupted_by_signal(): void
{
    $command = $this->app->make(YourLongRunningCommand::class);

    // 创建子进程
    $pid = pcntl_fork();
    if ($pid === -1) {
        $this->fail('无法创建测试子进程');
    } elseif ($pid === 0) {
        // 子进程：执行命令的handle方法
        $command->handle();
        exit(0);
    } else {
        // 父进程：等待一小会儿，确保子进程已经完成信号注册
        usleep(100000); // 等待0.1秒，时间可以根据你的命令初始化速度调整
        
        // 发送SIGINT信号给子进程（模拟CTRL+C）
        posix_kill($pid, SIGINT);
        
        // 等待子进程退出
        pcntl_wait($status);
        
        // 断言子进程正常退出（根据你的shutdown逻辑调整断言）
        $this->assertTrue(pcntl_wifexited($status));
        
        // 如果你在shutdown里有写日志、清理资源等操作，这里可以加对应的断言
        // 比如检查日志文件是否存在shutdown的记录
    }
}

如果你的信号是在命令的构造方法或者其他初始化方法里注册的，那可以不用fork，直接在当前进程注册信号、发送信号然后分发：

public function test_signal_triggers_shutdown(): void
{
    $command = $this->app->make(YourLongRunningCommand::class);
    
    // 确保信号处理逻辑已注册（如果命令没自动注册，手动注册）
    pcntl_async_signals(true);
    pcntl_signal(SIGINT, [$command, 'shutdown']);
    
    // 标记shutdown是否被调用
    $shutdownCalled = false;
    // 用Mockery来拦截shutdown方法，验证是否被触发
    $mockCommand = Mockery::mock($command)->makePartial();
    $mockCommand->shouldReceive('shutdown')->once()->andReturnUsing(function () use (&$shutdownCalled) {
        $shutdownCalled = true;
    });
    
    // 重新注册mock后的信号处理
    pcntl_signal(SIGINT, [$mockCommand, 'shutdown']);
    
    // 发送SIGINT信号给当前进程
    posix_kill(posix_getpid(), SIGINT);
    // 分发信号，触发处理逻辑
    pcntl_signal_dispatch();
    
    // 验证shutdown确实被调用
    $this->assertTrue($shutdownCalled);
}

注意事项 #

• 有些CI环境可能默认禁用了PCNTL或POSIX扩展，这时候记得用markTestSkipped跳过相关测试，避免构建失败。
• 如果你的shutdown方法里有依赖注入的对象，确保在测试中已经正确绑定了这些依赖，不然可能会报错。
• 调整等待子进程的睡眠时间时，别太长也别太短，确保子进程已经完成信号注册再发送信号。

备注：内容来源于stack exchange，提问作者Matt Komarnicki