HeuJung
057e002ad1
StorageInterface::url 의 public 하드코딩을 완화하고 core.storage.filter_url 훅을 신설해, 완전 공개 자산(상품·카테고리·리뷰·에디터 이미지)의 직접 URL 서빙을 옵트인으로 열었다. 미설정 시 기존 스트리밍 100% 보존. 디스크 결정은 확장 개별 설정 > 코어 전역 > 미설정 순이며, 서빙·삭제·이동은 행에 기록된 disk 를 따라 전환 전후 자산이 혼재해도 각자 실제 저장 위치를 향한다. 고아 disk(공급 플러그인 비활성화)는 스트리밍으로 폴백해 500 이 되지 않는다. 공개 이슈 (@lyg-kaban 건의) 대응.
303 lines
10 KiB
PHP
303 lines
10 KiB
PHP
<?php
|
|
|
|
namespace Tests\Feature\Api\Admin;
|
|
|
|
use App\Enums\ExtensionOwnerType;
|
|
use App\Models\Permission;
|
|
use App\Models\Role;
|
|
use App\Models\User;
|
|
use App\Providers\SettingsServiceProvider;
|
|
use App\Repositories\JsonConfigRepository;
|
|
use Illuminate\Foundation\Testing\RefreshDatabase;
|
|
use Illuminate\Support\Facades\Hash;
|
|
use PHPUnit\Framework\Attributes\Test;
|
|
use Tests\TestCase;
|
|
|
|
/**
|
|
* Settings API에서 available_drivers 필드 포함 검증
|
|
*
|
|
* DriverRegistryService를 통해 코어 + 플러그인 드라이버 목록이
|
|
* settings API 응답에 포함되는지 검증합니다.
|
|
*/
|
|
class SettingsControllerDriverOptionsTest extends TestCase
|
|
{
|
|
use RefreshDatabase;
|
|
|
|
private User $admin;
|
|
|
|
private string $token;
|
|
|
|
protected function setUp(): void
|
|
{
|
|
parent::setUp();
|
|
|
|
$this->admin = $this->createAdminUser();
|
|
$this->token = $this->admin->createToken('test-token')->plainTextToken;
|
|
}
|
|
|
|
/**
|
|
* 관리자 사용자 생성
|
|
*/
|
|
private function createAdminUser(): User
|
|
{
|
|
$user = User::factory()->create([
|
|
'password' => Hash::make('password123'),
|
|
]);
|
|
|
|
$permissionIds = [];
|
|
foreach (['core.settings.read', 'core.settings.update'] as $permIdentifier) {
|
|
$permission = Permission::firstOrCreate(
|
|
['identifier' => $permIdentifier],
|
|
[
|
|
'name' => json_encode(['ko' => $permIdentifier, 'en' => $permIdentifier]),
|
|
'description' => json_encode(['ko' => $permIdentifier, 'en' => $permIdentifier]),
|
|
'extension_type' => ExtensionOwnerType::Core,
|
|
'extension_identifier' => 'core',
|
|
'type' => 'admin',
|
|
]
|
|
);
|
|
$permissionIds[] = $permission->id;
|
|
}
|
|
|
|
$roleIdentifier = 'admin_test_'.uniqid();
|
|
$adminRole = Role::create([
|
|
'identifier' => $roleIdentifier,
|
|
'name' => json_encode(['ko' => '테스트 관리자', 'en' => 'Test Admin']),
|
|
'description' => json_encode(['ko' => '테스트', 'en' => 'Test']),
|
|
'is_active' => true,
|
|
]);
|
|
|
|
$adminBaseRole = 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,
|
|
]
|
|
);
|
|
|
|
$adminRole->permissions()->sync($permissionIds);
|
|
|
|
$user->roles()->attach($adminBaseRole->id, [
|
|
'assigned_at' => now(),
|
|
'assigned_by' => null,
|
|
]);
|
|
$user->roles()->attach($adminRole->id, [
|
|
'assigned_at' => now(),
|
|
'assigned_by' => null,
|
|
]);
|
|
|
|
return $user->fresh();
|
|
}
|
|
|
|
/**
|
|
* 인증된 요청 헬퍼 메서드
|
|
*/
|
|
private function authRequest(): static
|
|
{
|
|
return $this->withHeaders([
|
|
'Authorization' => 'Bearer '.$this->token,
|
|
'Accept' => 'application/json',
|
|
]);
|
|
}
|
|
|
|
/**
|
|
* settings index 응답에 available_drivers가 포함되는지 검증합니다.
|
|
*/
|
|
#[Test]
|
|
public function index_response_includes_available_drivers(): void
|
|
{
|
|
$response = $this->authRequest()->getJson('/api/admin/settings');
|
|
|
|
$response->assertStatus(200)
|
|
->assertJsonStructure([
|
|
'data' => [
|
|
'available_drivers' => [
|
|
'storage',
|
|
'public_asset',
|
|
'cache',
|
|
'session',
|
|
'queue',
|
|
'log',
|
|
'websocket',
|
|
'mail',
|
|
],
|
|
],
|
|
]);
|
|
}
|
|
|
|
/**
|
|
* available_drivers의 각 드라이버에 id와 label 필드가 있는지 검증합니다.
|
|
*/
|
|
#[Test]
|
|
public function available_drivers_have_correct_structure(): void
|
|
{
|
|
$response = $this->authRequest()->getJson('/api/admin/settings');
|
|
|
|
$response->assertStatus(200);
|
|
|
|
$data = $response->json('data.available_drivers');
|
|
|
|
// 8개 카테고리 존재
|
|
$this->assertCount(8, $data);
|
|
|
|
// 각 카테고리에 최소 1개 이상의 드라이버 존재
|
|
foreach ($data as $category => $drivers) {
|
|
$this->assertNotEmpty($drivers, "{$category} 카테고리에 드라이버가 없습니다.");
|
|
|
|
// 첫 번째 드라이버 구조 검증
|
|
$this->assertArrayHasKey('id', $drivers[0]);
|
|
$this->assertArrayHasKey('label', $drivers[0]);
|
|
$this->assertArrayHasKey('ko', $drivers[0]['label']);
|
|
$this->assertArrayHasKey('en', $drivers[0]['label']);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* storage 카테고리에 코어 드라이버가 포함되는지 검증합니다.
|
|
*/
|
|
#[Test]
|
|
public function storage_drivers_include_core_options(): void
|
|
{
|
|
$response = $this->authRequest()->getJson('/api/admin/settings');
|
|
|
|
$storageDrivers = $response->json('data.available_drivers.storage');
|
|
$ids = array_column($storageDrivers, 'id');
|
|
|
|
$this->assertContains('local', $ids);
|
|
$this->assertContains('s3', $ids);
|
|
}
|
|
|
|
/**
|
|
* mail 카테고리에 코어 드라이버가 포함되는지 검증합니다.
|
|
*/
|
|
#[Test]
|
|
public function mail_drivers_include_core_options(): void
|
|
{
|
|
$response = $this->authRequest()->getJson('/api/admin/settings');
|
|
|
|
$mailDrivers = $response->json('data.available_drivers.mail');
|
|
$ids = array_column($mailDrivers, 'id');
|
|
|
|
$this->assertContains('smtp', $ids);
|
|
$this->assertContains('mailgun', $ids);
|
|
$this->assertContains('ses', $ids);
|
|
}
|
|
|
|
/**
|
|
* public_asset 카테고리에 코어 3종(none/public/s3)이 포함되는지 검증합니다.
|
|
*
|
|
* @effects settings_catalog_includes_plugin_registered_disks
|
|
*/
|
|
#[Test]
|
|
public function public_asset_drivers_include_core_options(): void
|
|
{
|
|
$response = $this->authRequest()->getJson('/api/admin/settings');
|
|
|
|
$drivers = $response->json('data.available_drivers.public_asset');
|
|
$ids = array_column($drivers, 'id');
|
|
|
|
$this->assertSame(['none', 'public', 's3'], $ids);
|
|
}
|
|
|
|
/**
|
|
* 카탈로그에 있는 공개 자산 디스크 저장이 성공하는지 검증합니다.
|
|
*/
|
|
#[Test]
|
|
public function saving_valid_public_asset_disk_succeeds(): void
|
|
{
|
|
$response = $this->authRequest()->postJson('/api/admin/settings', [
|
|
'_tab' => 'drivers',
|
|
'drivers' => $this->driversPayload(['public_asset_disk' => 'public']),
|
|
]);
|
|
|
|
$response->assertStatus(200);
|
|
|
|
$saved = (new JsonConfigRepository)->getCategory('drivers');
|
|
$this->assertSame('public', $saved['public_asset_disk'] ?? null);
|
|
}
|
|
|
|
/**
|
|
* 저장 → drivers.json → core.storage.public_asset_disk 주입 사슬을
|
|
* 한 테스트 안에서 종단으로 검증합니다.
|
|
*
|
|
* 주입 자동 실행은 testing 격리 가드(applyPublicAssetDiskConfig)가 막고 있으므로
|
|
* (dev 공유 drivers.json 유입 차단), 가드를 통과한 뒤의 주입부만 실제 저장소로
|
|
* 호출해 사슬을 잇습니다. mock 저장소를 쓰는 단위 테스트와 달리 이 테스트는
|
|
* 저장 산출물(drivers.json)이 주입 입력이 되는 것까지 고정합니다.
|
|
*
|
|
* @effects global_setting_injects_core_config_with_none_normalized
|
|
*/
|
|
#[Test]
|
|
public function saved_public_asset_disk_reaches_core_config_through_injection(): void
|
|
{
|
|
config(['core.storage.public_asset_disk' => 'stale_value']);
|
|
|
|
$this->authRequest()->postJson('/api/admin/settings', [
|
|
'_tab' => 'drivers',
|
|
'drivers' => $this->driversPayload(['public_asset_disk' => 'public']),
|
|
])->assertStatus(200);
|
|
|
|
$this->injectFromStoredSettings();
|
|
|
|
$this->assertSame('public', config('core.storage.public_asset_disk'));
|
|
|
|
// 'none' 저장은 미설정('')으로 정규화되어 스트리밍으로 되돌아간다
|
|
$this->authRequest()->postJson('/api/admin/settings', [
|
|
'_tab' => 'drivers',
|
|
'drivers' => $this->driversPayload(['public_asset_disk' => 'none']),
|
|
])->assertStatus(200);
|
|
|
|
$this->injectFromStoredSettings();
|
|
|
|
$this->assertSame('', config('core.storage.public_asset_disk'));
|
|
}
|
|
|
|
/**
|
|
* 실제 저장 산출물(drivers.json)을 읽어 주입부를 호출합니다.
|
|
*/
|
|
private function injectFromStoredSettings(): void
|
|
{
|
|
$provider = new SettingsServiceProvider($this->app);
|
|
$method = new \ReflectionMethod($provider, 'injectPublicAssetDiskConfig');
|
|
$method->invoke($provider, new JsonConfigRepository);
|
|
}
|
|
|
|
/**
|
|
* 카탈로그에 없는 공개 자산 디스크 저장이 422 로 거부되는지 검증합니다.
|
|
*
|
|
* @effects invalid_disk_rejected_with_422
|
|
*/
|
|
#[Test]
|
|
public function saving_unknown_public_asset_disk_fails_with_422(): void
|
|
{
|
|
$response = $this->authRequest()->postJson('/api/admin/settings', [
|
|
'_tab' => 'drivers',
|
|
'drivers' => $this->driversPayload(['public_asset_disk' => 'nonexistent_disk']),
|
|
]);
|
|
|
|
$response->assertStatus(422)
|
|
->assertJsonValidationErrors(['drivers.public_asset_disk']);
|
|
}
|
|
|
|
/**
|
|
* drivers 탭 저장에 필요한 최소 필수 필드 payload 를 반환합니다.
|
|
*
|
|
* @param array<string, mixed> $overrides 덮어쓸 필드
|
|
* @return array<string, mixed> drivers payload
|
|
*/
|
|
private function driversPayload(array $overrides = []): array
|
|
{
|
|
return array_merge([
|
|
'storage_driver' => 'local',
|
|
'cache_driver' => 'file',
|
|
'session_driver' => 'file',
|
|
'queue_driver' => 'sync',
|
|
'log_driver' => 'daily',
|
|
'log_level' => 'error',
|
|
], $overrides);
|
|
}
|
|
}
|