feat(core,admin_basic): .env 키 단위 우선 모드 추가

관리자 환경설정 저장값이 config 를 덮는 기존 설계는 공유호스팅을 1차 대상으로
삼은 결과다. .env 를 배포 기준값으로 관리하는 설치에서는 그 설계가 반대로
작동해, 설치기가 defaults 를 시드하는 순간부터 .env 의 28개 항목이 오류도
로그도 없이 사문화된다.

G7_ENV_PRIORITY 옵트인으로 그 소유권을 키 단위로 되돌린다. 스위치를 켜지 않은
설치는 전 경로가 조기 return 이라 동작이 100% 동일하다.

명시 여부는 config 빌드 시점에 캡처한다 — 런타임 env 는 config:cache 환경에서
null 로 고정되어 판정이 영구 미발동한다(attachment.disk_explicit 와 같은 함정).
판정은 strict 라 APP_DEBUG=false·REDIS_DB=0 같은 falsy 명시도 명시로 본다.

잠금은 그 키의 주입만 건너뛰는 것이지만, 제거된 키의 부재를 값으로 읽는 자리가
있으면 형제 설정까지 무너진다. 게이트(웹소켓 토글·메일 드라이버·디버그 모드)와
기본값 주입(mailgun.endpoint·ses.region), 형제 폴백(reverb server endpoint),
파생 판정(storage_driver→attachment.disk)을 유효값으로 보정했다.
This commit is contained in:
HeuJung committed 2026-09-04 10:08:30 +09:00
1 parent b97deee43a
commit 381fcc4e0b
37 files changed
+4026 -118

No files matched your search

