fix(vendor-bundle): 코어 빌드 무한 행 해결 + 이커머스 알림 라벨 raw 노출 수정

이커머스 알림 정의 화면에서 order_pending_deposit·order_delivered 두 알림이
라벨 대신 raw 다국어 키로 표시되던 문제를 수정. settings.json 3로케일에 라벨
추가 + 렌더 회귀 테스트 + 브라우저 실측.

vendor-bundle 시스템 결함 5종 해결:
- (A/B) manifest 해시 기준을 활성이 아닌 출력(_bundled) 디렉토리로 통일해
 확장 업데이트가 composer_json_sha_mismatch 순환에 빠지던 문제 해소
- (C) 코어 빌드 시 composer autoload dump 의 async 손자 프로세스가 부모
 파이프 핸들을 상속·점유해 무한 대기하던 교착을, stdout/stderr 를 파이프
 아닌 파일 descriptor 로 받아 원천 차단 (파이프=행/파일=완주 A/B 실측으로 확정)
- (D) 빌드 실패 시 원본 번들 유실 방지 — 임시파일 성공 후 원자적 교체
- (E) Windows .bat 실행 시 bypass_shell 통일

코어 7.0.4 / 이커머스·언어팩 1.0.3 bump.
This commit is contained in:
HeuJung committed 2026-07-11 07:00:34 +09:00
1 parent a34a03eb40
commit 13e65131f4
30 files changed
+620 -79

No files matched your search

