gper/Gnuboard7
1
0 Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

v7.0.0 release

Browse Source
This commit is contained in:
HeuJung committed 2026-07-01 10:30:32 +09:00
1 parent 0e7fa04b03
commit c4ea9a6cd1
3582 files changed
+626189 -160151
Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

tests/Unit/Installer/InstallerGuardTest.php
+148 -33
View File
@@ -22,30 +22,46 @@ class InstallerGuardTest extends TestCase
{
private static string $tempBase = '';
private static string $skipReason = '';
public static function setUpBeforeClass(): void
{
self::$tempBase = sys_get_temp_dir() . '/g7-installer-guard-test-' . bin2hex(random_bytes(4));
mkdir(self::$tempBase . '/storage/app', 0755, true);
// 안전 가드: 본 테스트는 BASE_PATH/.env 와 BASE_PATH/storage/app/g7_installed 를
// 직접 write/unlink 한다. BASE_PATH 는 PHP 상수라 한 프로세스에서 단 한 번만 정의되며,
// 다른 Installer 테스트가 먼저 프로젝트 루트로 박으면 본 테스트의 cleanup() 이
// 실제 운영 .env 를 삭제하게 된다. BASE_PATH 가 시스템 temp 하위가 아니면 skip 한다.
$tempPrefix = realpath(sys_get_temp_dir()) ?: sys_get_temp_dir();
// BASE_PATH 가 다른 테스트에서 이미 정의되었을 수 있다.
// 그 경우 폴백 (installer_resolve_base_path) 가 본 파일 위치 기준으로 결정되므로
// 본 테스트는 정의된 BASE_PATH 를 그대로 사용하고, 그 안에 격리 디렉토리를 만든다.
if (! defined('BASE_PATH')) {
define('BASE_PATH', self::$tempBase);
} else {
// 다른 테스트의 BASE_PATH 와 공존 — 그 디렉토리 안에 lock/.env 를 두고 정리.
self::$tempBase = BASE_PATH;
if (! is_dir(BASE_PATH . '/storage/app')) {
@mkdir(BASE_PATH . '/storage/app', 0755, true);
if (defined('BASE_PATH')) {
$resolved = realpath((string) BASE_PATH) ?: (string) BASE_PATH;
if (strpos($resolved, $tempPrefix) !== 0) {
self::$skipReason = 'BASE_PATH ('.$resolved.') 가 시스템 temp 하위가 아님 — '
.'다른 Installer 테스트의 BASE_PATH 정의가 선행됨. 실제 .env 파괴 방지를 위해 skip. '
.'격리 실행: php vendor/bin/phpunit --filter=InstallerGuardTest';
return;
}
self::$tempBase = (string) BASE_PATH;
} else {
self::$tempBase = sys_get_temp_dir().'/g7-installer-guard-test-'.bin2hex(random_bytes(4));
define('BASE_PATH', self::$tempBase);
}
require_once dirname(__DIR__, 3) . '/public/install/api/_guard.php';
if (! is_dir(self::$tempBase.'/storage/app')) {
@mkdir(self::$tempBase.'/storage/app', 0755, true);
}
require_once dirname(__DIR__, 3).'/public/install/api/_guard.php';
}
protected function setUp(): void
{
parent::setUp();
if (self::$skipReason !== '') {
$this->markTestSkipped(self::$skipReason);
}
$this->cleanup();
}
@@ -57,11 +73,16 @@ class InstallerGuardTest extends TestCase
private function cleanup(): void
{
$lock = BASE_PATH . '/storage/app/g7_installed';
// skip 상태(= BASE_PATH 가 실 루트)면 파괴적 정리를 절대 수행하지 않는다.
if (self::$skipReason !== '') {
return;
}
$lock = BASE_PATH.'/storage/app/g7_installed';
if (is_file($lock)) {
@unlink($lock);
}
$env = BASE_PATH . '/.env';
$env = BASE_PATH.'/.env';
if (is_file($env)) {
@unlink($env);
}
@@ -74,50 +95,50 @@ class InstallerGuardTest extends TestCase
public function test_lock_file_only_marks_completed(): void
{
file_put_contents(BASE_PATH . '/storage/app/g7_installed', '');
file_put_contents(BASE_PATH.'/storage/app/g7_installed', '');
$this->assertTrue(installer_is_completed());
}
public function test_env_flag_only_marks_completed(): void
{
file_put_contents(BASE_PATH . '/.env', "APP_ENV=local\nINSTALLER_COMPLETED=true\n");
file_put_contents(BASE_PATH.'/.env', "APP_ENV=local\nINSTALLER_COMPLETED=true\n");
$this->assertTrue(installer_is_completed());
}
public function test_env_flag_accepts_quoted_true(): void
{
file_put_contents(BASE_PATH . '/.env', 'INSTALLER_COMPLETED="true"' . "\n");
file_put_contents(BASE_PATH.'/.env', 'INSTALLER_COMPLETED="true"'."\n");
$this->assertTrue(installer_is_completed());
}
public function test_env_flag_accepts_one(): void
{
file_put_contents(BASE_PATH . '/.env', 'INSTALLER_COMPLETED=1' . "\n");
file_put_contents(BASE_PATH.'/.env', 'INSTALLER_COMPLETED=1'."\n");
$this->assertTrue(installer_is_completed());
}
public function test_env_flag_false_does_not_mark_completed(): void
{
file_put_contents(BASE_PATH . '/.env', "APP_ENV=local\nINSTALLER_COMPLETED=false\n");
file_put_contents(BASE_PATH.'/.env', "APP_ENV=local\nINSTALLER_COMPLETED=false\n");
$this->assertFalse(installer_is_completed());
}
public function test_env_flag_missing_does_not_mark_completed(): void
{
file_put_contents(BASE_PATH . '/.env', "APP_ENV=local\n");
file_put_contents(BASE_PATH.'/.env', "APP_ENV=local\n");
$this->assertFalse(installer_is_completed());
}
public function test_both_signals_present_marks_completed(): void
{
file_put_contents(BASE_PATH . '/storage/app/g7_installed', '');
file_put_contents(BASE_PATH . '/.env', 'INSTALLER_COMPLETED=true' . "\n");
file_put_contents(BASE_PATH.'/storage/app/g7_installed', '');
file_put_contents(BASE_PATH.'/.env', 'INSTALLER_COMPLETED=true'."\n");
$this->assertTrue(installer_is_completed());
}
@@ -127,17 +148,17 @@ class InstallerGuardTest extends TestCase
//
// 일반 가드와 달리 g7_installed 락 파일은 차단 사유에서 제외되어야 한다
// (complete_flag task 가 락 파일을 먼저 생성한 직후 finalize 가 호출되는
// 설계상의 호출 순서 때문 — 이슈 #371 자가 차단 회귀 가드).
// 설계상의 호출 순서 때문 — 자가 차단 회귀 가드).
// ------------------------------------------------------------------------
public function test_finalize_guard_passes_with_lock_only(): void
{
// 정상 1회차 finalize 시나리오: 락 파일은 존재하나 .env 머지 아직 안 됨
file_put_contents(BASE_PATH . '/storage/app/g7_installed', '');
file_put_contents(BASE_PATH.'/storage/app/g7_installed', '');
$this->assertFalse(
installer_finalize_is_completed(),
'g7_installed 락 파일 단독 존재 시 finalize 차단되면 자가 차단 회귀 (이슈 #371)'
'g7_installed 락 파일 단독 존재 시 finalize 차단되면 자가 차단 회귀'
);
}
@@ -150,7 +171,7 @@ class InstallerGuardTest extends TestCase
public function test_finalize_guard_blocks_when_env_completed_true(): void
{
// 이미 finalize 된 상태 — 멱등 차단
file_put_contents(BASE_PATH . '/.env', "APP_ENV=local\nINSTALLER_COMPLETED=true\n");
file_put_contents(BASE_PATH.'/.env', "APP_ENV=local\nINSTALLER_COMPLETED=true\n");
$this->assertTrue(installer_finalize_is_completed());
}
@@ -158,28 +179,122 @@ class InstallerGuardTest extends TestCase
public function test_finalize_guard_blocks_with_lock_and_env_completed(): void
{
// 락 + .env true 동시 존재 → 차단 (멱등)
file_put_contents(BASE_PATH . '/storage/app/g7_installed', '');
file_put_contents(BASE_PATH . '/.env', 'INSTALLER_COMPLETED=true' . "\n");
file_put_contents(BASE_PATH.'/storage/app/g7_installed', '');
file_put_contents(BASE_PATH.'/.env', 'INSTALLER_COMPLETED=true'."\n");
$this->assertTrue(installer_finalize_is_completed());
}
public function test_finalize_guard_passes_when_env_completed_false(): void
{
file_put_contents(BASE_PATH . '/.env', "INSTALLER_COMPLETED=false\n");
file_put_contents(BASE_PATH.'/.env', "INSTALLER_COMPLETED=false\n");
$this->assertFalse(installer_finalize_is_completed());
}
public function test_finalize_guard_accepts_quoted_and_alt_truthy_values(): void
{
file_put_contents(BASE_PATH . '/.env', 'INSTALLER_COMPLETED="true"' . "\n");
file_put_contents(BASE_PATH.'/.env', 'INSTALLER_COMPLETED="true"'."\n");
$this->assertTrue(installer_finalize_is_completed());
file_put_contents(BASE_PATH . '/.env', 'INSTALLER_COMPLETED=1' . "\n");
file_put_contents(BASE_PATH.'/.env', 'INSTALLER_COMPLETED=1'."\n");
$this->assertTrue(installer_finalize_is_completed());
file_put_contents(BASE_PATH . '/.env', 'INSTALLER_COMPLETED=yes' . "\n");
file_put_contents(BASE_PATH.'/.env', 'INSTALLER_COMPLETED=yes'."\n");
$this->assertTrue(installer_finalize_is_completed());
}
// ------------------------------------------------------------------------
// state-management.php 진입 가드 정적 회귀 (KVE-2026-1056)
//
// state-management.php?action=get 은 정상 설치 흐름의 1초 폴링이며,
// complete_flag task 가 g7_installed 락 파일을 finalize 보다 먼저 생성한다.
// 따라서 일반 가드(installer_guard_or_410, 락 파일도 차단 사유)를 적용하면
// "락만 있고 .env 플래그는 아직 없는" 폴링 구간이 410 으로 끊겨 완료 화면이
// 표시되지 않는 자가 차단 회귀가 발생한다.
//
// 올바른 조치: finalize 전용 가드(installer_guard_finalize_or_410,
// .env INSTALLER_COMPLETED=true 단독 판정)를 객체 생성 전에 호출한다.
// exit/header 는 단위에서 검증 불가하므로 소스 정적 검사로 회귀를 못박는다.
// ------------------------------------------------------------------------
private function stateManagementSource(): string
{
$path = dirname(__DIR__, 3).'/public/install/api/state-management.php';
$this->assertFileExists($path, 'state-management.php 가 존재해야 한다');
return (string) file_get_contents($path);
}
public function test_state_management_loads_guard_file(): void
{
$src = $this->stateManagementSource();
$this->assertMatchesRegularExpression(
'/require(?:_once)?\s+__DIR__\s*\.\s*[\'"]\/_guard\.php[\'"]/',
$src,
'state-management.php 가 _guard.php 를 로드해야 한다'
);
}
public function test_state_management_calls_finalize_guard_not_general_guard(): void
{
$src = $this->stateManagementSource();
$this->assertStringContainsString(
'installer_guard_finalize_or_410()',
$src,
'state-management.php 는 finalize 전용 가드를 호출해야 한다 (.env 플래그 단독 판정)'
);
// 일반 가드를 쓰면 락-only 폴링 구간이 410 으로 끊겨 정상 설치가 깨진다.
$this->assertDoesNotMatchRegularExpression(
'/(?<!finalize_)installer_guard_or_410\s*\(\s*\)/',
$src,
'state-management.php 는 일반 installer_guard_or_410() 을 호출하면 안 된다 '
.'(complete_flag 락 파일로 인한 폴링 자가 차단 회귀)'
);
}
public function test_state_management_guard_runs_before_api_instantiation(): void
{
$src = $this->stateManagementSource();
$guardPos = strpos($src, 'installer_guard_finalize_or_410()');
$instantiatePos = strpos($src, 'new StateManagementApi');
$this->assertNotFalse($guardPos, 'finalize 가드 호출이 존재해야 한다');
$this->assertNotFalse($instantiatePos, 'StateManagementApi 인스턴스화가 존재해야 한다');
$this->assertLessThan(
$instantiatePos,
$guardPos,
'가드는 StateManagementApi 객체 생성 전에 호출되어야 한다 (모든 action 일괄 차단)'
);
}
public function test_state_management_polling_passes_with_lock_only(): void
{
// 핵심 비파괴 불변식: complete_flag 직후~finalize 전 구간(락만 존재)에서
// finalize 가드는 통과해야 한다 — 폴링이 completed 상태를 받아야 완료 화면 전환.
file_put_contents(BASE_PATH.'/storage/app/g7_installed', '');
$this->assertFalse(
installer_finalize_is_completed(),
'g7_installed 락 단독 존재 시 state-management 폴링이 차단되면 '
.'정상 설치가 "진행 중"에 고착된다 (KVE-2026-1056 조치의 비파괴 조건)'
);
}
public function test_state_management_blocks_when_env_completed(): void
{
// 완전 완료 상태(.env 플래그 set)에서는 get/reset/abort 가 차단되어야 한다 —
// KVE-2026-1056 의 보호장치 우회·상태 변조 공격 표면 제거.
file_put_contents(BASE_PATH.'/.env', "APP_ENV=local\nINSTALLER_COMPLETED=true\n");
$this->assertTrue(
installer_finalize_is_completed(),
'완전 설치 완료 상태에서 state-management 가 차단되어야 한다 (KVE-2026-1056)'
);
}
}