241 lines
8.6 KiB
PHP
241 lines
8.6 KiB
PHP
<?php
|
|
|
|
namespace Tests\Feature\Console;
|
|
|
|
use App\Console\Commands\Core\CoreUpdateCommand;
|
|
use App\Exceptions\UpgradeHandoffException;
|
|
use Illuminate\Support\Facades\File;
|
|
use Tests\TestCase;
|
|
|
|
/**
|
|
* CoreUpdateCommand 의 핸드오프 통합 계약 테스트 (spawn 파싱 경로)
|
|
*
|
|
* `handle()` 전체 체인(11 Step) 을 통과시키는 통합 테스트는 GitHub 연동·migration·
|
|
* vendor 설치 등 사이드이펙트가 크고 mock 면적이 방대하다. 따라서 본 테스트는
|
|
* handle() 의 **catch (UpgradeHandoffException) 분기로 들어가는 입구**에 해당하는
|
|
* `spawnUpgradeStepsProcess` 의 파싱 계약을 검증한다. 이 입구가 보장되면:
|
|
*
|
|
* - spawn 자식의 [HANDOFF] + exit 75 → 부모가 UpgradeHandoffException 재구성 → throw
|
|
* - 재구성된 예외는 handle() 의 try 전체를 덮는 catch 블록이 포착하여 cleanup 분기로 진입
|
|
*
|
|
* handle() catch 블록 내부 cleanup 시퀀스 (updateVersionInEnv(toVersion),
|
|
* clearAllCaches, restoreOwnership, cleanupPending, disableMaintenanceMode,
|
|
* 사용자 안내) 는 본 테스트 범위에서 제외되며, PO Linux 서버 수동 검증으로 보완한다.
|
|
*
|
|
* 본 테스트는 실제 proc_open 으로 자식 PHP 프로세스를 띄우므로 proc_open 미지원
|
|
* 환경에서는 skip.
|
|
*/
|
|
class CoreUpdateCommandHandoffTest extends TestCase
|
|
{
|
|
private string $handoffStepPath;
|
|
|
|
private string $failingStepPath;
|
|
|
|
protected function setUp(): void
|
|
{
|
|
parent::setUp();
|
|
|
|
$this->handoffStepPath = base_path('upgrades/Upgrade_0_0_1_test_integration_handoff.php');
|
|
$this->failingStepPath = base_path('upgrades/Upgrade_0_0_1_test_integration_fail.php');
|
|
}
|
|
|
|
protected function tearDown(): void
|
|
{
|
|
foreach ([$this->handoffStepPath, $this->failingStepPath] as $p) {
|
|
if (File::exists($p)) {
|
|
File::delete($p);
|
|
}
|
|
}
|
|
|
|
parent::tearDown();
|
|
}
|
|
|
|
/**
|
|
* 자식 프로세스가 UpgradeHandoffException 을 던지면 부모의
|
|
* spawnUpgradeStepsProcess 가 [HANDOFF] stdout + exit 75 를 파싱해
|
|
* UpgradeHandoffException 을 재구성하여 상위로 throw 한다.
|
|
*/
|
|
public function test_spawn_rethrows_handoff_exception_from_child(): void
|
|
{
|
|
if (! function_exists('proc_open')) {
|
|
$this->markTestSkipped('proc_open 미지원 환경');
|
|
}
|
|
|
|
File::put($this->handoffStepPath, <<<'PHP'
|
|
<?php
|
|
|
|
namespace App\Upgrades;
|
|
|
|
use App\Contracts\Extension\UpgradeStepInterface;
|
|
use App\Exceptions\UpgradeHandoffException;
|
|
use App\Extension\UpgradeContext;
|
|
|
|
class Upgrade_0_0_1_test_integration_handoff implements UpgradeStepInterface
|
|
{
|
|
public function run(UpgradeContext $context): void
|
|
{
|
|
throw new UpgradeHandoffException(
|
|
afterVersion: '0.0.0',
|
|
reason: '자식 프로세스 핸드오프',
|
|
resumeCommand: 'php artisan custom:resume',
|
|
);
|
|
}
|
|
}
|
|
PHP);
|
|
|
|
$command = $this->makeCommandWithDummyIo();
|
|
$method = new \ReflectionMethod(CoreUpdateCommand::class, 'spawnUpgradeStepsProcess');
|
|
$method->setAccessible(true);
|
|
|
|
$logs = [];
|
|
$logCollector = function (string $message) use (&$logs) {
|
|
$logs[] = $message;
|
|
};
|
|
|
|
try {
|
|
$method->invoke($command, '0.0.0', '0.0.1', true, $logCollector);
|
|
$this->fail('UpgradeHandoffException 이 상위로 전파되어야 한다');
|
|
} catch (UpgradeHandoffException $e) {
|
|
$this->assertSame('0.0.0', $e->afterVersion);
|
|
$this->assertSame('자식 프로세스 핸드오프', $e->reason);
|
|
$this->assertSame('php artisan custom:resume', $e->resumeCommand);
|
|
}
|
|
|
|
// 부모 로그에 핸드오프 수신 흔적이 있어야 한다
|
|
$handoffLog = implode("\n", $logs);
|
|
$this->assertStringContainsString('핸드오프', $handoffLog);
|
|
}
|
|
|
|
/**
|
|
* 자식 프로세스가 정상 완료(exit 0)되면 spawn 은 true 를 반환한다.
|
|
* Handoff 파싱 로직이 정상 경로를 손상시키지 않는지 회귀 가드.
|
|
*/
|
|
public function test_spawn_returns_true_on_normal_exit(): void
|
|
{
|
|
if (! function_exists('proc_open')) {
|
|
$this->markTestSkipped('proc_open 미지원 환경');
|
|
}
|
|
|
|
// upgrade 파일 없이 실행 → runUpgradeSteps 가 조용히 no-op → exit 0
|
|
$command = $this->makeCommandWithDummyIo();
|
|
$method = new \ReflectionMethod(CoreUpdateCommand::class, 'spawnUpgradeStepsProcess');
|
|
$method->setAccessible(true);
|
|
|
|
$result = $method->invoke($command, '9.9.8', '9.9.9', true, fn () => null);
|
|
|
|
$this->assertTrue($result, '정상 종료 시 true 반환해야 한다');
|
|
}
|
|
|
|
/**
|
|
* 자식 프로세스가 일반 실패(exit != 0, != 75)면 spawn 은 false 를 반환하여
|
|
* 상위 호출자가 in-process fallback 경로로 전환할 수 있게 한다.
|
|
*/
|
|
public function test_spawn_returns_false_on_generic_failure(): void
|
|
{
|
|
if (! function_exists('proc_open')) {
|
|
$this->markTestSkipped('proc_open 미지원 환경');
|
|
}
|
|
|
|
File::put($this->failingStepPath, <<<'PHP'
|
|
<?php
|
|
|
|
namespace App\Upgrades;
|
|
|
|
use App\Contracts\Extension\UpgradeStepInterface;
|
|
use App\Extension\UpgradeContext;
|
|
|
|
class Upgrade_0_0_1_test_integration_fail implements UpgradeStepInterface
|
|
{
|
|
public function run(UpgradeContext $context): void
|
|
{
|
|
throw new \RuntimeException('자식 일반 실패');
|
|
}
|
|
}
|
|
PHP);
|
|
|
|
$command = $this->makeCommandWithDummyIo();
|
|
$method = new \ReflectionMethod(CoreUpdateCommand::class, 'spawnUpgradeStepsProcess');
|
|
$method->setAccessible(true);
|
|
|
|
$result = $method->invoke($command, '0.0.0', '0.0.1', true, fn () => null);
|
|
|
|
$this->assertFalse($result, '일반 실패 시 false 반환 (in-process fallback 유도)');
|
|
}
|
|
|
|
/**
|
|
* resumeCommand 자동 생성 계약:
|
|
* 자식이 resumeCommand=null 로 핸드오프 신호를 보낸 경우, 재구성된
|
|
* UpgradeHandoffException::resumeCommand 는 null 이어야 한다 (부모 CoreUpdateCommand
|
|
* 의 catch 블록이 sprintf 로 자동 생성하는 기본값 트리거 조건).
|
|
*/
|
|
public function test_spawn_preserves_null_resume_command_for_auto_generation(): void
|
|
{
|
|
if (! function_exists('proc_open')) {
|
|
$this->markTestSkipped('proc_open 미지원 환경');
|
|
}
|
|
|
|
File::put($this->handoffStepPath, <<<'PHP'
|
|
<?php
|
|
|
|
namespace App\Upgrades;
|
|
|
|
use App\Contracts\Extension\UpgradeStepInterface;
|
|
use App\Exceptions\UpgradeHandoffException;
|
|
use App\Extension\UpgradeContext;
|
|
|
|
class Upgrade_0_0_1_test_integration_handoff implements UpgradeStepInterface
|
|
{
|
|
public function run(UpgradeContext $context): void
|
|
{
|
|
throw new UpgradeHandoffException(
|
|
afterVersion: '0.0.0',
|
|
reason: '자동 생성 필요',
|
|
);
|
|
}
|
|
}
|
|
PHP);
|
|
|
|
$command = $this->makeCommandWithDummyIo();
|
|
$method = new \ReflectionMethod(CoreUpdateCommand::class, 'spawnUpgradeStepsProcess');
|
|
$method->setAccessible(true);
|
|
|
|
try {
|
|
$method->invoke($command, '0.0.0', '0.0.1', true, fn () => null);
|
|
$this->fail('UpgradeHandoffException 이 전파되어야 한다');
|
|
} catch (UpgradeHandoffException $e) {
|
|
$this->assertNull(
|
|
$e->resumeCommand,
|
|
'resumeCommand 는 null 로 유지되어야 CoreUpdateCommand 가 자동 생성한다'
|
|
);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* CoreUpdateCommand 를 OutputStyle 주입 없이 리플렉션 호출 가능한 형태로 준비.
|
|
* spawnUpgradeStepsProcess 내부에서 $this->line / $this->info 를 호출하므로
|
|
* OutputStyle 이 필요. Artisan 의 기본 Buffered Output 로 대체.
|
|
*/
|
|
private function makeCommandWithDummyIo(): CoreUpdateCommand
|
|
{
|
|
$command = app(CoreUpdateCommand::class);
|
|
|
|
$input = new \Symfony\Component\Console\Input\ArrayInput([]);
|
|
$output = new \Symfony\Component\Console\Output\BufferedOutput;
|
|
$style = new \Illuminate\Console\OutputStyle($input, $output);
|
|
|
|
$reflection = new \ReflectionClass($command);
|
|
$property = $reflection->getProperty('output');
|
|
$property->setAccessible(true);
|
|
$property->setValue($command, $style);
|
|
|
|
// laravel-zero 등 컨테이너 의존 호출 대비 input 도 설정
|
|
if ($reflection->hasProperty('input')) {
|
|
$inputProp = $reflection->getProperty('input');
|
|
$inputProp->setAccessible(true);
|
|
$inputProp->setValue($command, $input);
|
|
}
|
|
|
|
return $command;
|
|
}
|
|
}
|