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

@@ -9,6 +9,7 @@ use Illuminate\Http\JsonResponse;
use Illuminate\Http\Response;
use Illuminate\Support\Facades\Auth;
use Symfony\Component\HttpFoundation\BinaryFileResponse;
use Symfony\Component\HttpFoundation\StreamedResponse;
/**
* API 컨트롤러의 최상위 베이스 클래스
@@ -174,6 +175,40 @@ abstract class BaseApiController extends Controller
return $response;
}
/**
* 스토리지 스트림 응답에 ETag/캐싱 헤더를 부착합니다 (fileResponse 의 디스크 인지 대응).
*
* fileResponse() 는 로컬 절대 경로 전제(filemtime/filesize)라 S3 등 원격 디스크
* 행에는 쓸 수 없습니다. 원격/로컬 공통 서빙은 StorageInterface::response() 가
* 만든 스트림에 본 메서드로 동일한 캐싱 계약(ETag/304/Cache-Control/Expires)을
* 입힙니다. ETag 는 파일 stat 대신 호출자가 준 결정적 소스(행 메타)로 만듭니다.
*
* @param StreamedResponse $response 스토리지 인라인 스트림 응답
* @param string $etagSource ETag 소스 문자열 (디스크·경로·수정시각·크기 등 행 메타)
* @param int $maxAge 캐시 유지 시간 (초)
* @return StreamedResponse|Response 스트림 응답 또는 304
*/
protected function streamedFileResponse(StreamedResponse $response, string $etagSource, int $maxAge): StreamedResponse|Response
{
$etag = md5($etagSource);
// If-None-Match 헤더 확인 (ETag 비교)
if (request()->header('If-None-Match') === $etag) {
return response('', 304)->header('ETag', $etag);
}
// 환경별 캐싱 정책 (fileResponse 와 동일)
$cacheControl = app()->environment('production')
? "public, max-age={$maxAge}, immutable"
: 'no-cache';
$response->headers->set('ETag', $etag);
$response->headers->set('Expires', gmdate('D, d M Y H:i:s', time() + $maxAge).' GMT');
$response->headers->set('Cache-Control', $cacheControl);
return $response;
}
/**
* JSON 응답을 반환합니다 (캐싱 헤더 포함).
*
@@ -3,10 +3,10 @@
namespace App\Http\Controllers\Api\Public;
use App\Http\Controllers\Api\Base\PublicBaseController;
use App\Http\Requests\Public\Attachment\DownloadAttachmentRequest;
use App\Services\AttachmentService;
use Illuminate\Auth\Access\AuthorizationException;
use Illuminate\Http\JsonResponse;
use Illuminate\Http\Request;
use Illuminate\Http\Response;
use Symfony\Component\HttpFoundation\BinaryFileResponse;
use Symfony\Component\HttpFoundation\StreamedResponse;
@@ -22,7 +22,7 @@ class PublicAttachmentController extends PublicBaseController
/**
* PublicAttachmentController 생성자
*
* @param AttachmentService $attachmentService 첨부파일 서비스
* @param AttachmentService $attachmentService 첨부파일 서비스
*/
public function __construct(
private AttachmentService $attachmentService
@@ -36,11 +36,11 @@ class PublicAttachmentController extends PublicBaseController
* 이미지 파일은 캐싱 헤더와 함께 인라인 표시하고,
* 그 외 파일은 다운로드 방식으로 제공합니다.
*
* @param Request $request HTTP 요청
* @param string $hash 첨부파일 해시 (12자)
* @param DownloadAttachmentRequest $request 다운로드 요청
* @param string $hash 첨부파일 해시 (12자)
* @return BinaryFileResponse|StreamedResponse|Response|JsonResponse 파일 응답 또는 에러 응답
*/
public function download(Request $request, string $hash): BinaryFileResponse|StreamedResponse|Response|JsonResponse
public function download(DownloadAttachmentRequest $request, string $hash): BinaryFileResponse|StreamedResponse|Response|JsonResponse
{
$user = $request->user();
@@ -48,10 +48,10 @@ class PublicAttachmentController extends PublicBaseController
// 파일 정보 조회 (권한 체크 포함)
$fileInfo = $this->attachmentService->getFileInfo($hash, $user);
if (!$fileInfo) {
if (! $fileInfo) {
$attachment = $this->attachmentService->findByHash($hash);
if (!$attachment) {
if (! $attachment) {
return $this->notFound('attachment.not_found');
}
@@ -59,10 +59,11 @@ class PublicAttachmentController extends PublicBaseController
}
// 이미지 파일은 캐싱 헤더와 함께 응답 (환경설정 레이아웃 캐시 TTL 사용, 기본 24시간)
// 행 disk 를 따르는 스토리지 스트림 — 로컬 경로 전제 fileResponse 는 S3 행에서 성립하지 않는다 (#99)
if (str_starts_with($fileInfo['mime_type'], 'image/')) {
return $this->fileResponse(
$fileInfo['path'],
$fileInfo['mime_type'],
return $this->streamedFileResponse(
$fileInfo['response'],
$fileInfo['etag_source'],
(int) g7_core_settings('cache.layout_ttl', 86400)
);
}
@@ -70,7 +71,7 @@ class PublicAttachmentController extends PublicBaseController
// 이미지가 아닌 파일은 기존 다운로드 방식 유지
$response = $this->attachmentService->download($hash, $user);
if (!$response) {
if (! $response) {
return $this->forbidden('attachment.access_denied');
}
@@ -15,6 +15,7 @@ use Illuminate\Http\JsonResponse;
use Illuminate\Http\Response;
use Illuminate\Support\Facades\Log;
use Symfony\Component\HttpFoundation\BinaryFileResponse;
use Symfony\Component\HttpFoundation\StreamedResponse;
/**
* 공개 템플릿 API 컨트롤러
@@ -340,21 +341,22 @@ class PublicTemplateController extends PublicBaseController
*
* @param string $identifier 템플릿 식별자
* @param TemplateLayoutAttachment $attachment 라우트 모델 바인딩된 첨부
* @return BinaryFileResponse|Response|JsonResponse 파일 응답 또는 404
* @return StreamedResponse|Response|JsonResponse 파일 응답 또는 404
*/
public function serveFile(string $identifier, TemplateLayoutAttachment $attachment): BinaryFileResponse|Response|JsonResponse
public function serveFile(string $identifier, TemplateLayoutAttachment $attachment): StreamedResponse|Response|JsonResponse
{
$filePath = $this->layoutAttachmentService->getServableFilePath($identifier, $attachment);
$serveInfo = $this->layoutAttachmentService->getServableResponse($identifier, $attachment);
if ($filePath === null) {
if ($serveInfo === null) {
return $this->notFound('templates.layout_attachments.errors.not_found');
}
// 이미지/일반 파일 모두 캐싱 헤더와 함께 인라인 응답 (레이아웃 캐시 TTL, 기본 24시간).
// PublicAttachmentController 의 이미지 서빙과 동일한 fileResponse(ETag/Cache-Control) 사용.
return $this->fileResponse(
$filePath,
$attachment->mime_type,
// PublicAttachmentController 의 이미지 서빙과 동일한 streamedFileResponse(ETag/Cache-Control) 사용
// — 행 disk 를 따르는 스토리지 스트림이라 S3 등 원격 디스크 행에서도 성립한다 (#99).
return $this->streamedFileResponse(
$serveInfo['response'],
$serveInfo['etag_source'],
(int) g7_core_settings('cache.layout_ttl', 86400)
);
}
@@ -0,0 +1,34 @@
<?php
namespace App\Http\Requests\Public\Attachment;
use Illuminate\Foundation\Http\FormRequest;
class DownloadAttachmentRequest extends FormRequest
{
/**
* 사용자가 이 요청을 수행할 권한이 있는지 확인
*
* 공개 다운로드 라우트 — 접근 제어는 AttachmentService 의 권한 훅
* (core.attachment.download)이 하이브리드로 수행합니다.
*
* @return bool 항상 true (권한은 서비스 훅 책임)
*/
public function authorize(): bool
{
return true;
}
/**
* 요청에 적용할 검증 규칙
*
* 해시는 라우트 제약(`[a-zA-Z0-9]{12}`)이 이미 형식을 강제하고,
* 그 외 입력 필드가 없는 요청입니다.
*
* @return array<string, mixed> 검증 규칙 배열
*/
public function rules(): array
{
return [];
}
}
@@ -5,6 +5,7 @@ namespace App\Http\Requests\Settings;
use App\Extension\HookManager;
use App\Models\Attachment;
use App\Search\Engines\DatabaseFulltextEngine;
use App\Services\DriverRegistryService;
use App\Support\AllowedExtensions;
use App\Support\AssetUrl;
use Illuminate\Contracts\Validation\ValidationRule;
@@ -30,9 +31,9 @@ class SaveSettingsRequest extends FormRequest
private const SUPPORTED_STORAGE_DRIVERS = ['local', 's3'];
/**
* 지원되는 S3 리전 목록
* S3 리전 형식 (AWS 리전 코드 + S3 호환 스토리지 임의값 허용 — R2 의 `auto` 등)
*/
private const SUPPORTED_S3_REGIONS = ['ap-northeast-2', 'ap-northeast-1', 'us-east-1', 'us-west-2', 'eu-west-1'];
private const S3_REGION_FORMAT = 'regex:/^[a-z0-9-]+$/';
/**
* 지원되는 캐시 드라이버 목록
@@ -54,11 +55,6 @@ class SaveSettingsRequest extends FormRequest
*/
private const SUPPORTED_WEBSOCKET_SCHEMES = ['http', 'https'];
/**
* 지원되는 검색엔진 드라이버 기본 목록
*/
private const DEFAULT_SEARCH_ENGINE_DRIVERS = ['mysql-fulltext'];
/**
* 지원되는 로그 드라이버 목록
*/
@@ -313,22 +309,24 @@ class SaveSettingsRequest extends FormRequest
'advanced.pagination_max_page' => ['nullable', 'integer', 'min:'.config('core.settings_limits.advanced_pagination_max_page_min', 0), 'max:'.config('core.settings_limits.advanced_pagination_max_page_max', 100000)],
// 드라이버 설정 (drivers 탭)
'drivers.storage_driver' => $this->getTabRules($tab, 'drivers', [Rule::in(self::SUPPORTED_STORAGE_DRIVERS)]),
'drivers.storage_driver' => $this->getTabRules($tab, 'drivers', [Rule::in(self::SUPPORTED_STORAGE_DRIVERS), $this->getDriverUsabilityRule('storage')]),
'drivers.s3_bucket' => ['nullable', 'string', 'max:255'],
'drivers.s3_region' => ['nullable', Rule::in(self::SUPPORTED_S3_REGIONS)],
'drivers.s3_region' => ['nullable', 'string', 'max:64', self::S3_REGION_FORMAT],
'drivers.s3_access_key' => ['nullable', 'string', 'max:255'],
'drivers.s3_secret_key' => ['nullable', 'string', 'max:255'],
'drivers.s3_url' => ['nullable', 'url', 'max:500'],
'drivers.cache_driver' => $this->getTabRules($tab, 'drivers', [Rule::in(self::SUPPORTED_CACHE_DRIVERS)]),
'drivers.s3_endpoint' => ['nullable', 'url', 'max:500'],
'drivers.s3_use_path_style' => ['nullable', 'boolean'],
'drivers.cache_driver' => $this->getTabRules($tab, 'drivers', [Rule::in(self::SUPPORTED_CACHE_DRIVERS), $this->getDriverUsabilityRule('cache')]),
'drivers.redis_host' => ['nullable', 'string', 'max:255'],
'drivers.redis_port' => ['nullable', 'integer', 'min:'.config('core.settings_limits.drivers_redis_port_min', 1), 'max:'.config('core.settings_limits.drivers_redis_port_max', 65535)],
'drivers.redis_password' => ['nullable', 'string', 'max:255'],
'drivers.redis_database' => ['nullable', 'integer', 'min:'.config('core.settings_limits.drivers_redis_database_min', 0), 'max:'.config('core.settings_limits.drivers_redis_database_max', 15)],
'drivers.memcached_host' => ['nullable', 'string', 'max:255'],
'drivers.memcached_port' => ['nullable', 'integer', 'min:'.config('core.settings_limits.drivers_memcached_port_min', 1), 'max:'.config('core.settings_limits.drivers_memcached_port_max', 65535)],
'drivers.session_driver' => $this->getTabRules($tab, 'drivers', [Rule::in(self::SUPPORTED_SESSION_DRIVERS)]),
'drivers.session_driver' => $this->getTabRules($tab, 'drivers', [Rule::in(self::SUPPORTED_SESSION_DRIVERS), $this->getDriverUsabilityRule('session')]),
'drivers.session_lifetime' => ['nullable', 'integer', 'min:'.config('core.settings_limits.drivers_session_lifetime_min', 1), 'max:'.config('core.settings_limits.drivers_session_lifetime_max', 43200)], // 1분 ~ 30일
'drivers.queue_driver' => $this->getTabRules($tab, 'drivers', [Rule::in(self::SUPPORTED_QUEUE_DRIVERS)]),
'drivers.queue_driver' => $this->getTabRules($tab, 'drivers', [Rule::in(self::SUPPORTED_QUEUE_DRIVERS), $this->getDriverUsabilityRule('queue')]),
'drivers.websocket_enabled' => ['nullable', 'boolean'],
'drivers.websocket_app_id' => [Rule::requiredIf(fn () => $this->boolean('drivers.websocket_enabled')), 'nullable', 'string', 'max:255'],
'drivers.websocket_app_key' => [Rule::requiredIf(fn () => $this->boolean('drivers.websocket_enabled')), 'nullable', 'string', 'max:255'],
@@ -478,6 +476,34 @@ class SaveSettingsRequest extends FormRequest
]);
}
/**
* 드라이버 가용성 검증 rule 을 반환합니다.
*
* 선택된 드라이버가 현재 서버에서 실제로 동작 가능한지(어댑터 클래스·PHP 확장 존재)를
* 저장 시점에 검사합니다. 사용 불능 드라이버가 저장되면 사이트 전면 다운으로 이어질 수
* 있으므로(예: phpredis 확장 없는 서버의 redis) 서버 게이트로 차단합니다.
*
* @param string $category 드라이버 카테고리 (storage, cache, session, queue)
* @return \Closure 검증 클로저
*/
private function getDriverUsabilityRule(string $category): \Closure
{
return function ($attribute, $value, $fail) use ($category) {
if (empty($value)) {
return;
}
$registry = app(DriverRegistryService::class);
if (! $registry->isDriverUsable($category, $value)) {
$fail(__('validation.settings.driver_unusable', [
'driver' => $value,
'reason' => $registry->usabilityFailureReason($category, $value),
]));
}
};
}
/**
* 추가 검증을 위해 validator after 콜백을 등록합니다.
*
@@ -734,11 +760,15 @@ class SaveSettingsRequest extends FormRequest
'drivers.storage_driver.required' => __('validation.settings.storage_driver_required'),
'drivers.storage_driver.in' => __('validation.settings.storage_driver_invalid'),
'drivers.s3_bucket.max' => __('validation.settings.s3_bucket_max'),
'drivers.s3_region.in' => __('validation.settings.s3_region_invalid'),
'drivers.s3_region.regex' => __('validation.settings.s3_region_invalid'),
'drivers.s3_region.max' => __('validation.settings.s3_region_max'),
'drivers.s3_access_key.max' => __('validation.settings.s3_access_key_max'),
'drivers.s3_secret_key.max' => __('validation.settings.s3_secret_key_max'),
'drivers.s3_url.url' => __('validation.settings.s3_url_invalid'),
'drivers.s3_url.max' => __('validation.settings.s3_url_max'),
'drivers.s3_endpoint.url' => __('validation.settings.s3_endpoint_invalid'),
'drivers.s3_endpoint.max' => __('validation.settings.s3_endpoint_max'),
'drivers.s3_use_path_style.boolean' => __('validation.settings.s3_use_path_style_boolean'),
'drivers.cache_driver.required' => __('validation.settings.cache_driver_required'),
'drivers.cache_driver.in' => __('validation.settings.cache_driver_invalid'),
'drivers.redis_host.max' => __('validation.settings.redis_host_max'),
@@ -916,6 +946,8 @@ class SaveSettingsRequest extends FormRequest
'drivers.s3_access_key' => __('validation.attributes.s3_access_key'),
'drivers.s3_secret_key' => __('validation.attributes.s3_secret_key'),
'drivers.s3_url' => __('validation.attributes.s3_url'),
'drivers.s3_endpoint' => __('validation.attributes.s3_endpoint'),
'drivers.s3_use_path_style' => __('validation.attributes.s3_use_path_style'),
'drivers.cache_driver' => __('validation.attributes.cache_driver'),
'drivers.redis_host' => __('validation.attributes.redis_host'),
'drivers.redis_port' => __('validation.attributes.redis_port'),
@@ -3,6 +3,8 @@
namespace App\Http\Requests\Settings;
use App\Extension\HookManager;
use App\Services\DriverRegistryService;
use Illuminate\Contracts\Validation\ValidationRule;
use Illuminate\Foundation\Http\FormRequest;
use Illuminate\Validation\Rule;
@@ -20,9 +22,9 @@ class TestDriverConnectionRequest extends FormRequest
private const SUPPORTED_STORAGE_DRIVERS = ['local', 's3'];
/**
* 지원되는 S3 리전 목록
* S3 리전 형식 (AWS 리전 코드 + S3 호환 스토리지 임의값 허용 — R2 의 `auto` 등)
*/
private const SUPPORTED_S3_REGIONS = ['ap-northeast-2', 'ap-northeast-1', 'us-east-1', 'us-west-2', 'eu-west-1'];
private const S3_REGION_FORMAT = 'regex:/^[a-z0-9-]+$/';
/**
* 지원되는 캐시 드라이버 목록
@@ -57,24 +59,26 @@ class TestDriverConnectionRequest extends FormRequest
/**
* Get the validation rules that apply to the request.
*
* @return array<string, \Illuminate\Contracts\Validation\ValidationRule|array<mixed>|string>
* @return array<string, ValidationRule|array<mixed>|string>
*/
public function rules(): array
{
$rules = [
// 드라이버 선택
'storage_driver' => ['nullable', Rule::in(self::SUPPORTED_STORAGE_DRIVERS)],
'cache_driver' => ['nullable', Rule::in(self::SUPPORTED_CACHE_DRIVERS)],
'session_driver' => ['nullable', Rule::in(self::SUPPORTED_SESSION_DRIVERS)],
'queue_driver' => ['nullable', Rule::in(self::SUPPORTED_QUEUE_DRIVERS)],
'storage_driver' => ['nullable', Rule::in(self::SUPPORTED_STORAGE_DRIVERS), $this->getDriverUsabilityRule('storage')],
'cache_driver' => ['nullable', Rule::in(self::SUPPORTED_CACHE_DRIVERS), $this->getDriverUsabilityRule('cache')],
'session_driver' => ['nullable', Rule::in(self::SUPPORTED_SESSION_DRIVERS), $this->getDriverUsabilityRule('session')],
'queue_driver' => ['nullable', Rule::in(self::SUPPORTED_QUEUE_DRIVERS), $this->getDriverUsabilityRule('queue')],
'websocket_enabled' => ['nullable', 'boolean'],
// S3 설정
's3_bucket' => ['nullable', 'string', 'max:255'],
's3_region' => ['nullable', Rule::in(self::SUPPORTED_S3_REGIONS)],
's3_region' => ['nullable', 'string', 'max:64', self::S3_REGION_FORMAT],
's3_access_key' => ['nullable', 'string', 'max:255'],
's3_secret_key' => ['nullable', 'string', 'max:255'],
's3_url' => ['nullable', 'url', 'max:500'],
's3_endpoint' => ['nullable', 'url', 'max:500'],
's3_use_path_style' => ['nullable', 'boolean'],
// Redis 설정
'redis_host' => ['nullable', 'string', 'max:255'],
@@ -86,11 +90,14 @@ class TestDriverConnectionRequest extends FormRequest
'memcached_host' => ['nullable', 'string', 'max:255'],
'memcached_port' => ['nullable', 'integer', 'min:1', 'max:65535'],
// Websocket 설정
// Websocket 설정 — client(브라우저 접속) / server(백엔드 broadcast HTTP API) endpoint 분리
'websocket_app_key' => ['nullable', 'string', 'max:255'],
'websocket_host' => ['nullable', 'string', 'max:255'],
'websocket_port' => ['nullable', 'integer', 'min:1', 'max:65535'],
'websocket_scheme' => ['nullable', Rule::in(self::SUPPORTED_WEBSOCKET_SCHEMES)],
'websocket_server_host' => ['nullable', 'string', 'max:255'],
'websocket_server_port' => ['nullable', 'integer', 'min:1', 'max:65535'],
'websocket_server_scheme' => ['nullable', Rule::in(self::SUPPORTED_WEBSOCKET_SCHEMES)],
];
// 모듈/플러그인이 validation rules를 동적으로 추가할 수 있도록 훅 제공
@@ -107,11 +114,15 @@ class TestDriverConnectionRequest extends FormRequest
return [
'storage_driver.in' => __('validation.settings.storage_driver_invalid'),
's3_bucket.max' => __('validation.settings.s3_bucket_max'),
's3_region.in' => __('validation.settings.s3_region_invalid'),
's3_region.regex' => __('validation.settings.s3_region_invalid'),
's3_region.max' => __('validation.settings.s3_region_max'),
's3_access_key.max' => __('validation.settings.s3_access_key_max'),
's3_secret_key.max' => __('validation.settings.s3_secret_key_max'),
's3_url.url' => __('validation.settings.s3_url_invalid'),
's3_url.max' => __('validation.settings.s3_url_max'),
's3_endpoint.url' => __('validation.settings.s3_endpoint_invalid'),
's3_endpoint.max' => __('validation.settings.s3_endpoint_max'),
's3_use_path_style.boolean' => __('validation.settings.s3_use_path_style_boolean'),
'cache_driver.in' => __('validation.settings.cache_driver_invalid'),
'redis_host.max' => __('validation.settings.redis_host_max'),
'redis_port.integer' => __('validation.settings.redis_port_integer'),
@@ -134,6 +145,38 @@ class TestDriverConnectionRequest extends FormRequest
'websocket_port.min' => __('validation.settings.websocket_port_min'),
'websocket_port.max' => __('validation.settings.websocket_port_max'),
'websocket_scheme.in' => __('validation.settings.websocket_scheme_invalid'),
'websocket_server_host.max' => __('validation.settings.websocket_server_host_max'),
'websocket_server_port.integer' => __('validation.settings.websocket_server_port_integer'),
'websocket_server_port.min' => __('validation.settings.websocket_server_port_min'),
'websocket_server_port.max' => __('validation.settings.websocket_server_port_max'),
'websocket_server_scheme.in' => __('validation.settings.websocket_server_scheme_invalid'),
];
}
/**
* 드라이버 가용성 검증 rule 을 반환합니다.
*
* 저장 게이트(SaveSettingsRequest)와 동일 판정 — 사용 불능 드라이버는 테스트 요청
* 단계에서도 422 로 차단해 어느 경로로도 통과하지 못하게 합니다.
*
* @param string $category 드라이버 카테고리 (storage, cache, session, queue)
* @return \Closure 검증 클로저
*/
private function getDriverUsabilityRule(string $category): \Closure
{
return function ($attribute, $value, $fail) use ($category) {
if (empty($value)) {
return;
}
$registry = app(DriverRegistryService::class);
if (! $registry->isDriverUsable($category, $value)) {
$fail(__('validation.settings.driver_unusable', [
'driver' => $value,
'reason' => $registry->usabilityFailureReason($category, $value),
]));
}
};
}
}