HeuJung
2ae1972a3b
공개 이슈 gnuboard/g7 이 지목한 병목은 "같은 일을 반복 실행한다" 축이다. 응답·행의 무게를 다룬 · 과 겹치지 않는다. 공통 계약 — 총 건수 상한과 페이지 이동 범위는 별개 결정이다. 묶으면 필요 없이 기능이 깎인다. 총 건수만 상한을 받고(파생 테이블 COUNT), "다음" 이동은 per_page + 1 실측으로 끝까지 열어 둔다. 계산이 불가능해지는 것은 마지막 페이지 번호 하나뿐이며 그 사실은 last_page: null 이 알린다. 최신순처럼 실제 컬럼으로 정렬하는 목록은 커서로 전환해 깊이와 무관하게 일정 속도로 이동한다. 관련도순은 계산값 정렬이라 커서 키로 쓸 수 없어 offset 을 유지한다. 계약의 입구는 표준 paginate 와 같은 폭이어야 한다. 관계·쿼리 빌더를 받지 못하면 그 좁은 만큼이 그대로 운영 500 이 되고, 실제로 관리자 알림 목록에서 그렇게 터졌다. 응답 조립도 컬렉션마다 손으로 하면 형태가 늘어나는 순간 없는 값을 부르거나 새 필드를 흘리므로, 형태 판정을 paginationMeta 한 곳에 모았다. 표준 paginate 응답은 필드 단위로 이전과 동일하다. 요청당 반복 비용 — 훅 구독마다 남기던 로그 400줄, 요청당 스무 번 넘던 설정 파일 재읽기, 이미 캐시된 목록의 DB 재조회를 없앴다. 권한 판정은 요청 스코프 메모를 두어 화면 요소마다 나가던 조회를 한 번으로 줄였고, 크로스 요청 캐시는 두지 않아 권한 변경이 종전처럼 다음 요청에 반영된다. 검색 질의는 활성 엔진이 만든다. 저장소가 구체 엔진을 지목하면 플러그인이 등록한 엔진은 호출될 기회 자체를 잃고 오류 없이 다른 방식으로 동작한다. 해석기를 두어 활성 엔진에 위임하고, 전문검색이 없는 DBMS 의 부분일치 폴백도 드라이버명 하드코딩 대신 선언형 config 로 옮겼다. 총 건수가 잘린 목록에서 순번을 역산하면 0 과 음수가 나온다. 지어내지 않고 null 을 돌려주며, 그 원칙을 last_page 와 동일하게 적용했다.
582 lines
19 KiB
PHP
582 lines
19 KiB
PHP
<?php
|
|
|
|
namespace App\Repositories;
|
|
|
|
use App\Contracts\Repositories\ConfigRepositoryInterface;
|
|
use Illuminate\Support\Arr;
|
|
use Illuminate\Support\Facades\Log;
|
|
use Illuminate\Support\Facades\Storage;
|
|
|
|
/**
|
|
* JSON 파일 기반 설정 저장소
|
|
*
|
|
* 설정을 카테고리별 JSON 파일로 관리합니다.
|
|
*/
|
|
class JsonConfigRepository implements ConfigRepositoryInterface
|
|
{
|
|
/**
|
|
* Storage disk 이름
|
|
*/
|
|
private const STORAGE_DISK = 'settings';
|
|
|
|
/**
|
|
* 백업 파일 저장 디렉토리 (disk 기준)
|
|
*/
|
|
private const BACKUP_DIR = 'backups';
|
|
|
|
/**
|
|
* 기본 설정 파일 경로
|
|
*/
|
|
private const DEFAULTS_FILE = 'settings/defaults.json';
|
|
|
|
/**
|
|
* 기본 설정 캐시
|
|
*
|
|
* @var array<string, mixed>|null
|
|
*/
|
|
private ?array $defaultsCache = null;
|
|
|
|
/**
|
|
* 메모리 캐시
|
|
*
|
|
* @var array<string, array<string, mixed>>|null
|
|
*/
|
|
private ?array $cache = null;
|
|
|
|
/**
|
|
* 카테고리별 메모리 캐시
|
|
*
|
|
* 부팅 한 번에 같은 카테고리를 여러 곳에서 읽는다 — SettingsServiceProvider 의
|
|
* apply*Config 9종과 loadCoreSettingsToConfig 가 각각 조회하므로, 캐시가 없으면
|
|
* 요청마다 카테고리 수만큼 곱한 횟수로 파일 존재 확인·읽기·JSON 파싱이 반복된다.
|
|
*
|
|
* @var array<string, array<string, mixed>>
|
|
*/
|
|
private array $categoryCache = [];
|
|
|
|
/**
|
|
* 모든 카테고리의 설정을 조회합니다.
|
|
*
|
|
* @return array<string, array<string, mixed>>
|
|
*/
|
|
public function all(): array
|
|
{
|
|
if ($this->cache !== null) {
|
|
return $this->cache;
|
|
}
|
|
|
|
$settings = [];
|
|
foreach ($this->getCategories() as $category) {
|
|
$settings[$category] = $this->getCategory($category);
|
|
}
|
|
|
|
$this->cache = $settings;
|
|
|
|
return $settings;
|
|
}
|
|
|
|
/**
|
|
* 특정 카테고리의 설정을 조회합니다.
|
|
*
|
|
* @param string $category 카테고리명
|
|
* @return array<string, mixed> 기본값과 병합된 설정
|
|
*/
|
|
public function getCategory(string $category): array
|
|
{
|
|
if (array_key_exists($category, $this->categoryCache)) {
|
|
return $this->categoryCache[$category];
|
|
}
|
|
|
|
return $this->categoryCache[$category] = $this->readCategory($category);
|
|
}
|
|
|
|
/**
|
|
* 카테고리 설정을 파일에서 읽어 기본값과 병합합니다.
|
|
*
|
|
* 캐시를 거치지 않는 실제 읽기 경로입니다.
|
|
*
|
|
* @param string $category 카테고리명
|
|
* @return array<string, mixed>
|
|
*/
|
|
private function readCategory(string $category): array
|
|
{
|
|
if (! $this->categoryExists($category)) {
|
|
return $this->getDefaultsForCategory($category);
|
|
}
|
|
|
|
$path = $this->getCategoryPath($category);
|
|
|
|
// audit:allow no-storage-disk-direct reason: 이 저장소는 SettingsServiceProvider::register() 에서
|
|
// `new` 로 직접 생성된다 — 컨테이너 바인딩 이전이라 StorageInterface 를 해석할 수 없다.
|
|
// 설정 JSON 은 부팅 자체가 의존하는 자료라 드라이버 추상화보다 부팅 순서가 우선한다.
|
|
if (! Storage::disk(self::STORAGE_DISK)->exists($path)) {
|
|
return $this->getDefaultsForCategory($category);
|
|
}
|
|
|
|
try {
|
|
// audit:allow no-storage-disk-direct reason: 이 저장소는 SettingsServiceProvider::register() 에서
|
|
// `new` 로 직접 생성된다 — 컨테이너 바인딩 이전이라 StorageInterface 를 해석할 수 없다.
|
|
// 설정 JSON 은 부팅 자체가 의존하는 자료라 드라이버 추상화보다 부팅 순서가 우선한다.
|
|
$content = Storage::disk(self::STORAGE_DISK)->get($path);
|
|
$data = json_decode($content, true);
|
|
|
|
if (json_last_error() !== JSON_ERROR_NONE) {
|
|
Log::warning("설정 파일 JSON 파싱 실패: {$category}", [
|
|
'error' => json_last_error_msg(),
|
|
]);
|
|
|
|
return $this->getDefaultsForCategory($category);
|
|
}
|
|
|
|
// _meta 키 제거하고 반환
|
|
unset($data['_meta']);
|
|
|
|
// 기본값과 병합 (새 설정 키 자동 추가)
|
|
$defaults = $this->getDefaultsForCategory($category);
|
|
|
|
return array_merge($defaults, $data);
|
|
} catch (\Exception $e) {
|
|
Log::error("설정 파일 읽기 실패: {$category}", [
|
|
'error' => $e->getMessage(),
|
|
]);
|
|
|
|
return $this->getDefaultsForCategory($category);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 도트 노테이션으로 특정 설정값을 조회합니다.
|
|
*
|
|
* @param string $key 예: 'mail.host', 'general.site_name'
|
|
* @param mixed $default 값이 없을 때 돌려줄 기본값
|
|
* @return mixed 설정값 (없으면 $default)
|
|
*/
|
|
public function get(string $key, mixed $default = null): mixed
|
|
{
|
|
$parts = explode('.', $key, 2);
|
|
|
|
if (count($parts) === 1) {
|
|
// 카테고리만 지정된 경우
|
|
return $this->getCategory($key);
|
|
}
|
|
|
|
[$category, $settingKey] = $parts;
|
|
$categoryData = $this->getCategory($category);
|
|
|
|
return Arr::get($categoryData, $settingKey, $default);
|
|
}
|
|
|
|
/**
|
|
* 도트 노테이션으로 특정 설정값을 저장합니다.
|
|
*
|
|
* @param string $key 설정 키 (카테고리.항목)
|
|
* @param mixed $value 저장할 값
|
|
* @return bool 저장 성공 여부
|
|
*/
|
|
public function set(string $key, mixed $value): bool
|
|
{
|
|
$parts = explode('.', $key, 2);
|
|
|
|
if (count($parts) !== 2) {
|
|
return false;
|
|
}
|
|
|
|
[$category, $settingKey] = $parts;
|
|
$categoryData = $this->getCategory($category);
|
|
Arr::set($categoryData, $settingKey, $value);
|
|
|
|
return $this->saveCategory($category, $categoryData);
|
|
}
|
|
|
|
/**
|
|
* 여러 설정을 일괄 저장합니다.
|
|
*
|
|
* @param array<string, mixed> $settings 도트 노테이션 키 ⇒ 값
|
|
* @return bool 저장 성공 여부
|
|
*/
|
|
public function setMany(array $settings): bool
|
|
{
|
|
$grouped = $this->groupByCategory($settings);
|
|
|
|
foreach ($grouped as $category => $categorySettings) {
|
|
$existing = $this->getCategory($category);
|
|
$merged = array_merge($existing, $categorySettings);
|
|
|
|
if (! $this->saveCategory($category, $merged)) {
|
|
return false;
|
|
}
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* 특정 카테고리의 설정을 저장합니다.
|
|
*
|
|
* @param string $category 카테고리명
|
|
* @param array<string, mixed> $settings 저장할 설정
|
|
* @return bool 저장 성공 여부
|
|
*/
|
|
public function saveCategory(string $category, array $settings): bool
|
|
{
|
|
if (! $this->categoryExists($category)) {
|
|
return false;
|
|
}
|
|
|
|
$this->ensureDirectoryExists();
|
|
|
|
// 메타 정보 추가
|
|
$data = [
|
|
'_meta' => [
|
|
'version' => '1.0.0',
|
|
'updated_at' => now()->toIso8601String(),
|
|
],
|
|
...$settings,
|
|
];
|
|
|
|
$path = $this->getCategoryPath($category);
|
|
$json = json_encode($data, JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE);
|
|
|
|
try {
|
|
// 파일 잠금으로 동시 쓰기 방지
|
|
// audit:allow no-storage-disk-direct reason: 이 저장소는 SettingsServiceProvider::register() 에서
|
|
// `new` 로 직접 생성된다 — 컨테이너 바인딩 이전이라 StorageInterface 를 해석할 수 없다.
|
|
// 설정 JSON 은 부팅 자체가 의존하는 자료라 드라이버 추상화보다 부팅 순서가 우선한다.
|
|
$fullPath = Storage::disk(self::STORAGE_DISK)->path($path);
|
|
$handle = fopen($fullPath, 'c');
|
|
|
|
if ($handle === false) {
|
|
return false;
|
|
}
|
|
|
|
if (flock($handle, LOCK_EX)) {
|
|
ftruncate($handle, 0);
|
|
fwrite($handle, $json);
|
|
fflush($handle);
|
|
flock($handle, LOCK_UN);
|
|
}
|
|
|
|
fclose($handle);
|
|
|
|
// 캐시 무효화 — 저장한 카테고리와 전체 맵 양쪽을 비운다.
|
|
// 한쪽만 비우면 저장 직후 조회가 이전 값을 돌려준다.
|
|
$this->cache = null;
|
|
unset($this->categoryCache[$category]);
|
|
|
|
return true;
|
|
} catch (\Exception $e) {
|
|
Log::error("설정 파일 저장 실패: {$category}", [
|
|
'error' => $e->getMessage(),
|
|
]);
|
|
|
|
return false;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 설정 키 존재 여부를 확인합니다.
|
|
*
|
|
* @param string $key 설정 키 (카테고리.항목)
|
|
* @return bool 존재 여부
|
|
*/
|
|
public function has(string $key): bool
|
|
{
|
|
return $this->get($key) !== null;
|
|
}
|
|
|
|
/**
|
|
* 특정 설정을 삭제합니다.
|
|
*
|
|
* @param string $key 설정 키 (카테고리.항목)
|
|
* @return bool 삭제 성공 여부
|
|
*/
|
|
public function delete(string $key): bool
|
|
{
|
|
$parts = explode('.', $key, 2);
|
|
|
|
if (count($parts) !== 2) {
|
|
return false;
|
|
}
|
|
|
|
[$category, $settingKey] = $parts;
|
|
$categoryData = $this->getCategory($category);
|
|
|
|
Arr::forget($categoryData, $settingKey);
|
|
|
|
return $this->saveCategory($category, $categoryData);
|
|
}
|
|
|
|
/**
|
|
* 사용 가능한 카테고리 목록을 반환합니다.
|
|
*
|
|
* config/settings/defaults.json의 _meta.categories에서 조회합니다.
|
|
*
|
|
* @return array<string>
|
|
*/
|
|
public function getCategories(): array
|
|
{
|
|
if ($this->defaultsCache === null) {
|
|
$this->loadDefaultsFile();
|
|
}
|
|
|
|
return $this->defaultsCache['_meta']['categories'] ?? [];
|
|
}
|
|
|
|
/**
|
|
* 카테고리 존재 여부를 확인합니다.
|
|
*
|
|
* @param string $category 카테고리명
|
|
* @return bool 존재 여부
|
|
*/
|
|
public function categoryExists(string $category): bool
|
|
{
|
|
return in_array($category, $this->getCategories(), true);
|
|
}
|
|
|
|
/**
|
|
* 설정 파일을 초기화합니다.
|
|
*
|
|
* @param array<string, array<string, mixed>> $settings 기본값 위에 덮어쓸 설정
|
|
* @return bool 초기화 성공 여부
|
|
*/
|
|
public function initialize(array $settings = []): bool
|
|
{
|
|
$this->ensureDirectoryExists();
|
|
|
|
$defaults = $this->getDefaults();
|
|
$merged = array_replace_recursive($defaults, $settings);
|
|
|
|
foreach ($merged as $category => $categorySettings) {
|
|
if (! $this->saveCategory($category, $categorySettings)) {
|
|
return false;
|
|
}
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* 설정을 백업합니다.
|
|
*
|
|
* @return string 백업 파일 경로
|
|
*/
|
|
public function backup(): string
|
|
{
|
|
$this->ensureBackupDirectoryExists();
|
|
|
|
$timestamp = now()->format('Y-m-d_His');
|
|
$backupName = "backup_{$timestamp}.zip";
|
|
$backupPath = self::BACKUP_DIR.'/'.$backupName;
|
|
|
|
$zip = new \ZipArchive;
|
|
// audit:allow no-storage-disk-direct reason: 이 저장소는 SettingsServiceProvider::register() 에서
|
|
// `new` 로 직접 생성된다 — 컨테이너 바인딩 이전이라 StorageInterface 를 해석할 수 없다.
|
|
// 설정 JSON 은 부팅 자체가 의존하는 자료라 드라이버 추상화보다 부팅 순서가 우선한다.
|
|
$fullBackupPath = Storage::disk(self::STORAGE_DISK)->path($backupPath);
|
|
|
|
if ($zip->open($fullBackupPath, \ZipArchive::CREATE | \ZipArchive::OVERWRITE) !== true) {
|
|
throw new \RuntimeException(__('exceptions.settings.backup_creation_failed'));
|
|
}
|
|
|
|
foreach ($this->getCategories() as $category) {
|
|
$categoryPath = $this->getCategoryPath($category);
|
|
// audit:allow no-storage-disk-direct reason: 이 저장소는 SettingsServiceProvider::register() 에서
|
|
// `new` 로 직접 생성된다 — 컨테이너 바인딩 이전이라 StorageInterface 를 해석할 수 없다.
|
|
// 설정 JSON 은 부팅 자체가 의존하는 자료라 드라이버 추상화보다 부팅 순서가 우선한다.
|
|
$fullCategoryPath = Storage::disk(self::STORAGE_DISK)->path($categoryPath);
|
|
|
|
if (file_exists($fullCategoryPath)) {
|
|
$zip->addFile($fullCategoryPath, "{$category}.json");
|
|
}
|
|
}
|
|
|
|
$zip->close();
|
|
|
|
return $backupPath;
|
|
}
|
|
|
|
/**
|
|
* 백업에서 설정을 복원합니다.
|
|
*
|
|
* @param string $backupPath 백업 파일 경로 (disk 기준)
|
|
* @return bool 복원 성공 여부
|
|
*/
|
|
public function restore(string $backupPath): bool
|
|
{
|
|
// audit:allow no-storage-disk-direct reason: 이 저장소는 SettingsServiceProvider::register() 에서
|
|
// `new` 로 직접 생성된다 — 컨테이너 바인딩 이전이라 StorageInterface 를 해석할 수 없다.
|
|
// 설정 JSON 은 부팅 자체가 의존하는 자료라 드라이버 추상화보다 부팅 순서가 우선한다.
|
|
$fullBackupPath = Storage::disk(self::STORAGE_DISK)->path($backupPath);
|
|
|
|
if (! file_exists($fullBackupPath)) {
|
|
return false;
|
|
}
|
|
|
|
$zip = new \ZipArchive;
|
|
|
|
if ($zip->open($fullBackupPath) !== true) {
|
|
return false;
|
|
}
|
|
|
|
$this->ensureDirectoryExists();
|
|
|
|
for ($i = 0; $i < $zip->numFiles; $i++) {
|
|
$filename = $zip->getNameIndex($i);
|
|
$category = pathinfo($filename, PATHINFO_FILENAME);
|
|
|
|
if ($this->categoryExists($category)) {
|
|
$content = $zip->getFromIndex($i);
|
|
$categoryPath = $this->getCategoryPath($category);
|
|
// audit:allow no-storage-disk-direct reason: 이 저장소는 SettingsServiceProvider::register() 에서
|
|
// `new` 로 직접 생성된다 — 컨테이너 바인딩 이전이라 StorageInterface 를 해석할 수 없다.
|
|
// 설정 JSON 은 부팅 자체가 의존하는 자료라 드라이버 추상화보다 부팅 순서가 우선한다.
|
|
Storage::disk(self::STORAGE_DISK)->put($categoryPath, $content);
|
|
}
|
|
}
|
|
|
|
$zip->close();
|
|
$this->cache = null;
|
|
$this->categoryCache = [];
|
|
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* 기본 설정값을 반환합니다.
|
|
*
|
|
* config/settings/defaults.json 파일에서 기본값을 로드합니다.
|
|
*
|
|
* @return array<string, array<string, mixed>>
|
|
*/
|
|
public function getDefaults(): array
|
|
{
|
|
if ($this->defaultsCache !== null) {
|
|
return $this->defaultsCache['defaults'] ?? [];
|
|
}
|
|
|
|
$this->loadDefaultsFile();
|
|
|
|
return $this->defaultsCache['defaults'] ?? [];
|
|
}
|
|
|
|
/**
|
|
* 프론트엔드 스키마를 반환합니다.
|
|
*
|
|
* @return array<string, array<string, mixed>>
|
|
*/
|
|
public function getFrontendSchema(): array
|
|
{
|
|
if ($this->defaultsCache === null) {
|
|
$this->loadDefaultsFile();
|
|
}
|
|
|
|
return $this->defaultsCache['frontend_schema'] ?? [];
|
|
}
|
|
|
|
/**
|
|
* 기본 설정 파일을 로드합니다.
|
|
*/
|
|
private function loadDefaultsFile(): void
|
|
{
|
|
$path = config_path(self::DEFAULTS_FILE);
|
|
|
|
if (! file_exists($path)) {
|
|
Log::error('설정 기본값 파일을 찾을 수 없습니다. settings:install 명령을 실행하세요.', ['path' => $path]);
|
|
$this->defaultsCache = ['_meta' => ['categories' => []], 'defaults' => [], 'frontend_schema' => []];
|
|
|
|
return;
|
|
}
|
|
|
|
try {
|
|
$content = file_get_contents($path);
|
|
$data = json_decode($content, true);
|
|
|
|
if (json_last_error() !== JSON_ERROR_NONE) {
|
|
Log::error('설정 기본값 파일 JSON 파싱 실패', [
|
|
'error' => json_last_error_msg(),
|
|
]);
|
|
$this->defaultsCache = ['_meta' => ['categories' => []], 'defaults' => [], 'frontend_schema' => []];
|
|
|
|
return;
|
|
}
|
|
|
|
$this->defaultsCache = $data;
|
|
} catch (\Exception $e) {
|
|
Log::error('설정 기본값 파일 로드 실패', ['error' => $e->getMessage()]);
|
|
$this->defaultsCache = ['_meta' => ['categories' => []], 'defaults' => [], 'frontend_schema' => []];
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 특정 카테고리의 기본값을 반환합니다.
|
|
*
|
|
* @return array<string, mixed>
|
|
*/
|
|
private function getDefaultsForCategory(string $category): array
|
|
{
|
|
$defaults = $this->getDefaults();
|
|
|
|
return $defaults[$category] ?? [];
|
|
}
|
|
|
|
/**
|
|
* 카테고리 파일 경로를 반환합니다.
|
|
*/
|
|
private function getCategoryPath(string $category): string
|
|
{
|
|
return "{$category}.json";
|
|
}
|
|
|
|
/**
|
|
* 설정 디렉토리가 존재하는지 확인하고 없으면 생성합니다.
|
|
*/
|
|
private function ensureDirectoryExists(): void
|
|
{
|
|
// audit:allow no-storage-disk-direct reason: 이 저장소는 SettingsServiceProvider::register() 에서
|
|
// `new` 로 직접 생성된다 — 컨테이너 바인딩 이전이라 StorageInterface 를 해석할 수 없다.
|
|
// 설정 JSON 은 부팅 자체가 의존하는 자료라 드라이버 추상화보다 부팅 순서가 우선한다.
|
|
$disk = Storage::disk(self::STORAGE_DISK);
|
|
|
|
if (! $disk->exists('.')) {
|
|
$disk->makeDirectory('.');
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 백업 디렉토리가 존재하는지 확인하고 없으면 생성합니다.
|
|
*/
|
|
private function ensureBackupDirectoryExists(): void
|
|
{
|
|
// audit:allow no-storage-disk-direct reason: 이 저장소는 SettingsServiceProvider::register() 에서
|
|
// `new` 로 직접 생성된다 — 컨테이너 바인딩 이전이라 StorageInterface 를 해석할 수 없다.
|
|
// 설정 JSON 은 부팅 자체가 의존하는 자료라 드라이버 추상화보다 부팅 순서가 우선한다.
|
|
$disk = Storage::disk(self::STORAGE_DISK);
|
|
|
|
if (! $disk->exists(self::BACKUP_DIR)) {
|
|
$disk->makeDirectory(self::BACKUP_DIR);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 설정을 카테고리별로 그룹화합니다.
|
|
*
|
|
* @param array<string, mixed> $settings
|
|
* @return array<string, array<string, mixed>>
|
|
*/
|
|
private function groupByCategory(array $settings): array
|
|
{
|
|
$grouped = [];
|
|
|
|
foreach ($settings as $key => $value) {
|
|
$parts = explode('.', $key, 2);
|
|
|
|
if (count($parts) === 2) {
|
|
[$category, $settingKey] = $parts;
|
|
$grouped[$category][$settingKey] = $value;
|
|
}
|
|
}
|
|
|
|
return $grouped;
|
|
}
|
|
}
|