+184 -2
View File
@@ -2,8 +2,10 @@
namespace Tests\Unit\Extension\Vendor;
use App\Extension\Vendor\EnvironmentDetector;
use App\Extension\Vendor\Exceptions\VendorInstallException;
use App\Extension\Vendor\VendorBundler;
use App\Extension\Vendor\VendorBundleResult;
use App\Extension\Vendor\VendorIntegrityChecker;
use Illuminate\Support\Facades\File;
use Tests\TestCase;
@@ -79,7 +81,7 @@ class VendorBundlerTest extends TestCase
*
* 테스트는 단일 testDir 을 소스/출력 동일하게 사용 (코어 케이스와 유사).
*/
private function invokeBuild(string $target, bool $force = false, ?string $sourcePath = null, ?string $outputPath = null): \App\Extension\Vendor\VendorBundleResult
private function invokeBuild(string $target, bool $force = false, ?string $sourcePath = null, ?string $outputPath = null): VendorBundleResult
{
$reflection = new \ReflectionClass($this->bundler);
$method = $reflection->getMethod('build');
@@ -239,6 +241,157 @@ class VendorBundlerTest extends TestCase
$this->assertFileDoesNotExist($sourceDir.'/vendor-bundle.json');
}
/**
* 분리 구조에서 manifest 의 composer 해시는 **출력(_bundled)** 의 composer.json 기준이어야 합니다.
*
* 런타임 검증(VendorIntegrityChecker::verify)은 manifest 와 같은 디렉토리(_bundled 또는 그 복사본인
* staging)의 composer.json 을 대조한다. 해시를 활성 디렉토리에서 계산하면, _bundled 의 composer.json
* 만 변경된 상태(예: 버전 bump 직후)에서 manifest 가 영구히 불일치하여 module:update 가 막힌다.
*/
public function test_build_hashes_output_composer_json_not_source(): void
{
$sourceDir = $this->testDir.'/active';
$outputDir = $this->testDir.'/bundled';
File::ensureDirectoryExists($sourceDir);
File::ensureDirectoryExists($outputDir);
// 활성 — 구버전 (아직 update 가 반영되지 않은 상태)
File::put($sourceDir.'/composer.json', json_encode([
'name' => 'test/project',
'version' => '1.0.2',
'require' => ['php' => '^8.2', 'test/lib' => '^1.0'],
]));
File::put($sourceDir.'/composer.lock', json_encode([
'packages' => [
['name' => 'test/lib', 'version' => '1.0.0', 'type' => 'library'],
],
]));
// _bundled — 신버전 (작업자가 version bump 한 상태)
File::put($outputDir.'/composer.json', json_encode([
'name' => 'test/project',
'version' => '1.0.3',
'require' => ['php' => '^8.2', 'test/lib' => '^1.0'],
]));
$this->invokeBuild('test:split-hash', sourcePath: $sourceDir, outputPath: $outputDir);
$manifest = json_decode(File::get($outputDir.'/vendor-bundle.json'), true);
$this->assertSame(
$this->checker->computeFileHash($outputDir.'/composer.json'),
$manifest['composer_json_sha256'],
'manifest 의 composer_json_sha256 은 출력(_bundled) 의 composer.json 해시여야 합니다.'
);
// 검증자가 outputDir 을 sourceDir 로 verify 할 때 통과해야 한다 (module:update 경로 재현)
$this->assertTrue(
$this->checker->verify($outputDir)->valid,
'build 직후 _bundled 를 verify 하면 무결성 검증을 통과해야 합니다.'
);
}
/**
* 분리 구조에서 isStale 은 **출력(_bundled)** 의 composer.json 변경을 감지해야 합니다.
*
* 활성 디렉토리만 검사하면 _bundled 의 stale 을 up-to-date 로 오보하여, --check 가 재빌드 필요를
* 놓치고 이후 module:update 가 무결성 오류로 실패한다.
*/
public function test_is_stale_detects_output_composer_json_change(): void
{
$sourceDir = $this->testDir.'/active';
$outputDir = $this->testDir.'/bundled';
File::ensureDirectoryExists($sourceDir);
File::ensureDirectoryExists($outputDir);
$composerJson = json_encode([
'name' => 'test/project',
'version' => '1.0.2',
'require' => ['php' => '^8.2', 'test/lib' => '^1.0'],
]);
File::put($sourceDir.'/composer.json', $composerJson);
File::put($sourceDir.'/composer.lock', json_encode([
'packages' => [
['name' => 'test/lib', 'version' => '1.0.0', 'type' => 'library'],
],
]));
File::put($outputDir.'/composer.json', $composerJson);
$this->invokeBuild('test:split-stale', sourcePath: $sourceDir, outputPath: $outputDir);
$this->assertFalse(
$this->bundler->isStale($sourceDir, $outputDir),
'빌드 직후에는 stale 이 아니어야 합니다.'
);
// _bundled 의 composer.json 만 변경 (활성은 그대로) — 버전 bump 시나리오
File::put($outputDir.'/composer.json', json_encode([
'name' => 'test/project',
'version' => '1.0.3',
'require' => ['php' => '^8.2', 'test/lib' => '^1.0'],
]));
$this->assertTrue(
$this->bundler->isStale($sourceDir, $outputDir),
'_bundled 의 composer.json 이 변경되면 stale 로 판정해야 합니다.'
);
}
/**
* 재빌드가 실패하면 기존 번들 파일이 보존되어야 합니다.
*
* 기존 zip/manifest 를 staging 빌드 이전에 삭제하면, composer install 실패 시
* 새 파일이 생성되지 못한 채 원본만 유실되어 다음 module:update 가 번들 부재로
* 실패한다 (Windows 등에서 composer 실행이 불안정할 때 재현). 삭제는 재생성
* 성공이 확정된 뒤에 이뤄져야 한다.
*/
public function test_failed_rebuild_preserves_existing_bundle(): void
{
$this->createFakeProject();
// 1차 빌드 성공 — 정상 번들 생성
$this->invokeBuild('test:project');
$this->assertFileExists($this->testDir.'/vendor-bundle.zip');
$this->assertFileExists($this->testDir.'/vendor-bundle.json');
$originalZip = File::get($this->testDir.'/vendor-bundle.zip');
$originalManifest = File::get($this->testDir.'/vendor-bundle.json');
// composer install 이 실패하도록 러너 교체
$this->bundler->setComposerInstallRunner(function (): void {
throw new VendorInstallException(
errorKey: 'bundle_build_composer_failed',
context: ['exit' => 1, 'message' => 'simulated composer failure'],
);
});
// 2차 빌드(force) — 실패해야 하지만 기존 번들은 보존되어야 함
try {
$this->invokeBuild('test:project', force: true);
$this->fail('composer install 실패 시 빌드는 예외를 던져야 합니다.');
} catch (VendorInstallException) {
// 예상된 실패
}
$this->assertFileExists(
$this->testDir.'/vendor-bundle.zip',
'재빌드 실패 시 기존 zip 이 보존되어야 합니다.'
);
$this->assertFileExists(
$this->testDir.'/vendor-bundle.json',
'재빌드 실패 시 기존 manifest 가 보존되어야 합니다.'
);
$this->assertSame(
$originalZip,
File::get($this->testDir.'/vendor-bundle.zip'),
'보존된 zip 은 원본과 동일해야 합니다.'
);
$this->assertSame(
$originalManifest,
File::get($this->testDir.'/vendor-bundle.json'),
'보존된 manifest 는 원본과 동일해야 합니다.'
);
}
/**
* 외부 의존성 없는 확장은 isStale 이 항상 false 를 반환해야 합니다.
*/
@@ -306,7 +459,7 @@ class VendorBundlerTest extends TestCase
*/
public function test_build_throws_when_composer_not_available(): void
{
$detector = \Mockery::mock(\App\Extension\Vendor\EnvironmentDetector::class);
$detector = \Mockery::mock(EnvironmentDetector::class);
$detector->shouldReceive('canExecuteComposer')->andReturn(false);
$bundler = new VendorBundler($this->checker, $detector);
@@ -321,4 +474,33 @@ class VendorBundlerTest extends TestCase
$method->setAccessible(true);
$method->invoke($bundler, $this->testDir, $this->testDir, 'test:no-composer', false);
}
/**
* composer install 의 stdout/stderr 는 파이프가 아닌 파일 descriptor 로 열려야 한다.
*
* (Windows 회귀 가드) stdout/stderr 를 파이프로 열면 composer autoload dump 단계의
* async `cmd.exe` 손자 프로세스가 부모 파이프 핸들을 상속·점유해 proc_close 가
* 자식 완료 신호를 받지 못하고 무한 대기(행)한다. 실측: 파이프=행, 파일=140s 완주.
* descriptor 구조를 파이프로 되돌리면 이 테스트가 red 로 회귀를 차단한다.
*/
public function test_composer_output_descriptors_use_files_not_pipes(): void
{
$descriptors = VendorBundler::composerOutputDescriptors('/tmp/out.log', '/tmp/err.log');
// stdin 은 파이프(입력 없음 즉시 닫힘) 로 유지.
$this->assertSame(['pipe', 'r'], $descriptors[0]);
// stdout/stderr 는 파일 descriptor 여야 한다 (파이프 금지 — 손자 핸들 상속 차단).
$this->assertSame('file', $descriptors[1][0], 'stdout 은 파일 descriptor 여야 함 (파이프 시 Windows 행 회귀)');
$this->assertSame('/tmp/out.log', $descriptors[1][1]);
$this->assertSame('w', $descriptors[1][2]);
$this->assertSame('file', $descriptors[2][0], 'stderr 은 파일 descriptor 여야 함 (파이프 시 Windows 행 회귀)');
$this->assertSame('/tmp/err.log', $descriptors[2][1]);
$this->assertSame('w', $descriptors[2][2]);
// 어떤 채널도 'pipe','w' 로 열리지 않아야 함 (손자 상속 가능한 열린 파이프 부재).
$this->assertNotSame('pipe', $descriptors[1][0]);
$this->assertNotSame('pipe', $descriptors[2][0]);
}
}