Files
Gnuboard7/tests/Unit/Rules/SourcemapServingEnvironmentTest.php
T
HeuJung d6e1f98a4f fix(core): 확장 오토로드 캐시 공집합 덮어쓰기로 인한 전역 500 + 소스맵 노출 차단 복원
오토로드 캐시(psr4)가 공집합으로 덮어써져 모든 모듈/플러그인 컨트롤러가
해석 불가능해지고 확장 화면 전체가 500 이 됐다. 이 매핑은 "DB 설치 목록 ×
디스크 활성 디렉토리" 교집합이라 DB 쪽만 일시적으로 비어도(테이블 부재·
설치 중간 실패·testing DB) 정상 매핑이 통째로 소실된다. 코어 라우트는 200
인데 확장 라우트만 전부 500 인 비대칭이 이 결함의 진단 단서다.

- 디스크에 확장 디렉토리가 남아 있는데 매핑이 0건이면 기록하지 않고 보존.
 정상적인 0건(신규 설치·마지막 확장 삭제)은 디스크도 함께 비어 통과한다
- generateAutoloadFile 에 testing 실 캐시 경로 쓰기 차단. updateComposerAutoload
 에만 있던 가드를 생성기 자체로 옮겨 어느 경로로 들어와도 막히게 했다
- extension:update-autoload 가 훅 캐시 재생성 전에 런타임 오토로드를 재등록.
 미재등록 시 깨진 매핑으로 훅 캐시가 modules/plugins 0건으로 생성되어
 확장 훅이 조용히 사라지고, 복구에 커맨드 2회 실행이 필요했다

소스맵 서빙은 에서 차단했으나 이번 브랜치에서 화이트리스트에 재추가되어
운영에서 원본 코드 전문(sourcesContent)이 노출될 수 있었다. 이 화이트리스트가
확장 에셋 서빙의 유일한 방어선이다. dev 빌드의 sourceMappingURL 404 를 피하면서
운영을 막도록 local 환경에서만 허용하도록 분기하고, 산출물을 production 으로
재빌드해 docroot 에 남아 있던 소스맵을 제거했다. --production 빌드는 소스맵을
생성하지 않을 뿐 기존 파일을 지우지 않는다.

CoreUpdateCommandSpawnFailureTest 는 in-process fallback 이 실제 업그레이드
스텝을 돌려 코어 역할·권한·메뉴를 커밋하는데 RefreshDatabase 가 없어, 이후
모든 테스트 클래스가 중복 키로 깨졌다(단독 실행 시 미재현).
2026-07-23 13:04:59 +09:00

104 lines
3.8 KiB
PHP

<?php
namespace Tests\Unit\Rules;
use App\Rules\AllowedModuleFileType;
use App\Rules\AllowedPluginFileType;
use App\Rules\AllowedTemplateFileType;
use Illuminate\Support\Facades\Validator;
use PHPUnit\Framework\Attributes\DataProvider;
use Tests\TestCase;
/**
* 소스맵 에셋 서빙의 환경별 허용 계약 테스트.
*
* 소스맵에는 원본 TS/TSX 전문(`sourcesContent`)이 담기고, 확장 에셋 서빙에서
* 이 확장자 화이트리스트가 유일한 방어선이다. 따라서 운영 환경에서는 어떤
* 경우에도 `.map` 이 서빙되면 안 된다.
*
* 동시에 로컬 개발 환경의 dev 빌드 산출물은 `//# sourceMappingURL` 이 개별
* 에셋 서빙 URL 을 가리키므로, 차단하면 브라우저 콘솔에 404 가 쌓인다.
* 두 요구를 환경으로 가른다.
*/
class SourcemapServingEnvironmentTest extends TestCase
{
/**
* 검증 대상 규칙 클래스 목록
*
* @return array<string, array{class-string, string}>
*/
public static function ruleProvider(): array
{
return [
'module' => [AllowedModuleFileType::class, 'dist/js/module.iife.js.map'],
'plugin' => [AllowedPluginFileType::class, 'dist/js/plugin.iife.js.map'],
'template' => [AllowedTemplateFileType::class, 'dist/js/components.iife.js.map'],
];
}
/**
* 운영 환경에서 소스맵이 차단되는지 테스트
*
* @param class-string $ruleClass 규칙 클래스
* @param string $sourcemapPath 소스맵 경로
*/
#[DataProvider('ruleProvider')]
public function test_sourcemap_is_blocked_in_production(string $ruleClass, string $sourcemapPath): void
{
$this->app->detectEnvironment(fn () => 'production');
$this->assertNotContains('map', $ruleClass::getAllowedExtensions());
$validator = Validator::make(['path' => $sourcemapPath], ['path' => new $ruleClass]);
$this->assertFalse(
$validator->passes(),
$ruleClass.': 운영 환경에서 소스맵이 서빙되면 원본 코드 전문이 노출됩니다.'
);
}
/**
* 로컬 개발 환경에서 소스맵이 허용되는지 테스트
*
* @param class-string $ruleClass 규칙 클래스
* @param string $sourcemapPath 소스맵 경로
*/
#[DataProvider('ruleProvider')]
public function test_sourcemap_is_allowed_in_local(string $ruleClass, string $sourcemapPath): void
{
$this->app->detectEnvironment(fn () => 'local');
$this->assertContains('map', $ruleClass::getAllowedExtensions());
$validator = Validator::make(['path' => $sourcemapPath], ['path' => new $ruleClass]);
$this->assertTrue(
$validator->passes(),
$ruleClass.': 로컬 개발 환경에서는 dev 빌드의 소스맵 참조가 404 가 되지 않도록 허용해야 합니다.'
);
}
/**
* 소스맵 외 확장자는 환경과 무관하게 동일하게 허용되는지 테스트
*
* 환경 분기가 소스맵에만 적용되고 다른 확장자에는 영향을 주지 않아야 한다.
*
* @param class-string $ruleClass 규칙 클래스
*/
#[DataProvider('ruleProvider')]
public function test_non_sourcemap_extensions_are_environment_independent(string $ruleClass): void
{
$this->app->detectEnvironment(fn () => 'production');
$production = $ruleClass::getAllowedExtensions();
$this->app->detectEnvironment(fn () => 'local');
$local = $ruleClass::getAllowedExtensions();
$this->assertSame(
['map'],
array_values(array_diff($local, $production)),
$ruleClass.': 환경에 따라 달라지는 확장자는 소스맵 하나뿐이어야 합니다.'
);
}
}