fix(core): 코어 업데이트가 특정 상황에서 중단되던 두 결함 수정

Windows JUNCTION 복사 실패:
- public/storage 는 storage:link 가 Windows 에서 생성하는 JUNCTION 으로,
 PHP is_link/is_dir 이 모두 false 를 반환해 copyDirectory 가 파일로
 오판 → copy(디렉토리) 예외로 코어 업데이트가 중단됐다.
- isReparsePoint 로 junction 을 정확 감지(link/file/dir 모두 false +
 readlink 성공)하고, copyLink 가 symlink 실패 시 mklink /J 로 폴백 복원.
 removeOrphanItems 도 junction orphan 을 rmdir 로 링크만 제거해 target
 재귀 삭제 사고를 차단.

실행할 스텝이 없는 업데이트를 실패로 오판:
- spawn 자식이 exit=0 + step 0건으로 종료하면 부모 가드가 from<to 만으로
 fail-fast 를 발동해, 스텝이 필요 없는 패치 릴리즈(예: 7.0.0→7.0.1)를
 실패로 처리하고 확장 업데이트 단계까지 도달하지 못했다.
- [STEPS_EXECUTED] 신호에 discovered(범위 내 발견된 스텝 파일 수)를 추가하고,
 handleSpawnExit 가 executed=0 && discovered=0 은 정상 통과, discovered>0
 일 때만 fail-fast 하도록 구분. 구버전 자식(discovered 부재)은 레거시 판정 유지.
 정상 통과 시 확장 일괄 업데이트 단계까지 진행된다.

테스트: FilePermissionHelperSymlinkTest / CoreUpdateCommandSpawnFailureTest /
CoreUpdateCommandHandoffTest / MultiVersionUpgradePathTest 전부 green.
This commit is contained in:
HeuJung committed 2026-07-02 12:30:23 +09:00
1 parent 68d2a68062
commit 27901dd254
8 files changed
+371 -50

No files matched your search

