fix(core,admin_basic): S3 스토리지 드라이버 실동작 결함 수정 및 S3 호환 스토리지 연결 지원

공개 제보 — 파일 스토리지에서 S3 를 선택해 저장해도 실제 파일 저장이
동작하지 않던 결함의 전면 수정.

- S3 어댑터(league/flysystem-aws-s3-v3)·predis 를 코어 기본 의존성으로 포함
 — 어댑터 부재 즉사, phpredis 확장 없는 서버의 redis 선택 전면 다운 차단
 (부트 시 확장 부재 감지 → predis 자동 폴백)
- storage_driver=s3 저장 시 코어 첨부 업로드 디스크를 s3 로 전환
 (ATTACHMENT_DISK env 명시가 항상 우선, 기존 행은 저장 당시 disk 로 서빙)
- 첨부·템플릿 레이아웃 첨부 서빙을 행 disk 를 따르는 스토리지 스트림으로 교체
 — 로컬 절대 경로 전제 fileResponse 는 S3 행에서 filemtime stat 500
 (streamedFileResponse: 행 메타 기반 ETag/304/Cache-Control)
- S3 호환 스토리지(R2/MinIO/NCP) 연결 지원: 엔드포인트 URL·path-style 설정
 신설, 리전 목록 선택 → 자유 입력 전환, 연결 테스트를 실제 저장 경로와
 동일 설정(endpoint/path-style)으로 정렬
- 사용 불능 드라이버(어댑터·PHP 확장 부재)의 저장/테스트 요청을 사유와 함께
 422 로 차단하는 서버 게이트 신설 (DriverRegistryService 능력 판정)
- 웹소켓 연결 테스트에 서버(백엔드 발송용) endpoint 검사 추가 — 클라이언트만
 검사해 테스트 성공 + 실제 발송 실패가 가능하던 비대칭 해소
- env 빈 값(`KEY=`) 함정 정규화: AWS_URL/AWS_ENDPOINT/ATTACHMENT_DISK 빈 문자열을
 미설정으로 취급 (config 정규화 + 예시 파일 주석 처리)
- 플러그인 드라이버 폴백의 log 카테고리 죽은 키(logging.default) 정정 및
 websocket 유령 설정 키 제거
- 실 AWS S3 종단 검증 완료 (설정 저장 → 업로드 S3 실저장 → 서빙 200/304)
This commit is contained in:
HeuJung committed 2026-08-13 15:15:19 +09:00
1 parent c128a6ea3a
commit ea58c606a2
56 files changed
+2899 -243

No files matched your search

+8 -2
View File
@@ -1006,11 +1006,16 @@ return [
'storage_driver_required' => '스토리지 드라이버를 선택해주세요.',
'storage_driver_invalid' => '올바른 스토리지 드라이버를 선택해주세요.',
's3_bucket_max' => 'S3 버킷 이름은 255자를 초과할 수 없습니다.',
's3_region_invalid' => '올바른 S3 리전을 선택해주세요.',
's3_region_invalid' => 'S3 리전은 소문자 영숫자와 하이픈만 사용할 수 있습니다. (예: ap-northeast-2, Cloudflare R2 는 auto)',
's3_region_max' => 'S3 리전은 64자를 초과할 수 없습니다.',
's3_access_key_max' => 'S3 Access Key는 255자를 초과할 수 없습니다.',
's3_secret_key_max' => 'S3 Secret Key는 255자를 초과할 수 없습니다.',
's3_url_invalid' => '올바른 S3 URL 형식이 아닙니다.',
's3_url_max' => 'S3 URL은 500자를 초과할 수 없습니다.',
's3_endpoint_invalid' => '올바른 S3 엔드포인트 URL 형식이 아닙니다.',
's3_endpoint_max' => 'S3 엔드포인트 URL은 500자를 초과할 수 없습니다.',
's3_use_path_style_boolean' => 'Path-style 주소 사용 설정은 true 또는 false 값이어야 합니다.',
'driver_unusable' => "':driver' 드라이버를 이 서버에서 사용할 수 없습니다. :reason",
'cache_driver_required' => '캐시 드라이버를 선택해주세요.',
'cache_driver_invalid' => '올바른 캐시 드라이버를 선택해주세요.',
'redis_host_max' => 'Redis 호스트는 255자를 초과할 수 없습니다.',
@@ -1063,7 +1068,6 @@ return [
// 드라이버 조건부 필수 메시지 (선택 드라이버에 따라 필수)
's3_bucket_required' => 'S3 버킷 이름은 필수입니다.',
's3_region_required' => 'S3 리전을 선택해주세요.',
's3_access_key_required' => 'S3 Access Key는 필수입니다.',
's3_secret_key_required' => 'S3 Secret Key는 필수입니다.',
's3_url_url' => 'S3 URL은 유효한 URL이어야 합니다.',
@@ -1196,6 +1200,8 @@ return [
's3_access_key' => 'S3 Access Key',
's3_secret_key' => 'S3 Secret Key',
's3_url' => 'S3 URL',
's3_endpoint' => 'S3 엔드포인트 URL',
's3_use_path_style' => 'Path-style 주소 사용',
'cache_driver' => '캐시 드라이버',
'redis_host' => 'Redis 호스트',
'redis_port' => 'Redis 포트',