@@ -0,0 +1,455 @@
<?php
namespace Tests\Feature\Settings;
use App\Support\EnvPriority;
use Tests\TestCase;
/**
* `.env` 키 단위 우선 규약의 계약 테스트.
*
* 이 결함군은 오류를 남기지 않는다 — 매핑이 뒤처지거나 배선이 빠지면 잠금이 조용히
* 미발동하고, 그 상태는 "그 키가 `.env` 에 없다"와 화면상 구분되지 않는다. 그래서
* 판정을 행위가 아니라 **구조**(맵 패리티 · 캡처 일치 · 배선 실존)로 고정한다.
*
* @effects explicit_env_skips_injection, empty_string_env_not_explicit
*/
class EnvPriorityContractTest extends TestCase
{
/**
* 주입 대상 카테고리의 모든 defaults 키는 MAP 이나 EXEMPT 에 등재되어 있습니다.
*
* Provider 에 새 주입이 추가되면 이 단언이 red 가 되어, 그 키가 `.env` 대응을 갖는지
* 판단하도록 강제합니다. 등재를 잊으면 그 키는 영원히 settings 승으로 남습니다.
*
* @effects map_parity_covers_every_injected_default_key
*/
public function test_모든_주입_카테고리_키가_맵이나_면제목록에_등재된다(): void
{
$defaults = $this->loadDefaults();
$unregistered = [];
foreach (EnvPriority::INJECTED_CATEGORIES as $category) {
foreach (array_keys($defaults[$category] ?? []) as $key) {
$storageKey = $category.'.'.$key;
if (! array_key_exists($storageKey, EnvPriority::MAP)
&& ! array_key_exists($storageKey, EnvPriority::EXEMPT)) {
$unregistered[] = $storageKey;
}
}
}
$this->assertSame(
[],
$unregistered,
'EnvPriority::MAP 또는 EXEMPT 에 등재되지 않은 설정 키: '.implode(', ', $unregistered)
);
}
/**
* MAP 의 모든 settings 키는 defaults.json 에 실존합니다.
*
* 반대 방향 — 오타나 사라진 키가 맵에 남아 있으면 그 항목은 영원히 잠기지 않습니다.
*
* @effects map_parity_covers_every_injected_default_key
*/
public function test_맵의_모든_키가_defaults에_실존한다(): void
{
$defaults = $this->loadDefaults();
$missing = [];
foreach (array_keys(EnvPriority::MAP + EnvPriority::EXEMPT) as $storageKey) {
[$category, $key] = explode('.', $storageKey, 2);
if (! array_key_exists($key, $defaults[$category] ?? [])) {
$missing[] = $storageKey;
}
}
$this->assertSame(
[],
$missing,
'defaults.json 에 없는 키가 맵/면제목록에 남아 있습니다: '.implode(', ', $missing)
);
}
/**
* MAP 의 모든 config 키는 실존하는 config 경로입니다.
*
* 오타난 config 키는 표시값이 조용히 null 이 되고, 문서 근거도 함께 어긋납니다.
* 런타임에 생성되는 키(`RUNTIME_CREATED_CONFIG_KEYS`)만 사유와 함께 제외합니다.
*
* @effects locked_plain_shows_effective_value
*/
public function test_맵의_config_키가_실존한다(): void
{
$missing = [];
foreach (EnvPriority::MAP as $storageKey => $entry) {
foreach ($entry['config'] as $configKey) {
if (in_array($configKey, EnvPriority::RUNTIME_CREATED_CONFIG_KEYS, true)) {
continue;
}
if (! config()->has($configKey)) {
$missing[] = $storageKey.' → '.$configKey;
}
}
}
$this->assertSame(
[],
$missing,
'실존하지 않는 config 키: '.implode(', ', $missing)
);
}
/**
* `config/env-priority.php` 의 캡처 대상이 `EnvPriority::envVars()` 와 일치합니다.
*
* 캡처 목록이 뒤처지면 그 env 변수는 명시해도 잠기지 않습니다 — 오류 없이.
*
* @effects explicit_env_skips_injection
*/
public function test_캡처_대상이_맵의_env_변수와_일치한다(): void
{
$source = (string) file_get_contents(config_path('env-priority.php'));
$this->assertStringContainsString(
'EnvPriority::envVars()',
$source,
'config/env-priority.php 는 캡처 대상을 EnvPriority::envVars() 에서 도출해야 합니다 (목록 중복 기재 금지).'
);
// 실제 평가 결과가 맵의 변수만 다루는지도 확인한다 (SSoT 도출이 형식만 남는 것 차단).
$captured = require config_path('env-priority.php');
$this->assertIsArray($captured['explicit']);
$this->assertSame(
[],
array_diff(array_keys($captured['explicit']), EnvPriority::envVars()),
'캡처 결과에 맵 밖의 env 변수가 섞였습니다.'
);
}
/**
* 스위치는 `config('env-priority.enabled')` 만으로 해석됩니다.
*
* @effects switch_off_behaves_identically
*/
public function test_스위치가_config_로만_해석된다(): void
{
$source = (string) file_get_contents(app_path('Support/EnvPriority.php'));
$stripped = $this->stripComments($source);
$this->assertStringNotContainsString(
'env(',
$stripped,
'EnvPriority 안에서 env() 를 읽으면 config:cache 환경에서 null 로 고정되어 판정이 영구 미발동합니다.'
);
config(['env-priority.enabled' => true]);
$this->assertTrue(EnvPriority::enabled());
config(['env-priority.enabled' => false]);
$this->assertFalse(EnvPriority::enabled());
}
/**
* `SettingsServiceProvider` 의 모든 주입 지점에 잠금 필터가 배선되어 있습니다.
*
* 한 곳이라도 빠지면 그 카테고리만 조용히 `.env` 를 계속 덮습니다.
*
* 모집단은 `getCategory('<카테고리>')` 호출부에서 **도출한다** — 메서드 이름을 손으로
* 열거하면 새 주입 메서드가 늘어도 케이스 없이 통과한다(오늘 우연히 일치할 뿐이다).
* EXEMPT 키만 읽어 필터가 no-op 인 지점은 그 메서드 안의 `audit:allow` 사유로 면제한다.
*
* @effects explicit_env_skips_injection
*/
public function test_provider_주입_지점에_잠금_필터가_배선된다(): void
{
$sites = $this->injectionSites();
// 하한 — 도출식이 죽으면 이 단언이 "위반 0" 으로 위장된다.
$this->assertNotEmpty(
$sites,
"getCategory('<카테고리>') 주입 지점을 하나도 도출하지 못했습니다 — 호출 형태가 바뀌었다면 이 도출식도 함께 갱신해야 합니다."
);
$missing = [];
foreach ($sites as $site) {
if (str_contains($site['body'], 'audit:allow env-priority-filter-wiring')) {
continue;
}
if (! str_contains($site['body'], "EnvPriority::filterLocked('{$site['category']}'")) {
$missing[] = "{$site['method']}() → {$site['category']}";
}
}
$this->assertSame(
[],
$missing,
'잠금 필터가 배선되지 않은 주입 지점: '.implode(', ', $missing)
);
}
/**
* `INJECTED_CATEGORIES` 가 소스에서 도출한 주입 카테고리 집합과 일치합니다.
*
* 이 상수는 맵 패리티 검사의 모집단이다. 손으로 적힌 채 뒤처지면 새 카테고리의 키가
* MAP/EXEMPT 등재 검사를 통째로 비껴가고, 그 상태는 "이상 0건" 과 구분되지 않는다.
*
* @effects map_parity_covers_every_injected_default_key
*/
public function test_주입_카테고리_상수가_소스_도출_결과와_일치한다(): void
{
$derived = array_values(array_unique(array_column($this->injectionSites(), 'category')));
sort($derived);
$declared = EnvPriority::INJECTED_CATEGORIES;
sort($declared);
$this->assertNotEmpty($derived, '주입 카테고리를 하나도 도출하지 못했습니다.');
$this->assertSame(
$derived,
$declared,
'EnvPriority::INJECTED_CATEGORIES 가 Provider 의 실제 주입 카테고리와 어긋납니다 — '
.'누락된 카테고리의 키는 MAP/EXEMPT 등재 검사를 받지 않습니다.'
);
}
/**
* `defaults.json` 이 민감으로 표시한 키는 MAP 에서도 민감으로 표시됩니다.
*
* 표시값 오버레이는 MAP 의 `sensitive` 플래그만 보고 건너뛴다. 그런데 민감 여부의
* 본래 출처는 `frontend_schema` 라, 두 곳이 갈라지면 그 키의 `.env` 비밀값이
* 관리자 응답에 조용히 실린다 — 오류도 로그도 남지 않는다.
*
* 반대 방향(MAP 만 민감)은 과하게 가리는 쪽이라 안전측이므로 검사하지 않는다.
*
* @effects locked_sensitive_hides_effective_value
*/
public function test_스키마가_민감으로_표시한_키는_맵에서도_민감이다(): void
{
$schema = json_decode(
(string) file_get_contents(config_path('settings/defaults.json')),
true
)['frontend_schema'] ?? [];
$schemaSensitive = [];
foreach ($schema as $category => $definition) {
foreach (($definition['fields'] ?? []) as $key => $field) {
if (($field['sensitive'] ?? false) === true) {
$schemaSensitive[] = $category.'.'.$key;
}
}
}
// 하한 — 스키마 형태가 바뀌어 0건이 되면 이 검사는 아무것도 재지 않는다.
$this->assertNotEmpty(
$schemaSensitive,
'frontend_schema 에서 민감 키를 하나도 도출하지 못했습니다 — 스키마 형태가 바뀌었다면 이 도출식도 함께 갱신해야 합니다.'
);
$unflagged = [];
foreach ($schemaSensitive as $storageKey) {
if (! array_key_exists($storageKey, EnvPriority::MAP)) {
continue; // 잠금 대상이 아니면 오버레이 자체가 없다
}
if (! EnvPriority::isSensitive($storageKey)) {
$unflagged[] = $storageKey;
}
}
$this->assertSame(
[],
$unflagged,
"defaults.json 이 민감으로 표시했으나 EnvPriority::MAP 에 'sensitive' => true 가 없는 키: "
.implode(', ', $unflagged).' — 이 키들은 잠기면 `.env` 값이 화면에 노출됩니다.'
);
}
/**
* testing 격리 가드가 런타임 `env('APP_ENV')` 로 되돌아가지 않습니다.
*
* config:cache 환경에서 env() 는 null 이라 가드가 통째로 무력해집니다.
*
* @effects switch_off_behaves_identically
*/
public function test_provider_가_런타임_env_로_환경을_판별하지_않는다(): void
{
$source = (string) file_get_contents(app_path('Providers/SettingsServiceProvider.php'));
$stripped = $this->stripComments($source);
$this->assertStringNotContainsString(
"env('APP_ENV')",
$stripped,
"환경 판별은 app()->environment() 로 합니다 — env('APP_ENV') 는 config:cache 에서 null 입니다."
);
$this->assertStringNotContainsString(
"env('G7_ENV_PRIORITY')",
$stripped,
'스위치는 config(env-priority.enabled) 로만 읽습니다.'
);
}
/**
* `.env.example` 은 스위치를 주석 상태로 안내하고, 테스트용 env 는 활성 라인을 두지 않습니다.
*
* @effects env_examples_document_env_priority_switch
*/
public function test_env_예시가_스위치를_주석으로_안내한다(): void
{
$example = (string) file_get_contents(base_path('.env.example'));
$this->assertStringContainsString('G7_ENV_PRIORITY', $example, '.env.example 에 스위치 안내가 필요합니다.');
$this->assertMatchesRegularExpression(
'/^\s*#\s*G7_ENV_PRIORITY=/m',
$example,
'.env.example 의 스위치는 주석 상태여야 합니다 (기본 OFF).'
);
$this->assertDoesNotMatchRegularExpression(
'/^\s*G7_ENV_PRIORITY=/m',
$example,
'.env.example 에 활성 스위치 라인을 두면 신규 설치가 즉시 잠깁니다.'
);
// `.env.testing.example` 은 저장소 추적 파일이라 반드시 존재한다 — 부재를 건너뛰면
// 그 축이 공허 통과한다. 안내 문구가 사라지면 "왜 여기엔 스위치가 없는가" 의 근거가
// 사라져, 다음 사람이 디버깅 편의로 활성 라인을 넣게 된다.
$testingExamplePath = base_path('.env.testing.example');
$this->assertFileExists($testingExamplePath, '.env.testing.example 은 저장소 추적 파일입니다.');
$this->assertStringContainsString(
'G7_ENV_PRIORITY',
(string) file_get_contents($testingExamplePath),
'.env.testing.example 에 스위치를 켜지 않는 사유 안내가 필요합니다.'
);
foreach (['.env.testing.example', '.env.testing'] as $file) {
$path = base_path($file);
if (! file_exists($path)) {
continue;
}
$this->assertDoesNotMatchRegularExpression(
'/^\s*G7_ENV_PRIORITY=/m',
(string) file_get_contents($path),
"{$file} 에 활성 스위치 라인을 두면 테스트가 개발 머신의 .env 상태에 좌우됩니다."
);
}
}
/**
* `defaults.json` 의 defaults 블록을 읽습니다.
*
* @return array<string, array<string, mixed>> 카테고리별 기본값
*/
private function loadDefaults(): array
{
$raw = (string) file_get_contents(config_path('settings/defaults.json'));
return json_decode($raw, true)['defaults'] ?? [];
}
/**
* `SettingsServiceProvider` 의 settings 카테고리 주입 지점을 소스에서 도출합니다.
*
* `getCategory('<카테고리>')` 호출부를 찾고 그것을 감싸는 메서드를 역으로 특정한다.
* 메서드 이름 목록을 손으로 들고 있으면 새 주입이 늘어도 검사가 그것을 보지 못하므로,
* 모집단은 언제나 소스에서 파생한다. audit 룰 `env-priority-filter-wiring` 과 같은 도출식이다.
*
* @return list<array{category: string, method: string, body: string}> 주입 지점 목록
*/
private function injectionSites(): array
{
$source = (string) file_get_contents(app_path('Providers/SettingsServiceProvider.php'));
preg_match_all("/getCategory\(\s*'([a-z_]+)'\s*\)/", $source, $matches, PREG_OFFSET_CAPTURE);
$sites = [];
$seen = [];
foreach ($matches[1] as $index => $capture) {
$category = $capture[0];
$offset = $matches[0][$index][1];
if (! preg_match_all('/function\s+([A-Za-z0-9_]+)\s*\(/', substr($source, 0, $offset), $heads, PREG_OFFSET_CAPTURE)) {
continue;
}
$last = array_key_last($heads[1]);
$method = $heads[1][$last][0];
$body = $this->extractMethodBody($source, $method);
$key = $method.':'.$category;
if ($body === '' || isset($seen[$key])) {
continue;
}
$seen[$key] = true;
$sites[] = ['category' => $category, 'method' => $method, 'body' => $body];
}
return $sites;
}
/**
* PHP 소스에서 주석을 제거합니다 ("하면 안 되는 것" 설명문 오탐 차단).
*
* @param string $source 원본 소스
* @return string 주석이 제거된 소스
*/
private function stripComments(string $source): string
{
return (string) preg_replace(['#/\*.*?\*/#s', '#//[^\n]*#'], '', $source);
}
/**
* 소스에서 지정 메서드의 본문을 잘라냅니다 (중괄호 균형 기준).
*
* @param string $source 원본 소스
* @param string $method 메서드명
* @return string 메서드 본문 (찾지 못하면 빈 문자열)
*/
private function extractMethodBody(string $source, string $method): string
{
$signature = 'function '.$method.'(';
$start = strpos($source, $signature);
if ($start === false) {
return '';
}
$open = strpos($source, '{', $start);
if ($open === false) {
return '';
}
$depth = 0;
$length = strlen($source);
for ($i = $open; $i < $length; $i++) {
if ($source[$i] === '{') {
$depth++;
} elseif ($source[$i] === '}') {
$depth--;
if ($depth === 0) {
return substr($source, $open, $i - $open + 1);
}
}
}
return '';
}
}
@@ -0,0 +1,394 @@
<?php
namespace Tests\Feature\Settings;
use App\Contracts\Repositories\ConfigRepositoryInterface;
use App\Enums\ExtensionOwnerType;
use App\Models\Permission;
use App\Models\Role;
use App\Models\User;
use App\Services\SettingsService;
use App\Support\EnvPriority;
use Illuminate\Foundation\Testing\RefreshDatabase;
use Illuminate\Support\Facades\Hash;
use Tests\TestCase;
/**
* `.env` 우선 모드의 설정 API 표면 (응답 메타 · 표시값 · 저장 게이트) 계약.
*
* 화면의 `disabled` 는 게이트가 아니다 — 저장 API 를 직접 호출하면 그대로 통과한다.
* 그래서 잠금은 응답 메타(표시)와 저장 필터(차단) 두 축으로 나뉘고, 둘 다 여기서 고정한다.
*
* @effects meta_env_locked_uses_frontend_keys, locked_plain_shows_effective_value, locked_sensitive_hides_effective_value, locked_key_filtered_on_save_including_advanced, switch_off_behaves_identically
*/
class SettingsEnvLockedMetaTest extends TestCase
{
use RefreshDatabase;
/**
* 스위치를 켜고 지정한 env 변수만 명시 상태로 만듭니다.
*
* `.env.testing` 을 건드리지 않고 config 를 직접 주입합니다 — 테스트가 개발 머신의
* `.env` 상태에 좌우되면 재현이 불가능해집니다.
*
* @param array<int, string> $explicitVars 명시 상태로 만들 env 변수 목록
*/
private function enableWith(array $explicitVars): void
{
config([
'env-priority.enabled' => true,
'env-priority.explicit' => array_fill_keys($explicitVars, true),
]);
}
/**
* 관리자 사용자와 API 토큰을 만듭니다.
*
* @return array{0: User, 1: string} 사용자와 토큰
*/
private function createAdminWithToken(): array
{
$user = User::factory()->create(['password' => Hash::make('password123')]);
$permissionIds = [];
foreach (['core.settings.read', 'core.settings.update'] as $identifier) {
$permissionIds[] = Permission::firstOrCreate(
['identifier' => $identifier],
[
'name' => json_encode(['ko' => $identifier, 'en' => $identifier]),
'description' => json_encode(['ko' => $identifier, 'en' => $identifier]),
'extension_type' => ExtensionOwnerType::Core,
'extension_identifier' => 'core',
'type' => 'admin',
]
)->id;
}
$adminRole = Role::firstOrCreate(
['identifier' => 'admin'],
[
'name' => json_encode(['ko' => '관리자', 'en' => 'Administrator']),
'description' => json_encode(['ko' => '시스템 관리자', 'en' => 'System Administrator']),
'extension_type' => ExtensionOwnerType::Core,
'extension_identifier' => 'core',
'is_active' => true,
]
);
$scopedRole = Role::create([
'identifier' => 'admin_env_priority_'.uniqid(),
'name' => json_encode(['ko' => '테스트 관리자', 'en' => 'Test Administrator']),
'description' => json_encode(['ko' => '테스트 관리자', 'en' => 'Test Administrator']),
'is_active' => true,
]);
$scopedRole->permissions()->sync($permissionIds);
foreach ([$adminRole->id, $scopedRole->id] as $roleId) {
$user->roles()->attach($roleId, ['assigned_at' => now(), 'assigned_by' => null]);
}
$user = $user->fresh();
return [$user, $user->createToken('env-priority-test')->plainTextToken];
}
// ------------------------------------------------------------ 응답 메타
/**
* 잠금 목록은 화면이 참조하는 프론트엔드 키 형태로 내려갑니다.
*
* 저장소 키(`debug.mode`)를 그대로 내보내면 고급 탭의 잠금 표시가 조용히 미발동합니다.
*
* @effects meta_env_locked_uses_frontend_keys
*
* @scenario switch=on, key_state=locked_plain, surface=get_meta
*/
public function test_env_locked_는_프론트엔드_키로_내려간다(): void
{
$this->enableWith(['APP_DEBUG', 'APP_NAME', 'GEOIP_LICENSE_KEY']);
$meta = app(SettingsService::class)->envLockedMeta();
$this->assertArrayHasKey('advanced.debug_mode', $meta, 'merge_into 변환(debug → advanced)이 반영되어야 합니다.');
$this->assertArrayHasKey('advanced.geoip_license_key', $meta, 'frontend_key 변환이 반영되어야 합니다.');
$this->assertArrayHasKey('general.site_name', $meta, '변환이 없는 키는 그대로 실립니다.');
// getAllSettings() 가 값을 두 위치에 싣는 것과 같은 규칙 — 원본 카테고리도 함께 담긴다.
$this->assertArrayHasKey('debug.debug_mode', $meta);
}
/**
* 스위치가 꺼져 있으면 잠금 목록이 비어 있습니다.
*
* @effects switch_off_behaves_identically
*
* @scenario switch=off, key_state=unlocked, surface=get_meta
*/
public function test_스위치가_꺼지면_잠금_목록이_비어있다(): void
{
config([
'env-priority.enabled' => false,
'env-priority.explicit' => ['APP_NAME' => true, 'APP_DEBUG' => true],
]);
$this->assertSame([], app(SettingsService::class)->envLockedMeta());
}
/**
* 잠긴 일반 키의 표시값은 저장값이 아니라 유효값(적용 중인 값)입니다.
*
* @effects locked_plain_shows_effective_value
*/
/** @scenario switch=on, key_state=locked_plain, surface=get_effective_value */
public function test_잠긴_일반_키는_유효값을_보여준다(): void
{
app(ConfigRepositoryInterface::class)->saveCategory('general', [
'site_name' => '저장된이름',
'site_description' => '설명',
]);
app(ConfigRepositoryInterface::class)->saveCategory('upload', [
'max_file_size' => 10,
]);
config(['app.name' => 'env유래이름', 'attachment.max_file_size' => 51200]);
$this->enableWith(['APP_NAME', 'ATTACHMENT_MAX_FILE_SIZE']);
$settings = app(SettingsService::class)->getAllSettings();
$this->assertSame('env유래이름', $settings['general']['site_name']);
$this->assertSame(50, $settings['upload']['max_file_size'], 'KB(config) → MB(화면) 환산이 적용되어야 합니다.');
$this->assertSame('설명', $settings['general']['site_description'], '미잠금 키는 저장값 그대로입니다.');
}
/**
* 잠긴 민감 키의 `.env` 값은 응답에 실리지 않습니다.
*
* 잠금 표시만 하고 값은 저장값 그대로 둡니다 — `.env` 비밀값의 admin UI 유출 차단.
*
* @effects locked_sensitive_hides_effective_value
*
* @scenario switch=on, key_state=locked_sensitive, surface=get_effective_value
*/
public function test_잠긴_민감_키는_유효값을_노출하지_않는다(): void
{
app(ConfigRepositoryInterface::class)->saveCategory('mail', [
'password' => '저장된비밀',
]);
config(['mail.mailers.smtp.password' => 'ENV_비밀값']);
$this->enableWith(['MAIL_PASSWORD']);
$settings = app(SettingsService::class)->getAllSettings();
$this->assertSame('저장된비밀', $settings['mail']['password']);
$this->assertNotSame('ENV_비밀값', $settings['mail']['password']);
$this->assertArrayHasKey('mail.password', app(SettingsService::class)->envLockedMeta(), '민감 키도 잠금 표시는 됩니다.');
}
// ------------------------------------------------------------ 저장 게이트
/**
* 잠긴 키를 포함한 저장 요청은 그 키만 반영되지 않습니다 (저장 자체는 성공).
*
* @effects locked_key_filtered_on_save_including_advanced
*
* @scenario switch=on, key_state=locked_plain, surface=post_filter
*/
public function test_잠긴_키는_저장에서_필터된다(): void
{
$repository = app(ConfigRepositoryInterface::class);
$repository->saveCategory('general', [
'site_name' => '원래이름',
'site_description' => '원래설명',
]);
$this->enableWith(['APP_NAME']);
$saved = app(SettingsService::class)->saveSettings([
'_tab' => 'general',
'general' => [
'site_name' => '공격자가_보낸_이름',
'site_description' => '바뀐설명',
],
]);
$this->assertTrue($saved);
$general = $repository->getCategory('general');
$this->assertSame('원래이름', $general['site_name'], '잠긴 키는 저장 상태가 불변이어야 합니다.');
$this->assertSame('바뀐설명', $general['site_description'], '미잠금 키는 종전대로 저장됩니다.');
}
/**
* 고급 탭(카테고리 분리 경로)에서도 잠긴 키가 필터됩니다.
*
* 고급 탭은 여러 카테고리가 한 폼에 섞여 오므로 분리 후에 필터하지 않으면 이 경로만
* 조용히 뚫립니다.
*
* @effects locked_key_filtered_on_save_including_advanced
*
* @scenario switch=on, key_state=locked_falsy, surface=post_filter
*/
public function test_고급탭_저장에서도_잠긴_키가_필터된다(): void
{
$repository = app(ConfigRepositoryInterface::class);
$repository->saveCategory('debug', ['mode' => false, 'sql_query_log' => false]);
$repository->saveCategory('core_update', ['github_url' => 'https://github.com/original/repo']);
$this->enableWith(['APP_DEBUG', 'G7_UPDATE_GITHUB_URL']);
$saved = app(SettingsService::class)->saveSettings([
'_tab' => 'advanced',
'advanced' => [
'debug_mode' => true,
'sql_query_log' => true,
'core_update_github_url' => 'https://github.com/attacker/repo',
],
]);
$this->assertTrue($saved);
$this->assertFalse((bool) $repository->getCategory('debug')['mode'], '잠긴 debug.mode 는 불변이어야 합니다.');
$this->assertTrue((bool) $repository->getCategory('debug')['sql_query_log'], '미잠금 키는 저장됩니다.');
$this->assertSame(
'https://github.com/original/repo',
$repository->getCategory('core_update')['github_url'],
'잠긴 core_update.github_url 은 불변이어야 합니다.'
);
}
/**
* 스위치가 꺼져 있으면 저장이 종전과 동일합니다.
*
* @effects switch_off_behaves_identically
*
* @scenario switch=off, key_state=unlocked, surface=post_filter
*/
public function test_스위치가_꺼지면_저장이_종전과_같다(): void
{
$repository = app(ConfigRepositoryInterface::class);
$repository->saveCategory('general', ['site_name' => '원래이름']);
config([
'env-priority.enabled' => false,
'env-priority.explicit' => ['APP_NAME' => true],
]);
app(SettingsService::class)->saveSettings([
'_tab' => 'general',
'general' => ['site_name' => '새이름'],
]);
$this->assertSame('새이름', $repository->getCategory('general')['site_name']);
}
// ------------------------------------------------------------ HTTP 왕복
/**
* 조회·저장 두 응답이 같은 `_meta` 모양을 갖습니다.
*
* 한쪽만 필드가 늘면 저장 직후 화면의 잠금 표시가 조용히 사라집니다.
*
* @effects meta_env_locked_uses_frontend_keys
*
* @scenario switch=on, key_state=unlocked, surface=post_filter
*/
public function test_조회와_저장_응답이_같은_meta_를_동봉한다(): void
{
[, $token] = $this->createAdminWithToken();
$this->enableWith(['APP_NAME']);
$index = $this->withToken($token)->getJson('/api/admin/settings');
$index->assertOk();
$indexMeta = $index->json('data._meta');
$this->assertIsArray($indexMeta);
$this->assertArrayHasKey('limits', $indexMeta);
$this->assertTrue($indexMeta['env_priority_enabled']);
$this->assertArrayHasKey('general.site_name', $indexMeta['env_locked']);
// general 탭은 필수 필드를 함께 보내야 한다 (화면 폼도 탭 전체를 제출한다).
$store = $this->withToken($token)->postJson('/api/admin/settings', [
'_tab' => 'general',
'general' => [
'site_name' => '테스트사이트',
'site_url' => 'https://example.test',
'admin_email' => 'admin@example.test',
'timezone' => 'Asia/Seoul',
'language' => 'ko',
'site_description' => '설명변경',
],
]);
$store->assertOk();
$storeMeta = $store->json('data.settings._meta');
$this->assertIsArray($storeMeta);
$this->assertSame(array_keys($indexMeta), array_keys($storeMeta), '조회·저장 응답의 _meta 키가 같아야 합니다.');
$this->assertArrayHasKey('general.site_name', $storeMeta['env_locked']);
}
/**
* 스위치가 꺼진 응답은 종전 형태를 유지합니다 (잠금 목록만 비어 있음).
*
* @effects switch_off_behaves_identically
*/
/** @scenario switch=off, key_state=unlocked, surface=get_effective_value */
public function test_스위치가_꺼진_응답은_잠금이_비어있다(): void
{
[, $token] = $this->createAdminWithToken();
config([
'env-priority.enabled' => false,
'env-priority.explicit' => ['APP_NAME' => true],
]);
$response = $this->withToken($token)->getJson('/api/admin/settings');
$response->assertOk();
$this->assertFalse($response->json('data._meta.env_priority_enabled'));
$this->assertSame([], $response->json('data._meta.env_locked'));
}
/**
* 매핑에 sensitive 로 표시된 키는 표시값 오버레이 대상에서 제외됩니다.
*
* 오버레이 목록과 sensitive 목록이 갈라지면 그 키만 조용히 값이 새어 나갑니다.
*
* @effects locked_sensitive_hides_effective_value
*/
/** @scenario switch=on, key_state=locked_sensitive, surface=get_effective_value */
public function test_민감_키는_오버레이_대상에서_전부_제외된다(): void
{
$sensitiveKeys = array_keys(array_filter(
EnvPriority::MAP,
fn (array $entry) => ($entry['sensitive'] ?? false) === true
));
$this->assertNotEmpty($sensitiveKeys);
$this->enableWith(EnvPriority::envVars());
$overlaySource = (string) file_get_contents(app_path('Services/SettingsService.php'));
$this->assertStringContainsString(
'EnvPriority::isSensitive($storageKey)',
$overlaySource,
'표시값 오버레이는 sensitive 키를 건너뛰어야 합니다.'
);
// 모든 키를 잠근 상태에서도 민감 키의 저장값이 유지되는지 실측한다.
app(ConfigRepositoryInterface::class)->saveCategory('core_update', [
'github_token' => '저장된토큰',
]);
config(['app.update.github_token' => 'ENV_토큰']);
$settings = app(SettingsService::class)->getAllSettings();
$this->assertSame('저장된토큰', $settings['advanced']['core_update_github_token']);
}
}
@@ -0,0 +1,141 @@
/**
* E2E: 환경설정 — `.env` 키 단위 우선 (G7_ENV_PRIORITY) (#641)
*
* 시나리오 매니페스트: tests/scenarios/settings-env-priority.yaml — 마킹은 각 테스트의
* scenario(k=v 조합)·effects 주석이 담당하며, 헤더 요약 마킹은 파서 형식이 아니다
*
* 잠금 축(스위치 ON)은 서버의 `.env` 를 바꾸고 설정 캐시를 다시 구워야 재현되므로 CI 의
* 일반 실행에서는 다루지 않는다. 그 축은 레이아웃 테스트
* (admin-settings-env-locked.test.tsx)와 Chrome MCP 실측 매트릭스가 커버한다.
* 잠금 축을 켜 둔 서버에서 돌리려면 `G7_E2E_ENV_PRIORITY=1` 을 주면 된다.
*
* 여기서 상시 지키는 것은 **회귀 가드**다 — 스위치를 켜지 않은 설치에서 화면이 종전과
* 똑같이 동작하는지(배지 0 · 배너 0 · 저장 왕복 유지).
*/
import { test, expect, issueToken, authenticatePage } from '../../fixtures/auth';
const ENV_PRIORITY_ON = process.env.G7_E2E_ENV_PRIORITY === '1';
/** 관리자 환경설정 일반 탭 진입 (설정 시드 완료까지 대기) */
async function gotoGeneralTab(page: import('@playwright/test').Page): Promise<void> {
await page.goto('/admin/settings?tab=general');
await page.waitForLoadState('domcontentloaded', { timeout: 30_000 });
await expect(page.locator('input[name="general.site_name"]').first()).toBeAttached({ timeout: 20_000 });
await expect
.poll(
() =>
page.evaluate(
() => Object.keys((window as any).G7Core?.state?.getLocal?.()?.form?.general ?? {}).length
),
{ timeout: 20_000 }
)
.toBeGreaterThan(0);
}
/** 설정 응답의 `_meta` 를 읽는다 */
async function readSettingsMeta(page: import('@playwright/test').Page): Promise<any> {
return page.evaluate(() => (window as any).G7Core?.state?.getLocal?.()?.form?._meta ?? null);
}
// @scenario switch=off, key_state=unlocked, surface=get_meta
// @effects switch_off_behaves_identically
test('@smoke #641 - 스위치가 꺼진 설치는 응답 메타에 잠금이 비어 있다', async ({ page }) => {
test.skip(ENV_PRIORITY_ON, '이 블록은 스위치가 꺼진 서버를 전제로 한다');
const token = issueToken('core.settings.read', 'core.settings.update');
await authenticatePage(page, token);
await gotoGeneralTab(page);
const meta = await readSettingsMeta(page);
expect(meta).not.toBeNull();
expect(meta.env_priority_enabled).toBe(false);
expect(Object.keys(meta.env_locked ?? {})).toHaveLength(0);
});
// @scenario switch=off, key_state=unlocked, surface=ui_lock
// @effects switch_off_behaves_identically
test('#641 - 스위치가 꺼진 설치는 배너도 잠금 배지도 렌더하지 않는다', async ({ page }) => {
test.skip(ENV_PRIORITY_ON, '이 블록은 스위치가 꺼진 서버를 전제로 한다');
const token = issueToken('core.settings.read', 'core.settings.update');
await authenticatePage(page, token);
await gotoGeneralTab(page);
await expect(page.locator('#env_priority_banner')).toHaveCount(0);
await expect(page.locator('input[name="general.site_name"]').first()).toBeEnabled();
// site_description 은 Textarea 로 렌더된다 — input 셀렉터로는 잡히지 않는다.
await expect(page.locator('textarea[name="general.site_description"]').first()).toBeEnabled();
});
// @scenario switch=off, key_state=unlocked, surface=post_filter
// @effects switch_off_behaves_identically
test('#641 - 스위치가 꺼진 설치의 저장 왕복이 종전과 같다', async ({ page }) => {
test.skip(ENV_PRIORITY_ON, '이 블록은 스위치가 꺼진 서버를 전제로 한다');
const token = issueToken('core.settings.read', 'core.settings.update');
await authenticatePage(page, token);
await gotoGeneralTab(page);
const description = page.locator('textarea[name="general.site_description"]').first();
await expect(description).toBeAttached();
const original = (await description.inputValue()) ?? '';
const probe = `env-priority-e2e-${Date.now()}`;
const save = async (value: string) => {
await description.fill(value);
const saved = page.waitForResponse(
(response) =>
response.request().method() === 'POST' &&
/\/api\/admin\/settings\/?$/.test(new URL(response.url()).pathname),
{ timeout: 20_000 }
);
await page.getByRole('button', { name: /저장|Save/ }).first().click();
return saved;
};
const response = await save(probe);
expect(response.status()).toBe(200);
const body = await response.json();
expect(body?.data?.settings?._meta?.env_priority_enabled).toBe(false);
expect(body?.data?.settings?.general?.site_description).toBe(probe);
// 원복 — 검수 후 상태를 남기지 않는다
const restore = await save(original);
expect(restore.status()).toBe(200);
});
// @scenario switch=on, key_state=locked_plain, surface=ui_lock
// @effects badge_and_disabled_rendered, meta_env_locked_uses_frontend_keys
test('#641 - 스위치가 켜진 서버는 잠긴 필드를 배지와 함께 잠근다', async ({ page }) => {
test.skip(!ENV_PRIORITY_ON, '서버 `.env` 조작이 필요한 축 — G7_E2E_ENV_PRIORITY=1 일 때만 실행');
const token = issueToken('core.settings.read', 'core.settings.update');
await authenticatePage(page, token);
await gotoGeneralTab(page);
const meta = await readSettingsMeta(page);
expect(meta.env_priority_enabled).toBe(true);
const lockedKeys = Object.keys(meta.env_locked ?? {});
expect(lockedKeys.length).toBeGreaterThan(0);
await expect(page.locator('#env_priority_banner')).toBeVisible();
for (const key of lockedKeys.filter((k) => k.startsWith('general.'))) {
const field = page.locator(`[name="${key}"]`).first();
if ((await field.count()) === 0) {
continue;
}
await expect(field).toBeDisabled();
}
});
@@ -0,0 +1,558 @@
<?php
namespace Tests\Unit\Providers;
use App\Providers\SettingsServiceProvider;
use App\Repositories\JsonConfigRepository;
use Illuminate\Support\Facades\Config;
use PHPUnit\Framework\Attributes\DataProvider;
use ReflectionMethod;
use Tests\TestCase;
/**
* `.env` 우선 모드에서의 settings → config 주입 스킵 검증.
*
* 잠긴 키는 Config::set 이 아예 발생하지 않아야 한다 — 그것이 `.env` 값이 살아남는
* 유일한 조건이다. 스위치가 꺼진 축은 종전 주입이 그대로 일어나는지도 함께 고정한다.
*
* @effects switch_off_behaves_identically, explicit_env_skips_injection, false_env_is_explicit, websocket_enabled_lock_skips_off_branch, debug_mode_lock_corrects_outbound_gate
*/
class SettingsServiceProviderEnvPriorityTest extends TestCase
{
/**
* 스위치를 켜고 지정한 env 변수만 명시 상태로 만듭니다.
*
* @param array<int, string> $explicitVars 명시 상태로 만들 env 변수 목록
*/
private function enableWith(array $explicitVars): void
{
Config::set('env-priority.enabled', true);
Config::set('env-priority.explicit', array_fill_keys($explicitVars, true));
}
/**
* 스위치를 끕니다 (현행 동작).
*/
private function disableSwitch(): void
{
Config::set('env-priority.enabled', false);
Config::set('env-priority.explicit', []);
}
/**
* 앱 환경을 production 으로 바꿉니다.
*
* `applyDebugConfig` 는 testing 환경에서 통째로 조기 return 하므로(테스트 격리 가드),
* 그 본문의 분기를 검증하려면 환경을 바꿔야 합니다. 컨테이너의 `env` 바인딩을 교체하면
* `app()->environment()` 의 해석이 바뀝니다. 앱 인스턴스는 테스트마다 새로 만들어지므로
* 이 변경은 그 테스트 안에만 머뭅니다.
*/
private function forceNonTestingEnvironment(): void
{
$this->app->instance('env', 'production');
}
/**
* Provider 의 private apply* 메서드를 리플렉션으로 호출합니다.
*
* @param string $method 메서드명 (예: applyMailConfig)
* @param string $category 카테고리명
* @param array<string, mixed> $settings 그 카테고리의 설정 데이터
*/
private function callApply(string $method, string $category, array $settings): void
{
$configRepository = $this->createMock(JsonConfigRepository::class);
$configRepository->method('getCategory')
->willReturnCallback(fn (string $requested) => $requested === $category ? $settings : []);
$provider = new SettingsServiceProvider($this->app);
(new ReflectionMethod($provider, $method))->invoke($provider, $configRepository);
}
// ---------------------------------------------------------------- general
/**
* 잠긴 general 키는 주입되지 않고 `.env` 유래 config 값이 살아남습니다.
*
* @scenario switch=on, key_state=unlocked, surface=inject
*/
public function test_locked_general_key_is_not_injected(): void
{
$this->enableWith(['APP_NAME']);
Config::set('app.name', 'env유래이름');
Config::set('app.url', 'https://env.example.com');
$this->callApply('applyAppConfig', 'general', [
'site_name' => '저장값이름',
'site_url' => 'https://saved.example.com',
]);
$this->assertSame('env유래이름', config('app.name'), '잠긴 키는 주입 스킵');
$this->assertSame('https://saved.example.com', config('app.url'), '미잠금 키는 종전대로 주입');
}
/**
* 스위치가 꺼져 있으면 general 주입이 종전과 동일합니다.
*
* @scenario switch=off, key_state=unlocked, surface=inject
*/
public function test_switch_off_injects_general_as_before(): void
{
$this->disableSwitch();
Config::set('app.name', 'env유래이름');
$this->callApply('applyAppConfig', 'general', ['site_name' => '저장값이름']);
$this->assertSame('저장값이름', config('app.name'));
}
/**
* timezone 이 잠기면 그 키가 파생시키는 config 2곳 모두 주입되지 않습니다.
*/
public function test_locked_timezone_skips_both_derived_config_keys(): void
{
$this->enableWith(['APP_DEFAULT_USER_TIMEZONE']);
Config::set('app.default_user_timezone', 'UTC');
Config::set('app.schedule_timezone', 'UTC');
$this->callApply('applyAppConfig', 'general', ['timezone' => 'Asia/Seoul']);
$this->assertSame('UTC', config('app.default_user_timezone'));
$this->assertSame('UTC', config('app.schedule_timezone'));
}
// ------------------------------------------------------------------- mail
/**
* 잠긴 mail 키만 주입에서 빠집니다.
*/
public function test_locked_mail_keys_are_not_injected(): void
{
$this->enableWith(['MAIL_PORT', 'MAIL_PASSWORD']);
Config::set('mail.mailers.smtp.port', 2599);
Config::set('mail.mailers.smtp.password', 'env비밀');
Config::set('mail.mailers.smtp.host', 'env.host');
$this->callApply('applyMailConfig', 'mail', [
'mailer' => 'smtp',
'host' => 'saved.host',
'port' => 587,
'password' => '저장비밀',
]);
$this->assertSame(2599, config('mail.mailers.smtp.port'));
$this->assertSame('env비밀', config('mail.mailers.smtp.password'));
$this->assertSame('saved.host', config('mail.mailers.smtp.host'));
}
/**
* 잠긴 mailgun_endpoint 는 기본값 강제 주입도 하지 않습니다 (F3).
*
* 이 지점은 저장값이 비어도 기본값('api.mailgun.net')을 박는 무조건 주입이었다.
* 잠금으로 키가 제거되면 그 강제까지 멈춰야 `.env` 값이 살아남는다.
*/
public function test_locked_mailgun_endpoint_skips_unconditional_default(): void
{
$this->enableWith(['MAILGUN_ENDPOINT']);
Config::set('services.mailgun.endpoint', 'api.eu.mailgun.net');
$this->callApply('applyMailConfig', 'mail', [
'mailer' => 'mailgun',
'mailgun_domain' => 'mg.example.com',
'mailgun_endpoint' => '',
]);
$this->assertSame('api.eu.mailgun.net', config('services.mailgun.endpoint'));
}
/**
* 스위치가 꺼져 있으면 mailgun_endpoint 의 기본값 강제가 종전대로 유지됩니다.
*/
public function test_switch_off_keeps_mailgun_endpoint_default_forcing(): void
{
$this->disableSwitch();
Config::set('services.mailgun.endpoint', 'api.eu.mailgun.net');
$this->callApply('applyMailConfig', 'mail', [
'mailer' => 'mailgun',
'mailgun_endpoint' => '',
]);
$this->assertSame('api.mailgun.net', config('services.mailgun.endpoint'));
}
/**
* 잠긴 ses_region 도 기본값 강제 주입을 하지 않습니다 (F3).
*/
public function test_locked_ses_region_skips_unconditional_default(): void
{
$this->enableWith(['AWS_DEFAULT_REGION']);
Config::set('services.ses.region', 'us-west-2');
$this->callApply('applyMailConfig', 'mail', [
'mailer' => 'ses',
'ses_region' => '',
]);
$this->assertSame('us-west-2', config('services.ses.region'));
}
// ------------------------------------------------------------------ debug
/**
* debug.mode 잠금 4케이스: app.debug 주입 스킵 + 로그 레벨 2차 효과 보정.
*
* @param bool $modeLocked APP_DEBUG 명시 여부
* @param bool $levelLocked LOG_LEVEL 명시 여부
* @param bool $envDebug `.env` 의 APP_DEBUG 유효값
* @param string $expectedLogLevel 기대 logging.level
*/
#[DataProvider('debugLockCases')]
public function test_debug_lock_matrix(bool $modeLocked, bool $levelLocked, bool $envDebug, string $expectedLogLevel): void
{
$explicit = [];
if ($modeLocked) {
$explicit[] = 'APP_DEBUG';
}
if ($levelLocked) {
$explicit[] = 'LOG_LEVEL';
}
$this->enableWith($explicit);
$this->forceNonTestingEnvironment();
Config::set('app.debug', $envDebug);
Config::set('logging.level', 'env레벨');
$this->callApply('applyDebugConfig', 'debug', [
'mode' => false,
'log_level' => 'warning',
]);
$this->assertSame(
$modeLocked ? $envDebug : false,
config('app.debug'),
'app.debug 는 잠기면 `.env` 유효값이 유지되어야 함'
);
$this->assertSame($expectedLogLevel, config('logging.level'));
}
/**
* debug 잠금 매트릭스 케이스.
*
* @return array<string, array{bool, bool, bool, string}>
*/
public static function debugLockCases(): array
{
return [
// mode 미잠금 · level 미잠금 → 저장값(mode=false) → 저장 log_level 적용
'both unlocked' => [false, false, true, 'warning'],
// mode 잠금(APP_DEBUG=true) · level 미잠금 → 디버그 모드 강제 규칙이 살아나 debug
'mode locked, debug on' => [true, false, true, 'debug'],
// mode 잠금(APP_DEBUG=false) · level 미잠금 → 저장 log_level 적용
'mode locked, debug off' => [true, false, false, 'warning'],
// level 잠금 → logging.* 주입 자체를 하지 않음 (`.env` LOG_LEVEL 권위)
'level locked' => [false, true, true, 'env레벨'],
'both locked' => [true, true, true, 'env레벨'],
];
}
/**
* debug.mode 가 잠기면 프록시 게이트도 `.env` 유효값으로 판정됩니다.
*
* 보정이 없으면 잠금으로 mode 키가 사라져 게이트가 항상 닫히고, 운영자가 저장한
* 프록시가 오류·로그 없이 영구 미적용된다.
*/
public function test_locked_debug_mode_corrects_outbound_proxy_gate(): void
{
$this->enableWith(['APP_DEBUG']);
$this->forceNonTestingEnvironment();
Config::set('app.debug', true);
$this->callApply('applyDebugConfig', 'debug', [
'mode' => false,
'outbound_proxy' => 'http://proxy.example.com:3128',
]);
$proxy = config('g7.outbound_proxy');
$this->assertIsArray($proxy, '디버그 모드가 `.env` 로 켜져 있으면 프록시가 적용되어야 함');
$this->assertSame('http://proxy.example.com:3128', $proxy['http']);
}
/**
* `.env` 의 APP_DEBUG 가 꺼져 있으면 잠금 상태에서도 프록시는 적용되지 않습니다.
*/
public function test_locked_debug_mode_off_keeps_proxy_gate_closed(): void
{
$this->enableWith(['APP_DEBUG']);
$this->forceNonTestingEnvironment();
Config::set('app.debug', false);
$this->callApply('applyDebugConfig', 'debug', [
'mode' => true,
'outbound_proxy' => 'http://proxy.example.com:3128',
]);
$this->assertNull(config('g7.outbound_proxy'));
}
// ---------------------------------------------------------------- drivers
/**
* redis 관련 키가 잠기면 default·cache 두 커넥션 모두 주입되지 않습니다.
*/
public function test_locked_redis_keys_skip_both_connections(): void
{
$this->enableWith(['REDIS_HOST', 'REDIS_DB']);
Config::set('database.redis.default.host', 'env-redis');
Config::set('database.redis.cache.host', 'env-redis');
Config::set('database.redis.default.database', 7);
Config::set('database.redis.cache.database', 8);
Config::set('database.redis.default.port', 6379);
$this->callApply('applyDriverConfig', 'drivers', [
'redis_host' => 'saved-redis',
'redis_port' => 6400,
'redis_database' => 3,
]);
$this->assertSame('env-redis', config('database.redis.default.host'));
$this->assertSame('env-redis', config('database.redis.cache.host'));
$this->assertSame(7, config('database.redis.default.database'));
$this->assertSame(8, config('database.redis.cache.database'));
$this->assertSame(6400, config('database.redis.default.port'), '미잠금 키는 종전대로 주입');
}
/**
* `.env` 로 잠긴 웹소켓 마스터 토글은 OFF 강제 3종을 오발동시키지 않습니다.
*
* 잠금으로 키가 제거되면 `empty()` 가 참이 되어 OFF 강제 분기로 오진입한다.
* 그러면 `.env` 로 웹소켓을 켠 운영자에게 강제 OFF 가 걸린다.
*/
public function test_locked_websocket_toggle_does_not_force_off(): void
{
$this->enableWith(['BROADCAST_CONNECTION']);
Config::set('broadcasting.default', 'reverb');
Config::set('broadcasting.connections.reverb.key', 'env-key');
Config::set('g7.websocket.client.host', 'ws.example.com');
$this->callApply('applyDriverConfig', 'drivers', [
'websocket_enabled' => false,
'websocket_app_key' => 'saved-key',
]);
$this->assertSame('reverb', config('broadcasting.default'));
$this->assertSame('env-key', config('broadcasting.connections.reverb.key'));
$this->assertSame('ws.example.com', config('g7.websocket.client.host'));
}
/**
* 스위치가 꺼져 있으면 웹소켓 OFF 강제 3종이 종전대로 동작합니다.
*/
public function test_switch_off_keeps_websocket_off_forcing(): void
{
$this->disableSwitch();
Config::set('broadcasting.default', 'reverb');
Config::set('broadcasting.connections.reverb.key', 'env-key');
Config::set('g7.websocket.client.host', 'ws.example.com');
$this->callApply('applyDriverConfig', 'drivers', [
'websocket_enabled' => false,
]);
$this->assertSame('null', config('broadcasting.default'));
$this->assertSame('', config('broadcasting.connections.reverb.key'));
$this->assertSame('', config('g7.websocket.client.host'));
}
/**
* 잠긴 log_driver 는 stack 채널 목록을 덮지 않습니다.
*/
public function test_locked_log_driver_skips_stack_channels(): void
{
$this->enableWith(['LOG_STACK']);
Config::set('logging.channels.stack.channels', ['stderr']);
$this->callApply('applyDriverConfig', 'drivers', [
'log_driver' => 'daily',
'log_days' => 30,
]);
$this->assertSame(['stderr'], config('logging.channels.stack.channels'));
$this->assertSame(30, config('logging.channels.daily.days'), '미잠금 키는 종전대로 주입');
}
// ------------------------------------------------------- upload / geoip 등
/**
* 잠긴 upload 키는 KB 환산 주입도 하지 않습니다.
*/
public function test_locked_upload_key_is_not_injected(): void
{
$this->enableWith(['ATTACHMENT_MAX_FILE_SIZE']);
Config::set('attachment.max_file_size', 51200);
Config::set('attachment.image_max_width', 1000);
$this->callApply('applyUploadConfig', 'upload', [
'max_file_size' => 10,
'image_max_width' => 2000,
]);
$this->assertSame(51200, config('attachment.max_file_size'));
$this->assertSame(2000, config('attachment.image_max_width'), '미잠금 키는 종전대로 주입');
}
/**
* 잠긴 core_update 키는 주입되지 않습니다.
*/
public function test_locked_core_update_key_is_not_injected(): void
{
$this->enableWith(['G7_UPDATE_GITHUB_URL']);
Config::set('app.update.github_url', 'https://github.com/env/repo');
$this->callApply('applyCoreUpdateConfig', 'core_update', [
'github_url' => 'https://github.com/saved/repo',
'github_token' => 'saved-token',
]);
$this->assertSame('https://github.com/env/repo', config('app.update.github_url'));
$this->assertSame('saved-token', config('app.update.github_token'));
}
/**
* 잠긴 geoip 불리언 키는 주입되지 않습니다 (falsy 명시 축).
*/
public function test_locked_geoip_boolean_key_is_not_injected(): void
{
$this->enableWith(['GEOIP_ENABLED']);
Config::set('geoip.enabled', true);
Config::set('geoip.auto_update_enabled', true);
$this->callApply('applyGeoIpConfig', 'geoip', [
'feature_enabled' => false,
'auto_update_enabled' => false,
]);
$this->assertTrue(config('geoip.enabled'), '잠긴 키는 `.env` 유효값 유지');
$this->assertFalse(config('geoip.auto_update_enabled'), '미잠금 키는 종전대로 주입');
}
// ------------------------------------------- 잠금이 게이트·폴백을 무너뜨리는 축
/**
* 마스터 메일 드라이버가 잠겨도 하위 저장값(mailgun)은 종전대로 주입됩니다.
*
* 잠금은 그 키의 주입만 건너뛰는 것이지, 그 키를 게이트로 쓰는 형제 키까지
* 무력화하는 것이 아닙니다. 게이트를 유효값으로 보정하지 않으면 `$mailer` 가 빈
* 문자열이 되어 어느 분기에도 들어가지 않고, mailgun 자격증명이 오류 없이 사라집니다.
*
* @scenario switch=on, key_state=locked_plain, surface=inject
*/
public function test_locked_mailer_still_injects_unlocked_driver_children(): void
{
$this->enableWith(['MAIL_MAILER']);
Config::set('mail.default', 'mailgun');
Config::set('services.mailgun.domain', 'env.example.com');
$this->callApply('applyMailConfig', 'mail', [
'mailer' => 'smtp',
'mailgun_domain' => 'saved.example.com',
'mailgun_secret' => 'saved-secret',
'mailgun_endpoint' => 'api.eu.mailgun.net',
]);
$this->assertSame('mailgun', config('mail.default'), '잠긴 마스터 키는 `.env` 유효값 유지');
$this->assertSame('saved.example.com', config('services.mailgun.domain'), '미잠금 하위 키는 주입');
$this->assertSame('saved-secret', config('services.mailgun.secret'));
$this->assertSame('api.eu.mailgun.net', config('services.mailgun.endpoint'));
}
/**
* 잠긴 웹소켓 server endpoint 자리에 클라이언트 값이 폴백으로 덮이지 않습니다.
*
* 클라이언트 endpoint 는 env 대응이 없는 관리자 소유 값입니다. 폴백을 그대로 두면
* 그 값이 `.env` 가 소유한 REVERB_HOST/PORT/SCHEME 자리에 실려 잠금이 무력해집니다.
*
* @scenario switch=on, key_state=locked_plain, surface=inject
*/
public function test_locked_websocket_server_endpoint_is_not_overwritten_by_client_fallback(): void
{
$this->enableWith(['REVERB_HOST', 'REVERB_PORT', 'REVERB_SCHEME']);
Config::set('broadcasting.connections.reverb.options.host', 'ws.env.example.com');
Config::set('broadcasting.connections.reverb.options.port', 8080);
Config::set('broadcasting.connections.reverb.options.scheme', 'https');
Config::set('reverb.apps.apps.0.options.host', 'ws.env.example.com');
$this->callApply('applyDriverConfig', 'drivers', [
'websocket_enabled' => true,
'websocket_host' => 'admin.example.com',
'websocket_port' => 6001,
'websocket_scheme' => 'http',
]);
$this->assertSame('ws.env.example.com', config('broadcasting.connections.reverb.options.host'));
$this->assertSame(8080, config('broadcasting.connections.reverb.options.port'));
$this->assertSame('https', config('broadcasting.connections.reverb.options.scheme'));
$this->assertSame('ws.env.example.com', config('reverb.apps.apps.0.options.host'));
$this->assertSame('admin.example.com', config('g7.websocket.client.host'), '클라이언트 endpoint 는 종전대로 주입');
}
/**
* 미잠금 상태에서는 server endpoint 폴백이 종전대로 동작합니다 (음성 대조).
*/
public function test_websocket_server_endpoint_falls_back_to_client_when_unlocked(): void
{
$this->disableSwitch();
$this->callApply('applyDriverConfig', 'drivers', [
'websocket_enabled' => true,
'websocket_host' => 'admin.example.com',
'websocket_port' => 6001,
'websocket_scheme' => 'https',
]);
$this->assertSame('admin.example.com', config('broadcasting.connections.reverb.options.host'));
$this->assertSame(6001, config('broadcasting.connections.reverb.options.port'));
$this->assertSame('https', config('broadcasting.connections.reverb.options.scheme'));
}
/**
* 잠긴 storage_driver 의 유효값이 s3 면 첨부 디스크 파생이 그대로 발동합니다.
*
* 저장값 부재를 "s3 아님" 으로 읽으면 `FILESYSTEM_DISK=s3` 를 잠근 설치에서
* 첨부 업로드만 로컬 디스크로 되돌아갑니다 (오류 없이 갈라집니다).
*
* @scenario switch=on, key_state=locked_plain, surface=inject
*/
public function test_locked_storage_driver_still_derives_attachment_disk(): void
{
$this->enableWith(['FILESYSTEM_DISK']);
Config::set('filesystems.default', 's3');
Config::set('attachment.disk_explicit', null);
Config::set('attachment.disk', 'attachments');
$this->callApply('applyDriverConfig', 'drivers', [
'storage_driver' => 'local',
]);
$this->assertSame('s3', config('filesystems.default'), '잠긴 키는 `.env` 유효값 유지');
$this->assertSame('s3', config('attachment.disk'), '유효값 기준으로 파생이 발동');
}
/**
* ATTACHMENT_DISK 가 명시된 설치에서는 파생이 발동하지 않습니다 (음성 대조).
*/
public function test_explicit_attachment_disk_still_wins_over_derivation(): void
{
$this->enableWith(['FILESYSTEM_DISK']);
Config::set('filesystems.default', 's3');
Config::set('attachment.disk_explicit', 'attachments');
Config::set('attachment.disk', 'attachments');
$this->callApply('applyDriverConfig', 'drivers', [
'storage_driver' => 'local',
]);
$this->assertSame('attachments', config('attachment.disk'));
}
}
+319
View File
@@ -0,0 +1,319 @@
<?php
namespace Tests\Unit\Support;
use App\Support\EnvPriority;
use Illuminate\Support\Facades\Config;
use Tests\TestCase;
/**
* `.env` 키 단위 우선 판정(EnvPriority) 단위 테스트.
*
* @effects switch_off_behaves_identically, explicit_env_skips_injection, empty_string_env_not_explicit, false_env_is_explicit, locked_plain_shows_effective_value, locked_sensitive_hides_effective_value
*/
class EnvPriorityTest extends TestCase
{
/**
* 스위치를 켜고 지정한 env 변수만 명시 상태로 만듭니다.
*
* @param array<int, string> $explicitVars 명시 상태로 만들 env 변수 목록
*/
private function enableWith(array $explicitVars): void
{
Config::set('env-priority.enabled', true);
Config::set('env-priority.explicit', array_fill_keys($explicitVars, true));
}
/**
* 스위치가 꺼져 있으면 어떤 키도 잠기지 않습니다 (현행 동작 보존).
*
* @scenario switch=off, key_state=unlocked, surface=inject
*/
public function test_switch_off_locks_nothing(): void
{
Config::set('env-priority.enabled', false);
Config::set('env-priority.explicit', ['APP_NAME' => true, 'MAIL_PORT' => true]);
$this->assertFalse(EnvPriority::enabled());
$this->assertFalse(EnvPriority::isLocked('general.site_name'));
$this->assertSame([], EnvPriority::lockedKeys());
$this->assertSame(
['site_name' => 'X'],
EnvPriority::filterLocked('general', ['site_name' => 'X'])
);
}
/**
* 스위치가 켜지고 env 가 명시된 키만 잠깁니다.
*
* @scenario switch=on, key_state=locked_plain, surface=get_meta
*/
public function test_explicit_env_locks_only_that_key(): void
{
$this->enableWith(['MAIL_PORT']);
$this->assertTrue(EnvPriority::isLocked('mail.port'));
$this->assertFalse(EnvPriority::isLocked('mail.host'));
$this->assertSame(['mail.port' => true], EnvPriority::lockedKeys());
}
/**
* 매핑에 없는 키는 잠기지 않습니다 (면제 목록 등재 키 포함).
*
* @scenario switch=on, key_state=unlocked, surface=get_meta
*/
public function test_unmapped_key_is_never_locked(): void
{
$this->enableWith(['MAIL_PORT']);
$this->assertFalse(EnvPriority::isLocked('mail.encryption'));
$this->assertFalse(EnvPriority::isLocked('general.site_description'));
$this->assertFalse(EnvPriority::isLocked('nonexistent.key'));
}
/**
* env 두 개가 한 설정을 나누는 키는 하나만 명시돼도 잠깁니다 (any-of).
*
* @scenario switch=on, key_state=locked_plain, surface=inject
*/
public function test_any_of_env_vars_locks_the_setting(): void
{
$this->enableWith(['REDIS_CACHE_DB']);
$this->assertTrue(EnvPriority::isLocked('drivers.redis_database'));
$this->enableWith(['REDIS_DB']);
$this->assertTrue(EnvPriority::isLocked('drivers.redis_database'));
$this->enableWith(['REDIS_HOST']);
$this->assertFalse(EnvPriority::isLocked('drivers.redis_database'));
}
/**
* filterLocked 는 잠긴 키만 제거하고 나머지는 그대로 둡니다.
*
* @scenario switch=on, key_state=unlocked, surface=inject
*/
public function test_filter_locked_removes_only_locked_keys(): void
{
$this->enableWith(['MAIL_PORT', 'MAIL_PASSWORD']);
$filtered = EnvPriority::filterLocked('mail', [
'mailer' => 'smtp',
'host' => 'smtp.example.com',
'port' => 587,
'password' => 'stored',
]);
$this->assertSame(['mailer' => 'smtp', 'host' => 'smtp.example.com'], $filtered);
}
/**
* 저장 게이트는 잠긴 키를 조용히 제거합니다 (화면 disabled 우회 경로 차단).
*
* @scenario switch=on, key_state=locked_plain, surface=post_filter
*/
public function test_reject_locked_for_save_strips_locked_keys(): void
{
$this->enableWith(['APP_NAME']);
$accepted = EnvPriority::rejectLockedForSave('general', [
'site_name' => '공격자가_보낸_값',
'site_description' => '허용',
]);
$this->assertSame(['site_description' => '허용'], $accepted);
}
/**
* 저장 게이트도 스위치가 꺼져 있으면 입력을 그대로 통과시킵니다.
*
* @scenario switch=off, key_state=unlocked, surface=post_filter
*/
public function test_reject_locked_for_save_is_noop_when_switch_off(): void
{
Config::set('env-priority.enabled', false);
Config::set('env-priority.explicit', ['APP_NAME' => true]);
$input = ['site_name' => 'X', 'site_description' => 'Y'];
$this->assertSame($input, EnvPriority::rejectLockedForSave('general', $input));
}
/**
* 민감 키 규약: password/secret/token/license 류만 sensitive 입니다.
*
* @scenario switch=on, key_state=locked_sensitive, surface=get_meta
*/
public function test_sensitive_contract(): void
{
$this->assertTrue(EnvPriority::isSensitive('mail.password'));
$this->assertTrue(EnvPriority::isSensitive('mail.ses_secret'));
$this->assertTrue(EnvPriority::isSensitive('drivers.redis_password'));
$this->assertTrue(EnvPriority::isSensitive('drivers.s3_secret_key'));
$this->assertTrue(EnvPriority::isSensitive('drivers.websocket_app_secret'));
$this->assertTrue(EnvPriority::isSensitive('core_update.github_token'));
$this->assertTrue(EnvPriority::isSensitive('geoip.license_key'));
$this->assertFalse(EnvPriority::isSensitive('mail.host'));
$this->assertFalse(EnvPriority::isSensitive('drivers.websocket_app_key'));
$this->assertFalse(EnvPriority::isSensitive('general.site_name'));
}
/**
* 매핑에 등장하는 모든 sensitive 키는 실제로 자격증명 계열 이름을 갖습니다.
*
* 반대 방향(자격증명 이름인데 sensitive 표시가 빠진 키) 검출이 목적입니다 —
* 표시가 빠지면 `.env` 의 비밀값이 관리자 화면 응답에 실려 나갑니다.
*/
/** @scenario switch=on, key_state=locked_sensitive, surface=get_meta */
public function test_credential_named_keys_are_all_marked_sensitive(): void
{
$missing = [];
foreach (EnvPriority::MAP as $key => $entry) {
$isCredentialName = (bool) preg_match('/(password|secret|token|license|_access_key|ses_key)/', $key);
if ($isCredentialName && ($entry['sensitive'] ?? false) !== true) {
$missing[] = $key;
}
}
$this->assertSame([], $missing, 'sensitive 표시가 빠진 자격증명 키: '.implode(', ', $missing));
}
/**
* 유효값은 런타임 config 값이며, 표시 변환 지시자가 있으면 화면 단위로 환산됩니다.
*/
/** @scenario switch=on, key_state=locked_plain, surface=get_effective_value */
public function test_effective_value_reads_runtime_config(): void
{
Config::set('app.name', '운영중인이름');
$this->assertSame('운영중인이름', EnvPriority::effectiveValue('general.site_name'));
}
/**
* 첨부 최대 크기는 KB(config) → MB(화면) 로 환산됩니다.
*/
/** @scenario switch=on, key_state=locked_plain, surface=get_effective_value */
public function test_effective_value_converts_kb_to_mb(): void
{
Config::set('attachment.max_file_size', 20480);
$this->assertSame(20, EnvPriority::effectiveValue('upload.max_file_size'));
}
/**
* 웹소켓 마스터 토글은 broadcasting 드라이버가 reverb 인지로 표현됩니다.
*
* @scenario switch=on, key_state=locked_falsy, surface=get_meta
*/
public function test_effective_value_maps_broadcast_driver_to_toggle(): void
{
Config::set('broadcasting.default', 'reverb');
$this->assertTrue(EnvPriority::effectiveValue('drivers.websocket_enabled'));
Config::set('broadcasting.default', 'null');
$this->assertFalse(EnvPriority::effectiveValue('drivers.websocket_enabled'));
}
/**
* 로그 드라이버는 stack 채널 목록의 첫 항목으로 표현됩니다.
*/
/** @scenario switch=on, key_state=locked_plain, surface=get_effective_value */
public function test_effective_value_takes_first_stack_channel(): void
{
Config::set('logging.channels.stack.channels', ['daily', 'stderr']);
$this->assertSame('daily', EnvPriority::effectiveValue('drivers.log_driver'));
}
/**
* 매핑에 없는 키의 유효값은 null 입니다.
*/
/** @scenario switch=on, key_state=unlocked, surface=get_effective_value */
public function test_effective_value_is_null_for_unmapped_key(): void
{
$this->assertNull(EnvPriority::effectiveValue('mail.encryption'));
}
/**
* envVars() 는 매핑의 env 변수를 중복 없이 반환합니다.
*/
public function test_env_vars_are_deduplicated(): void
{
$vars = EnvPriority::envVars();
$this->assertSame(array_values(array_unique($vars)), $vars);
// AWS_ACCESS_KEY_ID 는 mail.ses_key 와 drivers.s3_access_key 두 곳에 등장한다.
$this->assertContains('AWS_ACCESS_KEY_ID', $vars);
$this->assertContains('REDIS_CACHE_DB', $vars);
}
/**
* 명시 판별은 strict 입니다 — 빈 값·`null` 문자열·미설정만 미명시입니다.
*
* 이 규약은 `config/env-priority.php` 의 캡처식이 소유하므로, 그 파일을 실제로
* 평가해 판정합니다. `?:` 로 바꾸면 `APP_DEBUG=false`·`REDIS_DB=0` 같은 falsy
* 명시가 미명시로 오판되는데, 그 회귀를 여기서 잠급니다.
*
* @scenario switch=on, key_state=locked_falsy, surface=inject
*/
public function test_explicit_capture_is_strict_about_presence(): void
{
$cases = [
'MAILGUN_ENDPOINT' => ['value' => 'api.example.com', 'explicit' => true],
'GEOIP_LICENSE_KEY' => ['value' => '', 'explicit' => false],
'GEOIP_AUTO_UPDATE_ENABLED' => ['value' => 'false', 'explicit' => true],
'LOG_DAILY_DAYS' => ['value' => '0', 'explicit' => true],
'AWS_BUCKET' => ['value' => 'null', 'explicit' => false],
];
$originalEnv = [];
$originalServer = [];
foreach ($cases as $var => $case) {
$originalEnv[$var] = $_ENV[$var] ?? null;
$originalServer[$var] = $_SERVER[$var] ?? null;
$_ENV[$var] = $case['value'];
$_SERVER[$var] = $case['value'];
}
// REVERB_APP_ID 는 어떤 케이스에도 없다 — 미설정 축의 대조군.
$unsetVar = 'REVERB_APP_ID';
$originalEnv[$unsetVar] = $_ENV[$unsetVar] ?? null;
$originalServer[$unsetVar] = $_SERVER[$unsetVar] ?? null;
unset($_ENV[$unsetVar], $_SERVER[$unsetVar]);
try {
$captured = require config_path('env-priority.php');
$explicit = $captured['explicit'];
foreach ($cases as $var => $case) {
$this->assertSame(
$case['explicit'],
($explicit[$var] ?? false) === true,
"{$var}={$case['value']} 의 명시 판정이 규약과 다릅니다"
);
}
$this->assertFalse(($explicit[$unsetVar] ?? false) === true, '미설정 env 는 미명시여야 합니다');
} finally {
foreach ($originalEnv as $var => $value) {
if ($value === null) {
unset($_ENV[$var]);
} else {
$_ENV[$var] = $value;
}
}
foreach ($originalServer as $var => $value) {
if ($value === null) {
unset($_SERVER[$var]);
} else {
$_SERVER[$var] = $value;
}
}
}
}
}
@@ -0,0 +1,55 @@
feature: .env 키 단위 우선 (G7_ENV_PRIORITY 옵트인)
description: |
관리자 환경설정(storage/app/settings/*.json)이 `.env` 유래 config 를 덮는 기존 설계를
키 단위로 되돌리는 옵트인 스위치. `.env` 에 값이 명시된 항목만 settings 주입에서 빠지고,
관리자 화면은 그 필드를 편집 불가 + 잠금 배지로 표시하며, 저장 API 는 서버측에서 필터한다.
핵심 동작:
- 명시 판별은 config 빌드 시점 캡처(config/env-priority.php) — env() 런타임 호출은
config:cache 환경에서 null 로 고정되어 판별이 영구 미발동한다
- 판별은 strict: `KEY=`(빈 값)·`KEY=null`·미설정만 미명시. `APP_DEBUG=false`·`REDIS_DB=0`
같은 falsy 명시는 명시로 취급
- env 두 개가 한 설정을 나누는 키(redis_database)는 any-of 로 판정
- 스위치 OFF 면 전 경로 조기 return — 현행 동작 100% 동일
- 잠긴 키의 화면 표시값은 유효값(런타임 config). 단 민감 키는 값을 싣지 않는다
- 웹소켓 마스터 토글 잠금 시 OFF 강제 3종 오진입 금지 (`.env` 권위)
- 디버그 모드 잠금 시 2차 효과(로그 레벨 강제·프록시 게이트)를 유효값으로 보정
axes:
switch: [off, on]
key_state: [unlocked, locked_plain, locked_sensitive, locked_falsy]
surface: [inject, get_meta, get_effective_value, post_filter, ui_lock]
exclusions:
- { switch: off, key_state: locked_plain, reason: "스위치 OFF 는 잠금 판정 자체를 하지 않는다 — 전 key_state 가 unlocked 와 동일 경로" }
- { switch: off, key_state: locked_sensitive, reason: "동일" }
- { switch: off, key_state: locked_falsy, reason: "동일" }
- { key_state: locked_sensitive, surface: inject, reason: "민감 여부는 표시 경로에서만 갈린다 — 주입 스킵은 locked_plain 과 같은 코드 경로" }
- { key_state: locked_sensitive, surface: post_filter, reason: "동일 — 저장 필터는 민감 여부를 보지 않는다" }
- { key_state: locked_sensitive, surface: ui_lock, reason: "동일 — 화면 잠금 표시는 민감 여부와 무관" }
- { key_state: locked_falsy, surface: get_effective_value, reason: "falsy 명시는 판별 축이라 표시값 경로에서는 locked_plain 과 같다 — 유효값 오버레이는 민감 여부만 본다" }
- { key_state: locked_falsy, surface: ui_lock, reason: "falsy 명시는 판별 축이라 화면 표시에서는 locked_plain 과 구분되지 않는다" }
effects:
- switch_off_behaves_identically
- explicit_env_skips_injection
- empty_string_env_not_explicit
- false_env_is_explicit
- map_parity_covers_every_injected_default_key
- env_examples_document_env_priority_switch
- websocket_enabled_lock_skips_off_branch
- debug_mode_lock_corrects_outbound_gate
- locked_key_filtered_on_save_including_advanced
- locked_plain_shows_effective_value
- locked_sensitive_hides_effective_value
- meta_env_locked_uses_frontend_keys
- badge_and_disabled_rendered
test_files:
- tests/Unit/Support/EnvPriorityTest.php
- tests/Unit/Providers/SettingsServiceProviderEnvPriorityTest.php
- tests/Feature/Settings/EnvPriorityContractTest.php
- tests/Feature/Settings/SettingsEnvLockedMetaTest.php
- templates/_bundled/sirsoft-admin_basic/__tests__/layouts/admin-settings-env-locked.test.tsx
- tests/Playwright/specs/admin/settings-env-priority.spec.ts