@@ -96,31 +96,107 @@ class CoreUpdateCommandSpawnFailureTest extends TestCase
}
#[Test]
public function spawn_자식_silent_skip_시_abort_모드는_throw_한다(): void
public function spawn_자식_범위내_스텝_파일이_없어_0건이면_정상_통과한다(): void
{
if (! function_exists('proc_open')) {
$this->markTestSkipped('proc_open 미지원 환경');
}
// upgrade 파일 없이 호출 → 자식은 [STEPS_EXECUTED] count=0 발행 + exit=0
// from < to 인 상태에서 0건 실행은 비정상 → mode=abort 시 throw
// upgrade 파일 없이 호출 → 자식은 [STEPS_EXECUTED] executed=0, discovered=0 발행 + exit=0
// "범위 내 스텝 파일 자체가 없음" 은 정상 상황 (예: 스텝 불필요 릴리즈).
// discovered=0 이면 fail-fast 를 발동하지 않고 정상 통과해야 한다 (케이스 B).
config(['app.update.spawn_failure_mode' => 'abort']);
$command = $this->makeCommandWithDummyIo();
$method = new \ReflectionMethod(CoreUpdateCommand::class, 'spawnUpgradeStepsProcess');
$method->setAccessible(true);
$logs = [];
$log = function (string $msg) use (&$logs): void {
$logs[] = $msg;
};
// 실 스텝 파일이 존재하지 않는 버전 범위 (9.9.8 → 9.9.9)
$result = $method->invoke($command, '9.9.8', '9.9.9', true, $log);
$this->assertTrue($result, '범위 내 스텝 파일이 없어 0건이면 정상 통과(true)여야 한다');
$allLogs = implode("\n", $logs);
$this->assertStringContainsString('실행할 스텝 없음', $allLogs, '스텝 부재 정상 통과 로그');
}
#[Test]
public function spawn_자식_범위내_스텝이_있는데_0건_실행이면_abort_throw_한다(): void
{
// 범위 내에 스텝 파일이 실제로 존재(discovered>0)하는데 executed=0 인 경우 —
// 이전 버전 자식이 신규 스텝을 놓치고 silent skip 한 이슈 #28 케이스 (케이스 A).
// 이 경우에만 fail-fast 를 발동해야 한다.
//
// 재현: 스텝 파일은 존재하나 자식의 runUpgradeSteps 가 executed 를 0 으로 보고하도록,
// discovered 는 세되 onStep 은 호출하지 않는 상황을 자식 프로세스 안에서 만들 수 없으므로,
// 부모 가드 로직(handleSpawnExit)을 직접 호출해 discovered>0 && executed=0 분기를 검증한다.
config(['app.update.spawn_failure_mode' => 'abort']);
$command = $this->makeCommandWithDummyIo();
$method = new \ReflectionMethod(CoreUpdateCommand::class, 'handleSpawnExit');
$method->setAccessible(true);
try {
$method->invoke($command, '9.9.8', '9.9.9', true, fn () => null);
$this->fail('step 0건 실행 시 mode=abort 에서 throw 되어야 한다');
// exitCode=0, handoffPayload=null, stepsExecuted=0, stepsDiscovered=5
$method->invoke($command, 0, null, 0, 5, '9.9.8', '9.9.9', fn () => null);
$this->fail('discovered>0 && executed=0 이면 mode=abort 에서 throw 되어야 한다');
} catch (UpgradeHandoffException $e) {
$this->assertStringContainsString('step 0건 실행', $e->reason);
$this->assertStringContainsString('발견 5건', $e->reason);
$this->assertSame('9.9.8', $e->afterVersion);
}
}
#[Test]
public function spawn_자식_silent_skip_시_fallback_모드는_false_반환한다(): void
public function handleSpawnExit_executed_0_discovered_0_이면_from_lt_to_여도_정상_통과한다(): void
{
// 케이스 B — 범위 내 스텝 파일 부재. from<to 여도 실패 아님 (스텝 불필요 릴리즈).
// proc_open 불필요한 순수 판정 로직 단위 검증.
config(['app.update.spawn_failure_mode' => 'abort']);
$command = $this->makeCommandWithDummyIo();
$method = new \ReflectionMethod(CoreUpdateCommand::class, 'handleSpawnExit');
$method->setAccessible(true);
$logs = [];
$log = function (string $msg) use (&$logs): void {
$logs[] = $msg;
};
// exitCode=0, handoffPayload=null, stepsExecuted=0, stepsDiscovered=0
$result = $method->invoke($command, 0, null, 0, 0, '7.0.0', '7.0.1', $log);
$this->assertTrue($result, 'discovered=0 이면 abort 모드에서도 정상 통과(true)');
$this->assertStringContainsString('실행할 스텝 없음', implode("\n", $logs));
}
#[Test]
public function handleSpawnExit_구버전_자식_discovered_null_은_레거시_fail_fast_판정을_유지한다(): void
{
// discovered 필드를 모르는 구버전 자식 — executed=0 + discovered=null + from<to.
// 신버전 부모는 이 케이스를 기존(레거시) fail-fast 로 판정해야 한다 (안전 우선).
config(['app.update.spawn_failure_mode' => 'abort']);
$command = $this->makeCommandWithDummyIo();
$method = new \ReflectionMethod(CoreUpdateCommand::class, 'handleSpawnExit');
$method->setAccessible(true);
try {
// stepsExecuted=0, stepsDiscovered=null (구버전 자식)
$method->invoke($command, 0, null, 0, null, '7.0.0', '7.0.1', fn () => null);
$this->fail('discovered=null + executed=0 + from<to 는 레거시 fail-fast 여야 한다');
} catch (UpgradeHandoffException $e) {
$this->assertStringContainsString('step 0건 실행', $e->reason);
$this->assertStringNotContainsString('발견', $e->reason, 'discovered 미상이므로 발견 건수 표기 없음');
}
}
#[Test]
public function spawn_자식_범위내_스텝_파일이_없어_0건이면_fallback_모드도_정상_통과한다(): void
{
if (! function_exists('proc_open')) {
$this->markTestSkipped('proc_open 미지원 환경');
@@ -134,7 +210,7 @@ class CoreUpdateCommandSpawnFailureTest extends TestCase
$result = $method->invoke($command, '9.9.8', '9.9.9', true, fn () => null);
$this->assertFalse($result, 'mode=fallback 에서 step 0건 실행은 false 반환');
$this->assertTrue($result, '스텝 파일 부재(discovered=0)는 fallback 모드에서도 정상 통과(true)');
}
#[Test]