Gnuboard7/tests/Unit/Extension/ExtensionSettingsDirectoryOwnershipTest.php

<?php

namespace Tests\Unit\Extension;

use App\Extension\Helpers\ExtensionPendingHelper;
use App\Extension\ModuleManager;
use App\Extension\PluginManager;
use App\Extension\TemplateManager;
use Illuminate\Support\Facades\File;
use PHPUnit\Framework\Attributes\Test;
use Tests\TestCase;

/**
 * 확장 설정 시드·업데이트 임시 폴더의 소유권 상속 회귀 테스트 (#651 B2·B4).
 *
 * sudo 코어 업데이트(번들 확장 업데이트 프롬프트)가 root 로 `storage/app/{modules,plugins}/{id}/settings/`
 * 를 만들면 그 서브트리는 restore_ownership 의도적 제외 경로라 코어 업데이트로도 되돌려지지 않고,
 * 이후 웹 프로세스의 설정 저장이 영구 실패한다. 임시 폴더의 부모 `storage/app/temp` 도 최초 생성자가
 * root 면 같은 결말이다(자식만 삭제된다). 소유권 축은 Windows 에서 실측할 수 없으므로 저장소 관례
 * (소스 훑기)로 상속 호출의 존재를 잠근다.
 */
class ExtensionSettingsDirectoryOwnershipTest extends TestCase
{
    /**
     * 클래스 소스에서 주석을 제거한 본문을 돌려줍니다.
     */
    private function strippedSource(string $class): string
    {
        $path = (new \ReflectionClass($class))->getFileName();
        $stripped = '';

        foreach (token_get_all((string) file_get_contents($path)) as $token) {
            if (is_array($token) && in_array($token[0], [T_COMMENT, T_DOC_COMMENT], true)) {
                continue;
            }
            $stripped .= is_array($token) ? $token[1] : $token;
        }

        return $stripped;
    }

    /**
     * `makeDirectory($settingsDir …)` 뒤 5줄 안에 상속 호출이 있는지 판정합니다.
     */
    private function assertMakeDirectoryInheritsOwnership(string $class): void
    {
        $source = $this->strippedSource($class);
        $offset = 0;
        $found = 0;

        while (($pos = strpos($source, 'File::makeDirectory($settingsDir', $offset)) !== false) {
            $window = substr($source, $pos, 400);
            $lines = array_slice(explode("\n", $window), 0, 6);

            $this->assertStringContainsString(
                'FilePermissionHelper::inheritOwnershipFromParent($settingsDir)',
                implode("\n", $lines),
                $class.': settings 디렉토리 생성 뒤 부모 소유권 상속이 없다 — sudo 코어 업데이트 뒤 그 확장의 설정 저장이 영구 실패한다'
            );

            $found++;
            $offset = $pos + 1;
        }

        $this->assertGreaterThan(0, $found, $class.': settings 디렉토리 생성 지점을 찾지 못했다');
    }

    /**
     * @effects settings_directory_seed_inherits_ownership
     */
    #[Test]
    public function 모듈_설정_시드_디렉토리와_파일은_부모_소유권을_상속한다(): void
    {
        $this->assertMakeDirectoryInheritsOwnership(ModuleManager::class);

        $source = $this->strippedSource(ModuleManager::class);
        $this->assertStringContainsString(
            "File::put(\$filePath, \$jsonContent);\n            FilePermissionHelper::inheritOwnershipFromParent(\$filePath);",
            $source,
            'ModuleManager: 설정 시드 파일 쓰기 뒤 부모 소유권 상속이 없다'
        );
    }

    /**
     * @effects settings_directory_seed_inherits_ownership
     */
    #[Test]
    public function 플러그인_설정_시드_디렉토리와_파일은_부모_소유권을_상속한다(): void
    {
        $this->assertMakeDirectoryInheritsOwnership(PluginManager::class);

        $source = $this->strippedSource(PluginManager::class);
        $this->assertStringContainsString(
            "File::put(\$settingsPath, \$content);\n        FilePermissionHelper::inheritOwnershipFromParent(\$settingsPath);",
            $source,
            'PluginManager: 설정 시드 파일 쓰기 뒤 부모 소유권 상속이 없다'
        );
    }

    /**
     * 세 매니저의 업데이트 임시 폴더 확보가 공유 헬퍼를 경유한다 — 복사본은 갈라진다.
     *
     * @effects update_temp_directory_inherits_ownership
     */
    #[Test]
    public function 업데이트_임시_폴더는_공유_헬퍼로_확보한다(): void
    {
        foreach ([ModuleManager::class, PluginManager::class, TemplateManager::class] as $class) {
            $source = $this->strippedSource($class);

            $this->assertStringContainsString(
                'ExtensionPendingHelper::ensureUpdateTempDirectory($tempDir)',
                $source,
                $class.': 업데이트 임시 폴더를 공유 헬퍼로 확보하지 않는다'
            );
            $this->assertStringNotContainsString(
                "File::ensureDirectoryExists(\$tempDir);\n",
                $source,
                $class.': 임시 폴더를 직접 생성하는 옛 경로가 남아 있다 — 부모 storage/app/temp 가 root 로 굳는다'
            );
        }
    }

    /**
     * 공유 헬퍼는 부모를 먼저 확보하고 자식에 소유권을 상속시킨다 (동작).
     *
     * @effects update_temp_directory_inherits_ownership
     */
    #[Test]
    public function 공유_헬퍼는_부모와_자식을_함께_확보한다(): void
    {
        $parent = storage_path('framework/testing/temp-parent-'.uniqid());
        $child = $parent.'/module_update_'.uniqid();

        try {
            ExtensionPendingHelper::ensureUpdateTempDirectory($child);

            $this->assertDirectoryExists($parent);
            $this->assertDirectoryExists($child);
            $this->assertTrue(is_writable($child));
        } finally {
            File::deleteDirectory($parent);
        }
    }
}