Files
Gnuboard7/tests/Unit/Services/DriverRegistryServiceTest.php
T
2026-04-20 20:37:49 +09:00

250 lines
8.8 KiB
PHP

<?php
namespace Tests\Unit\Services;
use App\Extension\HookManager;
use App\Services\DriverRegistryService;
use PHPUnit\Framework\Attributes\Test;
use Tests\TestCase;
/**
* DriverRegistryService 단위 테스트
*
* 코어 드라이버 레지스트리의 핵심 기능을 검증합니다:
* - 코어 드라이버 반환
* - 필터 훅 통합
* - 코어 드라이버 판별
* - 사용 가능 여부 확인
* - 기본 폴백 드라이버
*/
class DriverRegistryServiceTest extends TestCase
{
private DriverRegistryService $service;
protected function setUp(): void
{
parent::setUp();
$this->service = new DriverRegistryService();
}
protected function tearDown(): void
{
// 테스트에서 등록한 필터 훅 정리
HookManager::resetAll();
parent::tearDown();
}
/**
* 코어 드라이버가 7개 카테고리를 모두 포함하는지 검증합니다.
*/
#[Test]
public function it_returns_all_seven_categories(): void
{
$categories = $this->service->getCategories();
$this->assertCount(7, $categories);
$this->assertEquals(
['storage', 'cache', 'session', 'queue', 'log', 'websocket', 'mail'],
$categories
);
}
/**
* 각 카테고리별 코어 드라이버가 올바르게 반환되는지 검증합니다.
*/
#[Test]
public function it_returns_core_drivers_for_each_category(): void
{
$storageDrivers = $this->service->getAvailableDrivers('storage');
$driverIds = array_column($storageDrivers, 'id');
$this->assertContains('local', $driverIds);
$this->assertContains('s3', $driverIds);
}
/**
* 메일 카테고리 코어 드라이버를 검증합니다.
*/
#[Test]
public function it_returns_mail_core_drivers(): void
{
$mailDrivers = $this->service->getAvailableDrivers('mail');
$driverIds = array_column($mailDrivers, 'id');
$this->assertContains('smtp', $driverIds);
$this->assertContains('mailgun', $driverIds);
$this->assertContains('ses', $driverIds);
}
/**
* 모든 카테고리의 드라이버를 한 번에 반환하는지 검증합니다.
*/
#[Test]
public function it_returns_all_available_drivers_at_once(): void
{
$all = $this->service->getAllAvailableDrivers();
$this->assertArrayHasKey('storage', $all);
$this->assertArrayHasKey('cache', $all);
$this->assertArrayHasKey('session', $all);
$this->assertArrayHasKey('queue', $all);
$this->assertArrayHasKey('log', $all);
$this->assertArrayHasKey('websocket', $all);
$this->assertArrayHasKey('mail', $all);
$this->assertCount(7, $all);
}
/**
* 코어 드라이버 판별이 올바르게 동작하는지 검증합니다.
*/
#[Test]
public function it_identifies_core_drivers_correctly(): void
{
$this->assertTrue($this->service->isCoreDriver('storage', 'local'));
$this->assertTrue($this->service->isCoreDriver('storage', 's3'));
$this->assertTrue($this->service->isCoreDriver('mail', 'smtp'));
$this->assertFalse($this->service->isCoreDriver('storage', 'custom_storage'));
$this->assertFalse($this->service->isCoreDriver('mail', 'custom_api'));
$this->assertFalse($this->service->isCoreDriver('nonexistent', 'local'));
}
/**
* 코어 드라이버의 사용 가능 여부가 true로 반환되는지 검증합니다.
*/
#[Test]
public function it_reports_core_drivers_as_available(): void
{
$this->assertTrue($this->service->isDriverAvailable('cache', 'file'));
$this->assertTrue($this->service->isDriverAvailable('cache', 'redis'));
$this->assertTrue($this->service->isDriverAvailable('session', 'database'));
}
/**
* 등록되지 않은 드라이버가 사용 불가로 판별되는지 검증합니다.
*/
#[Test]
public function it_reports_unregistered_drivers_as_unavailable(): void
{
$this->assertFalse($this->service->isDriverAvailable('cache', 'custom_cache'));
$this->assertFalse($this->service->isDriverAvailable('mail', 'custom_api'));
}
/**
* 카테고리별 기본 폴백 드라이버가 올바르게 반환되는지 검증합니다.
*/
#[Test]
public function it_returns_correct_default_drivers(): void
{
$this->assertEquals('local', $this->service->getDefaultDriver('storage'));
$this->assertEquals('file', $this->service->getDefaultDriver('cache'));
$this->assertEquals('database', $this->service->getDefaultDriver('session'));
$this->assertEquals('database', $this->service->getDefaultDriver('queue'));
$this->assertEquals('daily', $this->service->getDefaultDriver('log'));
$this->assertEquals('', $this->service->getDefaultDriver('websocket'));
$this->assertEquals('smtp', $this->service->getDefaultDriver('mail'));
}
/**
* 존재하지 않는 카테고리의 기본 드라이버가 빈 문자열인지 검증합니다.
*/
#[Test]
public function it_returns_empty_string_for_unknown_category_default(): void
{
$this->assertEquals('', $this->service->getDefaultDriver('nonexistent'));
}
/**
* 필터 훅으로 플러그인 드라이버가 추가되는지 검증합니다.
*/
#[Test]
public function it_includes_plugin_drivers_via_filter_hook(): void
{
// 플러그인이 메일 드라이버를 추가하는 필터 훅 등록
HookManager::addFilter('core.settings.available_mail_drivers', function (array $drivers) {
$drivers[] = [
'id' => 'custom_api',
'label' => ['ko' => '커스텀 API', 'en' => 'Custom API'],
'provider' => 'sirsoft-custom_mail',
];
return $drivers;
});
$mailDrivers = $this->service->getAvailableDrivers('mail');
$driverIds = array_column($mailDrivers, 'id');
// 코어 드라이버 + 플러그인 드라이버
$this->assertContains('smtp', $driverIds);
$this->assertContains('mailgun', $driverIds);
$this->assertContains('ses', $driverIds);
$this->assertContains('custom_api', $driverIds);
}
/**
* 필터 훅으로 추가된 플러그인 드라이버가 사용 가능으로 판별되는지 검증합니다.
*/
#[Test]
public function it_reports_plugin_drivers_as_available_after_hook_registration(): void
{
$this->assertFalse($this->service->isDriverAvailable('cache', 'custom_cache'));
HookManager::addFilter('core.settings.available_cache_drivers', function (array $drivers) {
$drivers[] = [
'id' => 'custom_cache',
'label' => ['ko' => '커스텀 캐시', 'en' => 'Custom Cache'],
'provider' => 'sirsoft-custom_cache',
];
return $drivers;
});
$this->assertTrue($this->service->isDriverAvailable('cache', 'custom_cache'));
}
/**
* 드라이버 데이터에 다국어 label이 포함되는지 검증합니다.
*/
#[Test]
public function it_includes_localized_labels_in_driver_data(): void
{
$storageDrivers = $this->service->getAvailableDrivers('storage');
foreach ($storageDrivers as $driver) {
$this->assertArrayHasKey('id', $driver);
$this->assertArrayHasKey('label', $driver);
$this->assertArrayHasKey('ko', $driver['label']);
$this->assertArrayHasKey('en', $driver['label']);
}
}
/**
* 카테고리별 설정 키 정보가 올바르게 반환되는지 검증합니다.
*/
#[Test]
public function it_returns_settings_key_for_each_category(): void
{
$storageKey = $this->service->getSettingsKey('storage');
$this->assertEquals(['category' => 'drivers', 'key' => 'storage_driver'], $storageKey);
$mailKey = $this->service->getSettingsKey('mail');
$this->assertEquals(['category' => 'mail', 'key' => 'mailer'], $mailKey);
$this->assertNull($this->service->getSettingsKey('nonexistent'));
}
/**
* 카테고리별 Laravel Config 키가 올바르게 반환되는지 검증합니다.
*/
#[Test]
public function it_returns_config_key_for_each_category(): void
{
$this->assertEquals('filesystems.default', $this->service->getConfigKey('storage'));
$this->assertEquals('cache.default', $this->service->getConfigKey('cache'));
$this->assertEquals('session.driver', $this->service->getConfigKey('session'));
$this->assertEquals('queue.default', $this->service->getConfigKey('queue'));
$this->assertEquals('mail.default', $this->service->getConfigKey('mail'));
$this->assertNull($this->service->getConfigKey('nonexistent'));
}
}