v7.0.0 release

2026-07-01 10:30:32 +09:00
1 parent 0e7fa04b03
commit c4ea9a6cd1
@@ -0,0 +1,134 @@
+<?php
+
+namespace Tests\Unit\Extension;
+
+use App\Extension\Testing\ExtensionTestAllowlist;
+use Tests\TestCase;
+
+/**
+ * ExtensionTestAllowlist 단위 테스트
+ *
+ * 테스트 환경 확장 격리 allowlist 컨테이너의 set/reset/isAllowed/isActive 동작을 검증합니다.
+ */
+class ExtensionTestAllowlistTest extends TestCase
+{
+    /**
+     * 각 테스트 후 allowlist 를 깨끗한 상태로 되돌립니다.
+     *
+     * (TestCase::tearDown 이 이미 reset 하지만, 본 테스트는 set 동작을
+     *  직접 검증하므로 명시적으로 한 번 더 보장합니다.)
+     */
+    protected function tearDown(): void
+    {
+        ExtensionTestAllowlist::reset();
+
+        parent::tearDown();
+    }
+
+    /**
+     * @effects set_classifies_plugin_and_module_by_path_prefix
+     */
+    public function test_set_classifies_plugin_and_module_by_path_prefix(): void
+    {
+        ExtensionTestAllowlist::set([
+            'plugins/sirsoft-gdpr',
+            'modules/sirsoft-ecommerce',
+        ]);
+
+        $this->assertTrue(ExtensionTestAllowlist::isAllowed('plugin', 'sirsoft-gdpr'));
+        $this->assertTrue(ExtensionTestAllowlist::isAllowed('module', 'sirsoft-ecommerce'));
+    }
+
+    public function test_is_allowed_returns_false_for_extension_outside_allowlist(): void
+    {
+        ExtensionTestAllowlist::set(['plugins/sirsoft-gdpr']);
+
+        $this->assertFalse(ExtensionTestAllowlist::isAllowed('plugin', 'sirsoft-marketing'));
+        $this->assertFalse(ExtensionTestAllowlist::isAllowed('module', 'sirsoft-gdpr'));
+        $this->assertFalse(ExtensionTestAllowlist::isAllowed('unknown', 'sirsoft-gdpr'));
+    }
+
+    /**
+     * @effects set_normalizes_trailing_slash
+     */
+    public function test_set_normalizes_trailing_slash(): void
+    {
+        ExtensionTestAllowlist::set(['plugins/sirsoft-gdpr/']);
+
+        $this->assertTrue(ExtensionTestAllowlist::isAllowed('plugin', 'sirsoft-gdpr'));
+    }
+
+    /**
+     * @effects set_ignores_prefixless_entries
+     */
+    public function test_set_ignores_prefixless_entries(): void
+    {
+        ExtensionTestAllowlist::set(['sirsoft-gdpr', 'templates/sirsoft-basic']);
+
+        $this->assertFalse(ExtensionTestAllowlist::isAllowed('plugin', 'sirsoft-gdpr'));
+        $this->assertFalse(ExtensionTestAllowlist::isAllowed('module', 'sirsoft-gdpr'));
+    }
+
+    /**
+     * @effects allowlist_active_when_testing_and_configured
+     */
+    public function test_is_active_returns_true_when_testing_env_and_configured(): void
+    {
+        ExtensionTestAllowlist::set([]);
+
+        // phpunit.xml 의 APP_ENV=testing + 명시적 set → 가드 활성
+        $this->assertTrue(ExtensionTestAllowlist::isActive());
+    }
+
+    /**
+     * @effects empty_allowlist_is_active_and_blocks_all_extensions
+     */
+    public function test_empty_allowlist_is_active_and_blocks_all_extensions(): void
+    {
+        // 빈 allowlist = core-only 테스트 → 가드는 활성, 모든 확장이 차단됨
+        ExtensionTestAllowlist::set([]);
+
+        $this->assertTrue(ExtensionTestAllowlist::isActive());
+        $this->assertFalse(ExtensionTestAllowlist::isAllowed('plugin', 'sirsoft-gdpr'));
+    }
+
+    /**
+     * @effects reset_deactivates_guard
+     */
+    public function test_reset_deactivates_guard(): void
+    {
+        ExtensionTestAllowlist::set(['plugins/sirsoft-gdpr']);
+        ExtensionTestAllowlist::reset();
+
+        $this->assertFalse(ExtensionTestAllowlist::isActive());
+        $this->assertFalse(ExtensionTestAllowlist::isAllowed('plugin', 'sirsoft-gdpr'));
+    }
+
+    /**
+     * @effects set_recall_replaces_previous_allowlist
+     */
+    public function test_set_recall_replaces_previous_allowlist(): void
+    {
+        ExtensionTestAllowlist::set(['plugins/sirsoft-gdpr']);
+        ExtensionTestAllowlist::set(['plugins/sirsoft-marketing']);
+
+        $this->assertFalse(ExtensionTestAllowlist::isAllowed('plugin', 'sirsoft-gdpr'));
+        $this->assertTrue(ExtensionTestAllowlist::isAllowed('plugin', 'sirsoft-marketing'));
+    }
+
+    /**
+     * @effects allowlist_inactive_when_app_env_not_testing, production_env_keeps_full_extension_loading
+     */
+    public function test_is_active_returns_false_in_non_testing_env_even_when_configured(): void
+    {
+        ExtensionTestAllowlist::set(['plugins/sirsoft-gdpr']);
+
+        // 운영/개발 환경에서는 가드가 비활성 → 확장 전수 로딩 보존
+        $this->app['env'] = 'production';
+
+        $this->assertFalse(ExtensionTestAllowlist::isActive());
+
+        // 후속 테스트 보호: 환경 복원
+        $this->app['env'] = 'testing';
+    }
+}