HeuJung
057e002ad1
StorageInterface::url 의 public 하드코딩을 완화하고 core.storage.filter_url 훅을 신설해, 완전 공개 자산(상품·카테고리·리뷰·에디터 이미지)의 직접 URL 서빙을 옵트인으로 열었다. 미설정 시 기존 스트리밍 100% 보존. 디스크 결정은 확장 개별 설정 > 코어 전역 > 미설정 순이며, 서빙·삭제·이동은 행에 기록된 disk 를 따라 전환 전후 자산이 혼재해도 각자 실제 저장 위치를 향한다. 고아 disk(공급 플러그인 비활성화)는 스트리밍으로 폴백해 500 이 되지 않는다. 공개 이슈 (@lyg-kaban 건의) 대응.
306 lines
9.4 KiB
PHP
306 lines
9.4 KiB
PHP
<?php
|
|
|
|
namespace Tests\Unit\Extension\Storage;
|
|
|
|
use App\Extension\HookManager;
|
|
use App\Extension\Storage\PluginStorageDriver;
|
|
use Illuminate\Foundation\Testing\RefreshDatabase;
|
|
use Illuminate\Support\Facades\Config;
|
|
use Illuminate\Support\Facades\Storage;
|
|
use PHPUnit\Framework\Attributes\Test;
|
|
use Symfony\Component\HttpFoundation\StreamedResponse;
|
|
use Tests\TestCase;
|
|
|
|
/**
|
|
* PluginStorageDriver 단위 테스트
|
|
*/
|
|
class PluginStorageDriverTest extends TestCase
|
|
{
|
|
use RefreshDatabase;
|
|
|
|
private PluginStorageDriver $driver;
|
|
|
|
protected function setUp(): void
|
|
{
|
|
parent::setUp();
|
|
|
|
// 테스트용 스토리지 드라이버 생성
|
|
$this->driver = new PluginStorageDriver('test-plugin', 'plugins');
|
|
|
|
// 테스트 디렉토리 초기화
|
|
Storage::disk('plugins')->deleteDirectory('test-plugin');
|
|
}
|
|
|
|
protected function tearDown(): void
|
|
{
|
|
// 테스트 데이터 정리
|
|
Storage::disk('plugins')->deleteDirectory('test-plugin');
|
|
HookManager::resetAll();
|
|
|
|
parent::tearDown();
|
|
}
|
|
|
|
#[Test]
|
|
public function it_can_put_and_get_file(): void
|
|
{
|
|
// Given: 파일 내용
|
|
$content = 'test content';
|
|
|
|
// When: 파일 저장
|
|
$result = $this->driver->put('settings', 'config.json', $content);
|
|
|
|
// Then: 저장 성공
|
|
$this->assertTrue($result);
|
|
|
|
// And: 파일 읽기 성공
|
|
$retrieved = $this->driver->get('settings', 'config.json');
|
|
$this->assertEquals($content, $retrieved);
|
|
}
|
|
|
|
#[Test]
|
|
public function it_returns_null_for_non_existent_file(): void
|
|
{
|
|
// When: 존재하지 않는 파일 읽기
|
|
$result = $this->driver->get('settings', 'non-existent.json');
|
|
|
|
// Then: null 반환
|
|
$this->assertNull($result);
|
|
}
|
|
|
|
#[Test]
|
|
public function it_can_check_file_existence(): void
|
|
{
|
|
// Given: 파일 저장
|
|
$this->driver->put('settings', 'config.json', 'test');
|
|
|
|
// When & Then: 파일 존재 확인
|
|
$this->assertTrue($this->driver->exists('settings', 'config.json'));
|
|
$this->assertFalse($this->driver->exists('settings', 'non-existent.json'));
|
|
}
|
|
|
|
#[Test]
|
|
public function it_can_delete_file(): void
|
|
{
|
|
// Given: 파일 저장
|
|
$this->driver->put('settings', 'config.json', 'test');
|
|
|
|
// When: 파일 삭제
|
|
$result = $this->driver->delete('settings', 'config.json');
|
|
|
|
// Then: 삭제 성공
|
|
$this->assertTrue($result);
|
|
$this->assertFalse($this->driver->exists('settings', 'config.json'));
|
|
}
|
|
|
|
#[Test]
|
|
public function it_can_list_files_in_category(): void
|
|
{
|
|
// Given: 여러 파일 저장
|
|
$this->driver->put('data', 'file1.txt', 'content1');
|
|
$this->driver->put('data', 'file2.txt', 'content2');
|
|
$this->driver->put('data', 'subdir/file3.txt', 'content3');
|
|
|
|
// When: 파일 목록 조회
|
|
$files = $this->driver->files('data');
|
|
|
|
// Then: 파일 목록 확인 (재귀적으로 모든 파일 포함)
|
|
$this->assertIsArray($files);
|
|
$this->assertNotEmpty($files);
|
|
}
|
|
|
|
#[Test]
|
|
public function it_can_delete_directory(): void
|
|
{
|
|
// Given: 디렉토리와 파일 생성
|
|
$this->driver->put('temp', 'dir1/file1.txt', 'content1');
|
|
$this->driver->put('temp', 'dir1/file2.txt', 'content2');
|
|
|
|
// When: 디렉토리 삭제
|
|
$result = $this->driver->deleteDirectory('temp', 'dir1');
|
|
|
|
// Then: 삭제 성공
|
|
$this->assertTrue($result);
|
|
$this->assertFalse($this->driver->exists('temp', 'dir1/file1.txt'));
|
|
}
|
|
|
|
#[Test]
|
|
public function it_can_delete_all_files_in_category(): void
|
|
{
|
|
// Given: 여러 파일 저장
|
|
$this->driver->put('temp', 'file1.txt', 'content1');
|
|
$this->driver->put('temp', 'file2.txt', 'content2');
|
|
$this->driver->put('temp', 'subdir/file3.txt', 'content3');
|
|
|
|
// When: 카테고리 전체 삭제
|
|
$result = $this->driver->deleteAll('temp');
|
|
|
|
// Then: 삭제 성공
|
|
$this->assertTrue($result);
|
|
$this->assertFalse($this->driver->exists('temp', 'file1.txt'));
|
|
$this->assertFalse($this->driver->exists('temp', 'file2.txt'));
|
|
$this->assertFalse($this->driver->exists('temp', 'subdir/file3.txt'));
|
|
}
|
|
|
|
#[Test]
|
|
public function it_returns_correct_base_path(): void
|
|
{
|
|
// When: 기본 경로 조회
|
|
$basePath = $this->driver->getBasePath('settings');
|
|
|
|
// Then: 올바른 경로 반환
|
|
$expectedPath = Storage::disk('plugins')->path('test-plugin/settings');
|
|
$this->assertEquals($expectedPath, $basePath);
|
|
}
|
|
|
|
#[Test]
|
|
public function it_returns_correct_disk_name(): void
|
|
{
|
|
// When: 디스크 이름 조회
|
|
$disk = $this->driver->getDisk();
|
|
|
|
// Then: 'plugins' 반환
|
|
$this->assertEquals('plugins', $disk);
|
|
}
|
|
|
|
#[Test]
|
|
public function it_returns_null_for_url_on_private_disk(): void
|
|
{
|
|
// Given: local disk (private)
|
|
$this->driver->put('data', 'test.json', 'json content');
|
|
|
|
// When: URL 조회
|
|
$url = $this->driver->url('data', 'test.json');
|
|
|
|
// Then: null 반환 (private disk)
|
|
$this->assertNull($url);
|
|
}
|
|
|
|
#[Test]
|
|
public function it_returns_url_for_public_disk(): void
|
|
{
|
|
// Given: public disk 사용
|
|
$publicDriver = new PluginStorageDriver('test-plugin', 'public');
|
|
$publicDriver->put('data', 'test.json', 'json content');
|
|
|
|
// When: URL 조회
|
|
$url = $publicDriver->url('data', 'test.json');
|
|
|
|
// Then: URL 반환
|
|
$this->assertNotNull($url);
|
|
$this->assertStringContainsString('test-plugin/data/test.json', $url);
|
|
|
|
// Cleanup
|
|
Storage::disk('public')->deleteDirectory('test-plugin');
|
|
}
|
|
|
|
/**
|
|
* url 이 설정된 디스크(S3+CDN 등)면 플러그인 드라이버도 직접 URL 을 돌려준다.
|
|
*
|
|
* @effects url_returned_for_public_and_url_configured_disk
|
|
*/
|
|
#[Test]
|
|
public function it_returns_direct_url_for_url_configured_disk(): void
|
|
{
|
|
Config::set('filesystems.disks.fake_cdn', [
|
|
'driver' => 'local',
|
|
'root' => storage_path('framework/testing/disks/fake_cdn'),
|
|
'url' => 'https://cdn.test/assets',
|
|
]);
|
|
|
|
$cdnDriver = new PluginStorageDriver('test-plugin', 'fake_cdn');
|
|
|
|
$this->assertSame(
|
|
'https://cdn.test/assets/test-plugin/images/test.jpg',
|
|
$cdnDriver->url('images', 'test.jpg')
|
|
);
|
|
}
|
|
|
|
/**
|
|
* url 값이 빈 문자열/공백이면 직접 URL 로 보지 않는다 (AWS_URL 미설정 방어).
|
|
*
|
|
* @effects blank_url_config_defended
|
|
*/
|
|
#[Test]
|
|
public function it_returns_null_when_disk_url_is_blank(): void
|
|
{
|
|
Config::set('filesystems.disks.fake_cdn', [
|
|
'driver' => 'local',
|
|
'root' => storage_path('framework/testing/disks/fake_cdn'),
|
|
'url' => ' ',
|
|
]);
|
|
|
|
$this->assertNull((new PluginStorageDriver('test-plugin', 'fake_cdn'))->url('images', 'test.jpg'));
|
|
}
|
|
|
|
/**
|
|
* 플러그인 드라이버의 `core.storage.filter_url` 컨텍스트는 scope=plugin +
|
|
* 확장 식별자를 싣는다 (코어/모듈과 구분되는 축).
|
|
*
|
|
* @effects filter_url_hook_always_fires_with_six_context_keys
|
|
*/
|
|
#[Test]
|
|
public function it_passes_plugin_scope_and_identifier_to_url_filter_hook(): void
|
|
{
|
|
$captured = null;
|
|
|
|
HookManager::addFilter('core.storage.filter_url', function ($url, $context) use (&$captured) {
|
|
$captured = $context;
|
|
|
|
return $url;
|
|
});
|
|
|
|
(new PluginStorageDriver('test-plugin', 'plugins'))->url('images', 'sub/a.jpg');
|
|
|
|
$this->assertSame([
|
|
'scope' => 'plugin',
|
|
'identifier' => 'test-plugin',
|
|
'disk' => 'plugins',
|
|
'category' => 'images',
|
|
'path' => 'sub/a.jpg',
|
|
'full_path' => 'test-plugin/images/sub/a.jpg',
|
|
], $captured);
|
|
}
|
|
|
|
#[Test]
|
|
public function it_uses_correct_path_pattern(): void
|
|
{
|
|
// Given: 파일 저장
|
|
$this->driver->put('data', 'analytics/2024/01/report.json', 'content');
|
|
|
|
// When: 파일 존재 확인
|
|
$exists = $this->driver->exists('data', 'analytics/2024/01/report.json');
|
|
|
|
// Then: 올바른 경로로 저장됨
|
|
$this->assertTrue($exists);
|
|
|
|
// And: Storage Facade로도 확인 가능
|
|
$storagePath = 'test-plugin/data/analytics/2024/01/report.json';
|
|
$this->assertTrue(Storage::disk('plugins')->exists($storagePath));
|
|
}
|
|
|
|
#[Test]
|
|
public function it_returns_streamed_response_for_existing_file(): void
|
|
{
|
|
// Given: 파일 저장
|
|
$this->driver->put('data', 'report.pdf', 'pdf content');
|
|
|
|
// When: StreamedResponse 생성
|
|
$response = $this->driver->response('data', 'report.pdf', 'download.pdf', [
|
|
'Content-Type' => 'application/pdf',
|
|
]);
|
|
|
|
// Then: StreamedResponse 반환
|
|
$this->assertInstanceOf(StreamedResponse::class, $response);
|
|
}
|
|
|
|
#[Test]
|
|
public function it_returns_null_for_response_on_non_existent_file(): void
|
|
{
|
|
// When: 존재하지 않는 파일로 StreamedResponse 생성 시도
|
|
$response = $this->driver->response('data', 'non-existent.pdf', 'download.pdf');
|
|
|
|
// Then: null 반환
|
|
$this->assertNull($response);
|
|
}
|
|
}
|