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:
1 parent
c128a6ea3a
commit
ea58c606a2
56 files changed
+2899
-243
No files matched your search
@@ -6,6 +6,7 @@ use App\Repositories\JsonConfigRepository;
|
||||
use App\Support\AllowedExtensions;
|
||||
use Illuminate\Support\Facades\Config;
|
||||
use Illuminate\Support\ServiceProvider;
|
||||
use Predis\Client;
|
||||
|
||||
/**
|
||||
* 설정 서비스 프로바이더
|
||||
@@ -48,7 +49,6 @@ class SettingsServiceProvider extends ServiceProvider
|
||||
$this->applyAppConfig($configRepository);
|
||||
$this->applyDebugConfig($configRepository);
|
||||
$this->applyDriverConfig($configRepository);
|
||||
$this->applyCacheConfig($configRepository);
|
||||
$this->applyUploadConfig($configRepository);
|
||||
$this->applyCoreUpdateConfig($configRepository);
|
||||
$this->applyGeoIpConfig($configRepository);
|
||||
@@ -342,6 +342,16 @@ class SettingsServiceProvider extends ServiceProvider
|
||||
Config::set('filesystems.default', $driverSettings['storage_driver']);
|
||||
}
|
||||
|
||||
// 코어 첨부 업로드 디스크: ATTACHMENT_DISK env 명시가 항상 우선하고,
|
||||
// 미설정 시 storage_driver=s3 를 따른다. env() 직접 호출은 config:cache 환경에서
|
||||
// null 로 고정되므로 config 에 태운 attachment.disk_explicit 로 판별한다.
|
||||
// 빈 문자열도 미명시로 취급한다 — `ATTACHMENT_DISK=` 가 복사된 .env 에서
|
||||
// 빈 값을 명시로 읽으면 전환이 영구 미발동한다 (config 정규화의 2차 방어).
|
||||
// 기존 행은 행 disk 로 서빙되므로 신구 디스크 혼재는 안전하다.
|
||||
if (($driverSettings['storage_driver'] ?? null) === 's3' && in_array(config('attachment.disk_explicit'), [null, ''], true)) {
|
||||
Config::set('attachment.disk', 's3');
|
||||
}
|
||||
|
||||
// 웹소켓 설정
|
||||
$this->applyWebsocketConfig($driverSettings);
|
||||
|
||||
@@ -359,6 +369,16 @@ class SettingsServiceProvider extends ServiceProvider
|
||||
*/
|
||||
private function applyRedisConfig(array $driverSettings): void
|
||||
{
|
||||
// phpredis 확장이 없는 서버에서 redis 드라이버 선택 시 `Class "Redis" not found` 로
|
||||
// 사이트 전면 다운되는 결함 방어 — 설정된 클라이언트가 phpredis 인데 확장이 없고
|
||||
// predis 가 있으면 predis 로 폴백한다. 확장이 있으면 기존 phpredis 경로 그대로다.
|
||||
// env('REDIS_CLIENT') 미명시 판별은 무효였다: .env.example 이 REDIS_CLIENT=phpredis
|
||||
// 를 활성 배포하므로 표준 설치에서 영구 미발동이었고, env() 직접 호출은
|
||||
// config:cache 환경에서 null 로 고정된다 (A8 disk_explicit 와 동형 함정).
|
||||
if ($this->shouldFallBackToPredis(extension_loaded('redis'))) {
|
||||
Config::set('database.redis.client', 'predis');
|
||||
}
|
||||
|
||||
if (! empty($driverSettings['redis_host'])) {
|
||||
Config::set('database.redis.default.host', $driverSettings['redis_host']);
|
||||
Config::set('database.redis.cache.host', $driverSettings['redis_host']);
|
||||
@@ -380,6 +400,25 @@ class SettingsServiceProvider extends ServiceProvider
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Redis 클라이언트를 predis 로 폴백해야 하는지 판정합니다.
|
||||
*
|
||||
* 설정된 클라이언트(config — env 시점 값이 config:cache 에도 박제됨)가 phpredis 를
|
||||
* 가리키는데 확장이 로드되어 있지 않고 predis 가 존재하면 참. phpredis 명시 설정이라도
|
||||
* 확장이 없으면 어차피 동작 불가이므로 predis 전환이 유일한 동작 경로다 (#99 A2).
|
||||
* 확장 로드 여부는 인자로 받는다 — 확장 설치 머신에서 부재 상태를 재현할 수 없어
|
||||
* 판정 자체를 단위 검증 가능하게 분리한 것 (테스트가 양 분기를 주입 검증).
|
||||
*
|
||||
* @param bool $phpredisLoaded phpredis 확장 로드 여부 (extension_loaded('redis'))
|
||||
* @return bool predis 로 폴백해야 하면 true
|
||||
*/
|
||||
private function shouldFallBackToPredis(bool $phpredisLoaded): bool
|
||||
{
|
||||
return config('database.redis.client', 'phpredis') !== 'predis'
|
||||
&& ! $phpredisLoaded
|
||||
&& class_exists(Client::class);
|
||||
}
|
||||
|
||||
/**
|
||||
* Memcached 연결 설정을 적용합니다.
|
||||
*/
|
||||
@@ -418,6 +457,16 @@ class SettingsServiceProvider extends ServiceProvider
|
||||
if (! empty($driverSettings['s3_url'])) {
|
||||
Config::set('filesystems.disks.s3.url', $driverSettings['s3_url']);
|
||||
}
|
||||
|
||||
// S3 호환 스토리지(R2/MinIO/NCP 등)의 API 요청 대상 — s3_url(공개 URL base)과 별개 축이다.
|
||||
// endpoint 미주입 시 SDK 는 AWS 리전 도메인으로만 요청하므로 호환 스토리지 연결이 불가능하다.
|
||||
if (! empty($driverSettings['s3_endpoint'])) {
|
||||
Config::set('filesystems.disks.s3.endpoint', $driverSettings['s3_endpoint']);
|
||||
}
|
||||
|
||||
if (! empty($driverSettings['s3_use_path_style'])) {
|
||||
Config::set('filesystems.disks.s3.use_path_style_endpoint', true);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -619,26 +668,6 @@ class SettingsServiceProvider extends ServiceProvider
|
||||
Config::set('settings.identity', $settings);
|
||||
}
|
||||
|
||||
/**
|
||||
* 캐시 설정을 Laravel config에 적용합니다.
|
||||
*/
|
||||
private function applyCacheConfig(JsonConfigRepository $configRepository): void
|
||||
{
|
||||
$cacheSettings = $configRepository->getCategory('cache');
|
||||
|
||||
if (empty($cacheSettings)) {
|
||||
return;
|
||||
}
|
||||
|
||||
if (! empty($cacheSettings['driver'])) {
|
||||
Config::set('cache.default', $cacheSettings['driver']);
|
||||
}
|
||||
|
||||
if (! empty($cacheSettings['prefix'])) {
|
||||
Config::set('cache.prefix', $cacheSettings['prefix']);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 업로드 설정을 Laravel config에 적용합니다.
|
||||
*/
|
||||
@@ -650,10 +679,6 @@ class SettingsServiceProvider extends ServiceProvider
|
||||
return;
|
||||
}
|
||||
|
||||
if (! empty($uploadSettings['disk'])) {
|
||||
Config::set('filesystems.default', $uploadSettings['disk']);
|
||||
}
|
||||
|
||||
// 관리자 설정은 MB, config/attachment.* 는 KB — 변환은 이 지점 단 한 곳에서만 수행한다.
|
||||
// (기존에는 존재하지 않는 키 `max_size` 를 읽어 설정이 어디에도 반영되지 않았다)
|
||||
if (! empty($uploadSettings['max_file_size'])) {
|
||||
|
||||
Reference in new issue
Block a user