diff --git a/CHANGELOG.md b/CHANGELOG.md index eeede335..7208e4cc 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -17,8 +17,12 @@ - 사이트맵의 갱신 빈도(changefreq) 값을 검색엔진 표준 어휘(always/hourly/daily/weekly/monthly/yearly/never)로 맞춰, 규격에 없는 값은 사이트맵에 출력되지 않도록 했습니다. - 관리자가 사이트맵 전체 재생성을 실행하면, 완료되거나 실패했을 때 실행한 관리자에게 알림을 보냅니다. 재생성이 오래 걸려 화면을 떠나 있어도 결과를 놓치지 않습니다. (기본은 앱 내 알림이며 관리자 알림 설정에서 이메일도 켤 수 있습니다. 매일 자동 생성이나 글·상품 변경에 따른 재생성은 알림을 보내지 않습니다.) +- 설치할 때 `root` 같은 데이터베이스 최고 권한 계정을 입력하면 설치가 진행되지 않고, 왜 사용할 수 없는지와 어떻게 해야 하는지를 함께 안내합니다. 최고 권한 계정 정보가 유출되면 데이터베이스 전체가 위험해지기 때문이며, 사이트 전용 데이터베이스 계정을 새로 만들어 필요한 권한만 부여해 입력하시면 됩니다. 읽기 전용 데이터베이스를 따로 쓰는 경우에도 동일하게 적용됩니다. +- 서버에 OPcache가 켜져 있는지를 설치 화면과 관리자 환경설정 > 정보에서 확인할 수 있습니다. OPcache는 PHP 코드 해석 결과를 재사용해 사이트 응답 속도를 크게 높여 주는 기능으로, 꺼져 있으면 성능이 떨어진다는 안내와 함께 설정 방법을 알려 드립니다. 꺼져 있어도 설치는 그대로 진행되므로 설치가 막히지 않습니다. + ### Fixed +- 데이터베이스 계정 설정이 잘못되었을 때 아무 설명 없이 빈 화면만 뜨던 문제를 수정했습니다. 이전에는 최고 권한 계정을 쓰거나 사용자명이 비어 있으면 사이트 기능이 통째로 동작을 멈추면서도 화면에는 아무 안내가 없어 원인을 알 수 없었습니다. 이제 무엇이 잘못되었고 어떻게 고쳐야 하는지 설명하는 전용 안내 화면이 나타납니다. 서버 관리 명령은 평소대로 실행되므로 이 상태에서도 설정을 고칠 수 있습니다. - SEO 설정의 캐시 항목(SEO 캐시 사용·유지 시간, Sitemap 캐시 유지 시간)이 저장해도 적용되지 않던 문제를 수정했습니다. 이제 고급 설정의 캐시 값이 기준이 되고, SEO 설정에서 값을 지정하면 그 값이 우선하며, 비워두면 고급 설정을 따릅니다. 업그레이드 시 기존에 기본값과 다르게 지정해 두셨던 값은 그대로 살아나 이제부터 실제로 적용되므로 SEO 캐시 동작이 달라질 수 있습니다. 기본값 그대로였던 항목은 "지정 안 함"으로 정리되어 동작이 바뀌지 않습니다. ## [7.0.5] - 2026-07-16 diff --git a/app/Http/Middleware/Concerns/DetectsRequestLocale.php b/app/Http/Middleware/Concerns/DetectsRequestLocale.php new file mode 100644 index 00000000..58ef71f5 --- /dev/null +++ b/app/Http/Middleware/Concerns/DetectsRequestLocale.php @@ -0,0 +1,42 @@ +header('Accept-Language'); + if ($acceptLanguage) { + $languages = explode(',', $acceptLanguage); + foreach ($languages as $language) { + $lang = trim(explode(';', $language)[0]); + if (strpos($lang, '-') !== false) { + $lang = explode('-', $lang)[0]; + } + if (in_array($lang, $supportedLocales)) { + return $lang; + } + } + } + + return config('app.locale', 'ko'); + } +} diff --git a/app/Http/Middleware/DatabaseCredentialGuard.php b/app/Http/Middleware/DatabaseCredentialGuard.php new file mode 100644 index 00000000..26aa69de --- /dev/null +++ b/app/Http/Middleware/DatabaseCredentialGuard.php @@ -0,0 +1,85 @@ +resolveUsername(); + + if (PrivilegedDatabaseAccounts::isUsable($username)) { + return $next($request); + } + + // SetLocale 미실행 상태이므로 로케일을 자체 감지한다. + // API/HTML 분기보다 먼저 적용해야 JSON 메시지도 활성 로케일을 반영한다. + app()->setLocale($this->detectLocale($request)); + + if ($request->expectsJson() || $request->is('api/*')) { + return response()->json([ + 'success' => false, + 'message' => __('database_credential.message'), + ], 503); + } + + // 확장·템플릿이 로딩되지 않은 상태이므로 템플릿 뷰나 errors/layout 을 + // 쓸 수 없다. DB/JS 무의존 자체 완결 정적 페이지를 반환한다. + return response()->view('database-credential-error', [ + // 실제 계정명은 전달하지 않는다 — 미인증 공개 페이지이므로 정보 유출. + 'reason' => PrivilegedDatabaseAccounts::isBlocked($username) ? 'blocked' : 'empty', + ], 503); + } + + /** + * 현재 DB 커넥션 설정에서 사용자명을 해석합니다. + * + * DB::connection() 을 거치지 않고 config 배열만 읽습니다. 이 가드는 DB 설정이 + * 잘못된 상황에서 동작해야 하므로, 판정을 위해 커넥션을 해석하는 것 자체가 + * 새로운 실패 지점이 됩니다. read/write 우선순위 규칙은 + * PrivilegedDatabaseAccounts 가 CoreServiceProvider 와 공유합니다. + * + * @return string|null 해석된 사용자명 (없으면 null) + */ + protected function resolveUsername(): ?string + { + $connection = config('database.default'); + + return PrivilegedDatabaseAccounts::resolveUsername( + config("database.connections.{$connection}", []) + ); + } +} diff --git a/app/Http/Middleware/MaintenanceModePage.php b/app/Http/Middleware/MaintenanceModePage.php index 3c036c80..b183dd58 100644 --- a/app/Http/Middleware/MaintenanceModePage.php +++ b/app/Http/Middleware/MaintenanceModePage.php @@ -2,6 +2,7 @@ namespace App\Http\Middleware; +use App\Http\Middleware\Concerns\DetectsRequestLocale; use Closure; use Illuminate\Foundation\Http\MaintenanceModeBypassCookie; use Illuminate\Http\Request; @@ -9,6 +10,8 @@ use Symfony\Component\HttpFoundation\Response; class MaintenanceModePage { + use DetectsRequestLocale; + /** * Maintenance 모드일 때 전용 정적 페이지를 렌더링합니다. * @@ -76,31 +79,4 @@ class MaintenanceModePage return MaintenanceModeBypassCookie::isValid($cookie, $data['secret']); } - - /** - * 로케일을 감지합니다. SetLocale 미들웨어의 로직을 준용합니다. - * - * @param Request $request HTTP 요청 - * @return string 감지된 로케일 - */ - protected function detectLocale(Request $request): string - { - $supportedLocales = config('app.supported_locales', ['ko', 'en']); - - $acceptLanguage = $request->header('Accept-Language'); - if ($acceptLanguage) { - $languages = explode(',', $acceptLanguage); - foreach ($languages as $language) { - $lang = trim(explode(';', $language)[0]); - if (strpos($lang, '-') !== false) { - $lang = explode('-', $lang)[0]; - } - if (in_array($lang, $supportedLocales)) { - return $lang; - } - } - } - - return config('app.locale', 'ko'); - } } diff --git a/app/Providers/CoreServiceProvider.php b/app/Providers/CoreServiceProvider.php index d827d885..c63e4bb0 100644 --- a/app/Providers/CoreServiceProvider.php +++ b/app/Providers/CoreServiceProvider.php @@ -92,6 +92,7 @@ use App\Services\DriverRegistryService; use App\Services\LayoutExtensionService; use App\Services\TemplateLayoutAttachmentService; use App\Services\UniqueIdService; +use App\Support\PrivilegedDatabaseAccounts; use Illuminate\Support\Facades\Config; use Illuminate\Support\Facades\DB; use Illuminate\Support\Facades\File; @@ -338,9 +339,9 @@ class CoreServiceProvider extends ServiceProvider return; } - // DB 연결 유효성 검증 (root 사용자 접속 방지) + // DB 연결 유효성 검증 (최고권한 계정 접속 방지) if (! $this->isDatabaseConnectionValid()) { - Log::error('Database connection invalid: using root user or missing credentials. Skipping extension loading.'); + Log::error('Database connection invalid: using a privileged database account or missing credentials. Skipping extension loading.'); return; } @@ -444,30 +445,20 @@ class CoreServiceProvider extends ServiceProvider /** * 데이터베이스 연결이 유효한지 검증합니다. * - * root 사용자로 접속하거나 비밀번호가 없는 경우를 감지하여 + * DB 최고권한 계정으로 접속하거나 사용자명이 비어 있는 경우를 감지하여 * 잘못된 설정으로 인한 접속 오류를 방지합니다. + * 계정 판정은 `PrivilegedDatabaseAccounts` 가 SSoT 입니다. * * @return bool 연결이 유효하면 true */ protected function isDatabaseConnectionValid(): bool { try { - $config = DB::connection()->getConfig(); + // read/write 분리 설정의 우선순위 규칙까지 PrivilegedDatabaseAccounts 가 소유한다. + // 호출처마다 규칙이 달라지면 같은 설정에 서로 다른 판정이 나온다. + $username = PrivilegedDatabaseAccounts::resolveUsername(DB::connection()->getConfig()); - // read/write 분리 설정인 경우 read 설정 확인 - $username = $config['username'] ?? null; - - // read 설정이 배열로 있는 경우 - if (isset($config['read']['username'])) { - $username = $config['read']['username']; - } - - // root 사용자 또는 빈 username인 경우 무효 - if (empty($username) || $username === 'root') { - return false; - } - - return true; + return PrivilegedDatabaseAccounts::isUsable($username); } catch (\Throwable $e) { Log::error('Database configuration check failed: '.$e->getMessage()); diff --git a/app/Services/SettingsService.php b/app/Services/SettingsService.php index 7bbc9a72..080aa70c 100644 --- a/app/Services/SettingsService.php +++ b/app/Services/SettingsService.php @@ -8,6 +8,7 @@ use App\Contracts\Repositories\ConfigRepositoryInterface; use App\Extension\HookManager; use App\Http\Resources\AttachmentResource; use App\Support\ConfigCacheHelper; +use App\Support\OpcacheStatus; use Illuminate\Support\Facades\Artisan; use Illuminate\Support\Facades\Auth; use Illuminate\Support\Facades\DB; @@ -844,6 +845,9 @@ class SettingsService 'php_memory_limit' => $this->safeSystemProbe('php_memory_limit', fn () => ini_get('memory_limit'), __('common.unknown')), 'max_execution_time' => $this->safeSystemProbe('max_execution_time', fn () => ini_get('max_execution_time').__('settings.seconds'), __('common.unknown')), 'upload_max_filesize' => $this->safeSystemProbe('upload_max_filesize', fn () => ini_get('upload_max_filesize'), __('common.unknown')), + // 판정은 App\Support\OpcacheStatus 가 SSoT — 인스톨러 요구사항 화면과 같은 답을 낸다. + // enabled 가 null 이면 "확인 불가"(ini_get 차단 환경). + 'opcache' => $this->safeSystemProbe('opcache', fn () => $this->getOpcacheStatus(), ['loaded' => false, 'enabled' => null]), 'install_path' => base_path(), 'config_path' => storage_path('app/settings'), 'log_path' => storage_path('logs'), @@ -854,6 +858,19 @@ class SettingsService ]; } + /** + * OPcache 활성화 상태를 조회합니다. + * + * 판정은 App\Support\OpcacheStatus 가 SSoT 이며, 인스톨러 요구사항 화면과 + * 같은 답을 냅니다. `enabled` 가 null 이면 ini_get 이 차단된 "확인 불가" 상태입니다. + * + * @return array{loaded: bool, enabled: bool|null} OPcache 상태 + */ + protected function getOpcacheStatus(): array + { + return OpcacheStatus::probe(); + } + /** * 시스템 정보 probe 를 안전하게 실행합니다. * diff --git a/app/Support/OpcacheStatus.php b/app/Support/OpcacheStatus.php new file mode 100644 index 00000000..6ca33d7e --- /dev/null +++ b/app/Support/OpcacheStatus.php @@ -0,0 +1,59 @@ + extension_loaded($name); + $iniGet ??= static fn (string $key) => ini_get($key); + + if (! $extensionLoaded(self::EXTENSION_NAME)) { + return ['loaded' => false, 'enabled' => false]; + } + + try { + $raw = $iniGet(self::ENABLE_DIRECTIVE); + } catch (\Throwable) { + // ini_get 이 disable_functions 로 차단된 환경 — 확인 불가 + return ['loaded' => true, 'enabled' => null]; + } + + // ini_get 은 지시자를 못 읽으면 false 를 반환한다 (값 '0' 과 구분해야 함) + if ($raw === false || $raw === null || $raw === '') { + return ['loaded' => true, 'enabled' => null]; + } + + return ['loaded' => true, 'enabled' => filter_var($raw, FILTER_VALIDATE_BOOLEAN)]; + } +} diff --git a/app/Support/PrivilegedDatabaseAccounts.php b/app/Support/PrivilegedDatabaseAccounts.php new file mode 100644 index 00000000..03eb4d72 --- /dev/null +++ b/app/Support/PrivilegedDatabaseAccounts.php @@ -0,0 +1,90 @@ +remove(PreventRequestsDuringMaintenance::class); + // DB 자격증명 가드 (인증 불필요) — 최고권한 계정/빈 사용자명으로 인한 + // 확장 로딩 스킵을 전용 에러 페이지로 드러낸다. + // + // prepend() 는 새 항목을 기존 prepends 앞에 넣으므로, 아래 MaintenanceModePage + // prepend 가 뒤따르면 최종 순서는 [MaintenanceModePage, DatabaseCredentialGuard] 가 + // 된다. 점검 중에는 점검 페이지가 우선해야 하므로 이 호출 순서를 유지한다. + $middleware->prepend(DatabaseCredentialGuard::class); + // Maintenance 모드 전용 페이지 미들웨어 (인증 불필요, 최우선 실행) $middleware->prepend(MaintenanceModePage::class); diff --git a/lang-packs/_bundled/g7-core-ja/CHANGELOG.md b/lang-packs/_bundled/g7-core-ja/CHANGELOG.md index 0c15426f..ae1f9f6d 100644 --- a/lang-packs/_bundled/g7-core-ja/CHANGELOG.md +++ b/lang-packs/_bundled/g7-core-ja/CHANGELOG.md @@ -8,6 +8,7 @@ ### Added +- 데이터베이스 계정 설정 오류 안내 화면의 문구 일본어 번역 추가 (`database_credential.*`) — 최고 권한 계정을 사용하거나 사용자명이 비어 있을 때 표시되는 안내와 복구 방법이 일본어 로케일에서 자연스럽게 표시됩니다. - 사이트맵 생성이 실패했을 때 표시되는 안내 문구 일본어 번역 추가 (`exceptions.seo.*`) — 사이트맵 파일을 저장하지 못하거나 압축에 실패한 경우의 안내가 일본어 로케일에서 자연스럽게 표시됩니다. - 사이트맵 재생성 예약·준비 중·생성 실패 안내 문구 일본어 번역 추가 (`seo.sitemap_*`) — 재생성을 예약했을 때, 아직 준비 중일 때, 생성에 실패했을 때의 안내가 일본어 로케일에서 자연스럽게 표시됩니다. - SEO 설정의 사이트맵 분할 기준·압축·수집기 상한과 SEO/사이트맵 캐시 유지 시간 항목의 검증 안내 문구 일본어 번역 추가 (`validation.settings.*`) — 잘못된 값을 입력했을 때의 안내가 일본어 로케일에서 자연스럽게 표시됩니다. diff --git a/lang-packs/_bundled/g7-core-ja/backend/ja/database_credential.php b/lang-packs/_bundled/g7-core-ja/backend/ja/database_credential.php new file mode 100644 index 00000000..2fb617b8 --- /dev/null +++ b/lang-packs/_bundled/g7-core-ja/backend/ja/database_credential.php @@ -0,0 +1,10 @@ + 'データベースアカウント設定エラー', + 'message' => 'データベースアカウント設定に問題があり、サイトを表示できません。', + 'description' => 'この状態ではモジュール·プラグイン·テンプレートがロードされません。以下のガイドに従って設定を修正してください。', + 'blocked_reason' => 'root のようなデータベース最高権限アカウントはセキュリティ上使用できません。該当するアカウントが流出した場合、データベース全体が危険にさらされます。', + 'empty_reason' => 'データベースユーザー名が空です。設定が欠落しているか、破損している可能性があります。', + 'recovery_guide' => '.env ファイルの DB_WRITE_USERNAME 値をこのサイト専用のデータベースアカウントに変更してから、php artisan config:clear コマンドを実行してください。', +]; diff --git a/lang-packs/_bundled/g7-template-sirsoft-admin_basic-ja/CHANGELOG.md b/lang-packs/_bundled/g7-template-sirsoft-admin_basic-ja/CHANGELOG.md index cd91fbd1..8bb1553a 100644 --- a/lang-packs/_bundled/g7-template-sirsoft-admin_basic-ja/CHANGELOG.md +++ b/lang-packs/_bundled/g7-template-sirsoft-admin_basic-ja/CHANGELOG.md @@ -8,6 +8,7 @@ ### Added +- 환경설정 > 정보 화면에 추가된 OPcache 상태 항목과 비활성 안내 문구 일본어 번역 추가 — 상태 표시와 성능 저하 안내가 일본어 로케일에서도 올바르게 표시됩니다. 비활성 상태 문구는 성능 저하의 체감 정도가 드러나도록 보강했습니다. - 환경설정 > SEO 화면에 추가된 Sitemap 분할 기준(파일당 URL 수)·Sitemap 압축 항목의 이름·설명 일본어 번역 추가 — 새 항목이 일본어 로케일에서도 올바르게 표시됩니다. - 환경설정 > SEO 화면에 추가된 Sitemap 다국어 대체 링크(hreflang) 항목의 이름·설명 일본어 번역 추가 — 새 항목이 일본어 로케일에서도 올바르게 표시됩니다. - 고급 설정에 추가된 Sitemap 캐시 유지 시간 항목의 이름·설명 일본어 번역 추가 — 새 항목이 일본어 로케일에서도 올바르게 표시됩니다. diff --git a/lang-packs/_bundled/g7-template-sirsoft-admin_basic-ja/frontend/partial/admin.json b/lang-packs/_bundled/g7-template-sirsoft-admin_basic-ja/frontend/partial/admin.json index d38b1491..c88fdda8 100644 --- a/lang-packs/_bundled/g7-template-sirsoft-admin_basic-ja/frontend/partial/admin.json +++ b/lang-packs/_bundled/g7-template-sirsoft-admin_basic-ja/frontend/partial/admin.json @@ -1909,7 +1909,12 @@ "update_guide_cmd": "$ sudo php artisan core:update", "manual_update_cmd": "$ sudo php artisan core:update --source=/path/to/extracted", "upgrade_guide_link_desc": "運用環境別の権限/ユーザーグループ別の詳細な手順はアップグレードガイドを参照してください。", - "upgrade_guide_link_label": "全体アップグレードガイドを表示" + "upgrade_guide_link_label": "全体アップグレードガイドを表示", + "opcache": "OPcache", + "opcache_enabled": "有効化", + "opcache_unknown": "確認不可", + "opcache_disabled": "無効化 — ページが数倍遅くなります", + "opcache_disabled_warning": "OPcacheが無効化されています。この状態では、訪問者がページを開くたびに、サイトのすべてのPHPコードを最初から再度解釈します。同じサーバー、同じ仕様でも応答速度が数倍遅くなり、訪問者が多いほどその差は大きくなります。php.iniでopcache.enable=1を有効にした後、ウェブサーバーを再起動することを強くお勧めします。設定を変更した後でもこの画面に反映されるまで最大1時間かかる場合があります。キャッシュをクリアするを実行すると、即座に反映されます。" }, "modals": { "password_confirm_title": "パスワード確認", diff --git a/lang/en/database_credential.php b/lang/en/database_credential.php new file mode 100644 index 00000000..54fe43e9 --- /dev/null +++ b/lang/en/database_credential.php @@ -0,0 +1,10 @@ + 'Database Account Configuration Error', + 'message' => 'The site cannot be displayed because of a problem with the database account configuration.', + 'description' => 'While this problem persists, modules, plugins and templates are not loaded. Please correct the configuration using the guidance below.', + 'blocked_reason' => 'Database superuser accounts such as root cannot be used, for security reasons. If such an account is compromised, the entire database is at risk.', + 'empty_reason' => 'The database username is empty. The configuration may be missing or corrupted.', + 'recovery_guide' => 'Change DB_WRITE_USERNAME in the .env file to a database account dedicated to this site, then run: php artisan config:clear', +]; diff --git a/lang/ko/database_credential.php b/lang/ko/database_credential.php new file mode 100644 index 00000000..3c21badc --- /dev/null +++ b/lang/ko/database_credential.php @@ -0,0 +1,10 @@ + '데이터베이스 계정 설정 오류', + 'message' => '데이터베이스 계정 설정에 문제가 있어 사이트를 표시할 수 없습니다.', + 'description' => '이 상태에서는 모듈·플러그인·템플릿이 로딩되지 않습니다. 아래 안내에 따라 설정을 수정해 주세요.', + 'blocked_reason' => 'root 같은 데이터베이스 최고 권한 계정은 보안상 사용할 수 없습니다. 해당 계정이 유출되면 데이터베이스 전체가 위험해집니다.', + 'empty_reason' => '데이터베이스 사용자명이 비어 있습니다. 설정이 누락되었거나 손상되었을 수 있습니다.', + 'recovery_guide' => '.env 파일의 DB_WRITE_USERNAME 값을 이 사이트 전용 데이터베이스 계정으로 변경한 뒤, php artisan config:clear 명령을 실행해 주세요.', +]; diff --git a/public/install/api/check-configuration.php b/public/install/api/check-configuration.php index fbcc848e..4b902a72 100644 --- a/public/install/api/check-configuration.php +++ b/public/install/api/check-configuration.php @@ -69,6 +69,7 @@ class ValidationApi 'directories' => $this->checkDirectoryPermissions(), 'required_files' => $this->checkRequiredFiles(), 'https' => $this->checkHttps(), + 'opcache' => $this->checkOpcache(), ]; // 모든 필수 요구사항 통과 여부 @@ -137,6 +138,15 @@ class ValidationApi throw new Exception(lang('error_db_credentials_required')); } + // DB 최고권한 계정 차단 (Write/Read 공통). + // 최고권한 계정 자격증명이 유출되면 데이터베이스 전체가 위험해지므로 + // 연결 시도 전에 막는다. 판정은 App\Support\PrivilegedDatabaseAccounts 가 SSoT. + if (\App\Support\PrivilegedDatabaseAccounts::isBlocked($username)) { + throw new Exception( + lang('error_db_username_privileged', ['username' => $username]) + ); + } + // DB 테이블 접두사 길이 검증 (Write DB 입력에만 적용) // 접두사가 길면 자동 생성 인덱스명이 MySQL identifier 한도(64자)를 초과해 // 일부 확장 설치 시 마이그레이션이 실패하므로 연결 시도 전에 차단한다. @@ -505,6 +515,35 @@ class ValidationApi ]; } + /** + * OPcache 활성화 여부 검증 (권장 사항 — 설치를 차단하지 않음) + * + * 확장 로드 여부만으로는 부족하다. `Zend OPcache` 가 로드돼 있어도 + * `opcache.enable=0` 이면 실제로는 동작하지 않으므로 지시자까지 확인한다. + * 판정은 App\Support\OpcacheStatus 가 SSoT 이며, 코어 관리자 화면과 같은 답을 낸다. + * + * `enabled` 가 null 이면 "확인 불가"(ini_get 차단 환경)로, 경고도 차단도 하지 않는다. + */ + private function checkOpcache(): array + { + $status = \App\Support\OpcacheStatus::probe(); + + if ($status['enabled'] === null) { + $message = lang('opcache_unknown'); + } else { + $message = $status['enabled'] + ? lang('opcache_enabled') + : lang('opcache_disabled_warning'); + } + + return [ + 'required' => false, // OPcache는 선택 사항 (성능 권장) + 'loaded' => $status['loaded'], + 'enabled' => $status['enabled'], + 'message' => $message, + ]; + } + /** * 필수 PHP 함수(exec, proc_open) 비활성화 여부 검증 */ @@ -1026,7 +1065,7 @@ class ValidationApi return false; } - // HTTPS는 선택 사항이므로 검증하지 않음 + // HTTPS / OPcache 는 선택 사항이므로 검증하지 않음 (경고만 표시하고 설치는 진행) return true; } diff --git a/public/install/assets/css/installer.css b/public/install/assets/css/installer.css index e74b5e80..1622cae2 100644 --- a/public/install/assets/css/installer.css +++ b/public/install/assets/css/installer.css @@ -1816,6 +1816,54 @@ hr { margin-bottom: 0; } +/* 상태 수식자 — 아이콘만으로는 통과/경고 카드가 구분되지 않아, 목록을 훑을 때 + * 문제 항목이 눈에 들어오지 않는다. 카드 자체에 색을 실어 즉시 식별되게 한다. */ +.requirement-card--warning { + border-color: var(--warning-color); + border-left-width: 4px; + background-color: #fffbeb; +} + +.requirement-card--warning .requirement-card-header { + background: transparent; +} + +.requirement-card--warning .value-text { + color: #b45309; + font-weight: 600; +} + +.requirement-card--fail { + border-color: var(--error-color); + border-left-width: 4px; + background-color: #fef2f2; +} + +.requirement-card--fail .requirement-card-header { + background: transparent; +} + +.requirement-card--fail .value-text { + color: #b91c1c; + font-weight: 600; +} + +[data-theme="dark"] .requirement-card--warning { + background-color: rgba(245, 158, 11, 0.12); +} + +[data-theme="dark"] .requirement-card--warning .value-text { + color: #fcd34d; +} + +[data-theme="dark"] .requirement-card--fail { + background-color: rgba(239, 68, 68, 0.12); +} + +[data-theme="dark"] .requirement-card--fail .value-text { + color: #fca5a5; +} + .requirement-card-header { display: flex; justify-content: space-between; diff --git a/public/install/assets/js/installer.js b/public/install/assets/js/installer.js index f941daba..2adabe13 100644 --- a/public/install/assets/js/installer.js +++ b/public/install/assets/js/installer.js @@ -443,6 +443,31 @@ ); } + // 9. OPcache 카드 (성능 권장, 필수 아님) + // failedRequirements.push() 를 하지 않는다 — 비활성이어도 설치는 진행된다. + if (data.opcache) { + let opcacheStatusClass, opcacheStatusText; + if (data.opcache.enabled === null) { + // ini_get 이 차단된 환경 — 확인 불가 (경고도 차단도 아님) + opcacheStatusClass = 'status-warning'; + opcacheStatusText = lang('opcache_unknown'); + } else if (data.opcache.enabled) { + opcacheStatusClass = 'status-pass'; + opcacheStatusText = lang('enabled'); + } else { + // 단순히 '비활성화됨' 만 보이면 경고의 실질(성능 저하)이 전달되지 않는다. + opcacheStatusClass = 'status-warning'; + opcacheStatusText = lang('opcache_disabled_short'); + } + html += renderSingleItemCard( + lang('opcache'), + opcacheStatusClass, + opcacheStatusText, + '', + false + ); + } + html += ''; // 필수 조건 미충족 시 에러 박스 표시 @@ -710,8 +735,14 @@ const badgeText = isRequired ? lang('badge_required') : lang('badge_optional'); const badgeClass = isRequired ? 'badge-required' : 'badge-optional'; + // 상태를 아이콘에만 반영하면 통과/경고 카드가 같은 색으로 보여 경각심이 전달되지 않는다. + // 카드 자체에 수식자를 부여해 스캔만으로 문제 항목이 드러나게 한다. + const cardModifier = statusClass === 'status-warning' + ? ' requirement-card--warning' + : (statusClass === 'status-fail' ? ' requirement-card--fail' : ''); + return ` -
{{ __('database_credential.description') }}
+ + {{-- 원인 구분 안내. 현재 설정된 계정명 자체는 출력하지 않는다 --}} + {{-- (미인증 공개 페이지이므로 DB 계정명 노출은 정보 유출). --}} ++ {{ __('database_credential.'.($reason ?? 'blocked').'_reason') }} +
+ +{{ __('database_credential.recovery_guide') }}
+{children || text}
+); + +const TestIcon: React.FC<{ + name?: string; + className?: string; +}> = ({ name, className }) => ( + +); + +// 렌더러가 컴포넌트 목록을 Fragment 로 감싸므로 반드시 등록해야 한다. +// 미등록 시 트리 전체가 렌더되지 않아 "없어야 한다" 계열 단언이 거짓 통과한다. +const TestFragment: React.FC<{ children?: React.ReactNode }> = ({ children }) => <>{children}>; + +function setupTestRegistry(): ComponentRegistry { + const registry = ComponentRegistry.getInstance(); + + (registry as any).registry = { + Div: { component: TestDiv, metadata: { name: 'Div', type: 'basic' } }, + Span: { component: TestSpan, metadata: { name: 'Span', type: 'basic' } }, + P: { component: TestP, metadata: { name: 'P', type: 'basic' } }, + Icon: { component: TestIcon, metadata: { name: 'Icon', type: 'basic' } }, + Fragment: { component: TestFragment, metadata: { name: 'Fragment', type: 'layout' } }, + }; + + return registry; +} + +/** + * system-info API 응답 생성. + * + * @param opcache opcache 페이로드 (undefined 면 키 자체를 생략) + */ +function createSystemInfoResponse(opcache?: { loaded: boolean; enabled: boolean | null }) { + return { + success: true, + data: { + php_memory_limit: '512M', + max_execution_time: '30초', + ...(opcache === undefined ? {} : { opcache }), + }, + }; +} + +// _tab_info.json 의 OPcache 블록과 동일한 표현식. +// 프로덕션에서는 $t:key 로 라벨을 해석하나, 테스트 레지스트리에는 i18n 이 없으므로 +// 판정 결과 자체를 문자열 리터럴로 확인한다. +const STATUS_EXPR = + "{{systemInfo?.data?.opcache?.enabled === true ? 'enabled' " + + ": (systemInfo?.data?.opcache?.enabled === false ? 'disabled' : 'unknown')}}"; +const WARNING_IF = '{{systemInfo?.data?.opcache?.enabled === false}}'; + +const infoLayout = { + version: '1.0.0', + layout_name: 'test_admin_settings_info', + data_sources: [ + { + id: 'systemInfo', + type: 'api', + endpoint: '/api/admin/settings/system-info', + method: 'GET', + auto_fetch: true, + auth_required: true, + fallback: { data: {} }, + }, + ], + components: [ + { + id: 'card_system_specs', + type: 'basic', + name: 'Div', + children: [ + { + type: 'basic', + name: 'Div', + props: { className: 'flex-between' }, + children: [ + { + type: 'basic', + name: 'Span', + props: { className: 'text-label', 'data-testid': 'opcache-label' }, + text: 'OPcache', + }, + { + type: 'basic', + name: 'Span', + props: { className: 'text-heading', 'data-testid': 'opcache-value' }, + text: STATUS_EXPR, + }, + ], + }, + { + if: WARNING_IF, + type: 'basic', + name: 'Div', + props: { className: 'alert-warning', 'data-testid': 'opcache-warning' }, + children: [ + { + type: 'basic', + name: 'Div', + props: { className: 'flex-center gap-3' }, + children: [ + { + type: 'basic', + name: 'Icon', + props: { + name: 'triangle-exclamation', + className: 'text-xl text-amber-600 dark:text-amber-400 flex-shrink-0', + }, + }, + { + type: 'basic', + name: 'P', + props: { className: 'text-warning-soft' }, + text: 'OPcache가 비활성화되어 있습니다.', + }, + ], + }, + ], + }, + ], + }, + ], +}; + +describe('admin-settings 정보 탭 — OPcache 상태', () => { + let registry: ComponentRegistry; + + beforeEach(() => { + registry = setupTestRegistry(); + }); + + afterEach(() => { + (registry as any).registry = {}; + }); + + describe('OPcache 활성 (enabled: true)', () => { + // @scenario opcache_state=enabled, surface=admin_info_row + // @effects admin_info_row_shows_enabled_disabled_unknown + it('상태가 활성화됨으로 표시되어야 한다', async () => { + const testUtils = createLayoutTest(infoLayout); + testUtils.mockApi('systemInfo', { + response: createSystemInfoResponse({ loaded: true, enabled: true }), + }); + + await testUtils.render(); + + expect(screen.getByTestId('opcache-value').textContent).toBe('enabled'); + + testUtils.cleanup(); + }); + + it('경고 블록이 표시되지 않아야 한다', async () => { + const testUtils = createLayoutTest(infoLayout); + testUtils.mockApi('systemInfo', { + response: createSystemInfoResponse({ loaded: true, enabled: true }), + }); + + await testUtils.render(); + + // 긍정 앵커 — 트리가 실제로 렌더됐음을 먼저 확인해야 아래 부정 단언이 의미를 갖는다. + expect(screen.getByTestId('opcache-label')).toBeTruthy(); + expect(screen.queryByTestId('opcache-warning')).toBeNull(); + + testUtils.cleanup(); + }); + }); + + describe('OPcache 비활성 (enabled: false)', () => { + // @scenario opcache_state=loaded_but_disabled, surface=admin_info_row + // @effects admin_info_row_shows_enabled_disabled_unknown + it('상태가 비활성화됨으로 표시되어야 한다', async () => { + const testUtils = createLayoutTest(infoLayout); + testUtils.mockApi('systemInfo', { + response: createSystemInfoResponse({ loaded: true, enabled: false }), + }); + + await testUtils.render(); + + expect(screen.getByTestId('opcache-value').textContent).toBe('disabled'); + + testUtils.cleanup(); + }); + + // @scenario opcache_state=loaded_but_disabled, surface=admin_info_warning_block + // @effects admin_info_warning_shown_only_when_disabled + it('성능 저하 경고 블록이 표시되어야 한다', async () => { + const testUtils = createLayoutTest(infoLayout); + testUtils.mockApi('systemInfo', { + response: createSystemInfoResponse({ loaded: true, enabled: false }), + }); + + await testUtils.render(); + + const warning = screen.getByTestId('opcache-warning'); + expect(warning).toBeTruthy(); + expect(warning.className).toContain('alert-warning'); + expect(screen.getByTestId('icon-triangle-exclamation')).toBeTruthy(); + + testUtils.cleanup(); + }); + + it('확장이 로드돼 있어도 enabled=false 면 경고해야 한다', async () => { + // 확장 로드 여부만으로 판정하는 회귀 차단 (opcache.enable=0 케이스) + const testUtils = createLayoutTest(infoLayout); + testUtils.mockApi('systemInfo', { + response: createSystemInfoResponse({ loaded: true, enabled: false }), + }); + + await testUtils.render(); + + expect(screen.getByTestId('opcache-warning')).toBeTruthy(); + + testUtils.cleanup(); + }); + }); + + describe('OPcache 확인 불가 (enabled: null)', () => { + // @scenario opcache_state=ini_get_blocked, surface=admin_info_row + // @effects admin_info_row_shows_enabled_disabled_unknown + it('상태가 확인 불가로 표시되어야 한다', async () => { + const testUtils = createLayoutTest(infoLayout); + testUtils.mockApi('systemInfo', { + response: createSystemInfoResponse({ loaded: true, enabled: null }), + }); + + await testUtils.render(); + + expect(screen.getByTestId('opcache-value').textContent).toBe('unknown'); + + testUtils.cleanup(); + }); + + // @scenario opcache_state=ini_get_blocked, surface=admin_info_warning_block + // @effects admin_info_warning_hidden_when_unknown + it('경고 블록이 표시되지 않아야 한다 (확인 불가는 경고가 아니다)', async () => { + const testUtils = createLayoutTest(infoLayout); + testUtils.mockApi('systemInfo', { + response: createSystemInfoResponse({ loaded: true, enabled: null }), + }); + + await testUtils.render(); + + // 긍정 앵커 — 미렌더로 인한 거짓 통과 차단 + expect(screen.getByTestId('opcache-label')).toBeTruthy(); + expect(screen.queryByTestId('opcache-warning')).toBeNull(); + + testUtils.cleanup(); + }); + }); + + describe('opcache 키 부재 (구버전 응답 방어)', () => { + /** + * opcache 키가 아예 없는 구버전/폴백 응답에서도 화면이 깨지지 않아야 한다. + * + * @effects admin_info_defensive_against_missing_opcache_key + */ + it('상태가 확인 불가로 표시되고 경고 블록이 뜨지 않아야 한다', async () => { + const testUtils = createLayoutTest(infoLayout); + testUtils.mockApi('systemInfo', { + response: createSystemInfoResponse(undefined), + }); + + await testUtils.render(); + + expect(screen.getByTestId('opcache-value').textContent).toBe('unknown'); + expect(screen.queryByTestId('opcache-warning')).toBeNull(); + + testUtils.cleanup(); + }); + }); +}); diff --git a/templates/_bundled/sirsoft-admin_basic/__tests__/layouts/admin_dashboard.alerts.test.tsx b/templates/_bundled/sirsoft-admin_basic/__tests__/layouts/admin_dashboard.alerts.test.tsx index 0c3b46c4..0c24155c 100644 --- a/templates/_bundled/sirsoft-admin_basic/__tests__/layouts/admin_dashboard.alerts.test.tsx +++ b/templates/_bundled/sirsoft-admin_basic/__tests__/layouts/admin_dashboard.alerts.test.tsx @@ -236,9 +236,11 @@ describe('어드민 대시보드 - 시스템 알림 (incompatible_core)', () => it('dismiss 버튼 액션이 POST /api/admin/extensions/{type}/{id}/dismiss 로 정의되어 있다', () => { // JSON 구조 검증 — alert_dismiss_button 의 actions[0].target + // iteration template 안의 노드는 HTML id 유일성을 위해 `{{$idx}}` 접미가 붙는다(#421). + // 정확 일치만 보면 보간 도입 시 조용히 null 이 되므로 접미 형태도 인정한다. function findById(node: any, id: string): any | null { if (!node || typeof node !== 'object') return null; - if (node.id === id) return node; + if (node.id === id || node.id === `${id}_{{$idx}}`) return node; const keys = ['children']; for (const k of keys) { const arr = node[k]; @@ -284,9 +286,11 @@ describe('어드민 대시보드 - 시스템 알림 (incompatible_core)', () => }); it('system_alerts_card 의 if 조건이 if:false 가 아닌 dashboard_alerts.length 기반이다 (회귀)', () => { + // iteration template 안의 노드는 HTML id 유일성을 위해 `{{$idx}}` 접미가 붙는다(#421). + // 정확 일치만 보면 보간 도입 시 조용히 null 이 되므로 접미 형태도 인정한다. function findById(node: any, id: string): any | null { if (!node || typeof node !== 'object') return null; - if (node.id === id) return node; + if (node.id === id || node.id === `${id}_{{$idx}}`) return node; const arr = node.children; if (Array.isArray(arr)) { for (const c of arr) { diff --git a/templates/_bundled/sirsoft-admin_basic/__tests__/layouts/admin_dashboard.recovery.test.tsx b/templates/_bundled/sirsoft-admin_basic/__tests__/layouts/admin_dashboard.recovery.test.tsx index 745bf8cf..b4def9f0 100644 --- a/templates/_bundled/sirsoft-admin_basic/__tests__/layouts/admin_dashboard.recovery.test.tsx +++ b/templates/_bundled/sirsoft-admin_basic/__tests__/layouts/admin_dashboard.recovery.test.tsx @@ -159,10 +159,14 @@ function setupDefaultMocks(testUtils: ReturnType=0;--f)if(!m()){this.updateRangeFromParsed(c,e,g,l);break}}return c}getAllParsedValues(e){const n=this._cachedMeta._parsed,r=[];let s,o,i;for(s=0,o=n.length;s{for(c.length+=n,a=c.length-1;a>=i;a--)c[a]=c[a-n]};for(l(o),a=e;as-o))}return t._cache.$bar}function AN(t){const e=t.iScale,n=TN(e,t.type);let r=e._length,s,o,i,a;const l=()=>{i===32767||i===-32768||(fo(a)&&(r=Math.min(r,Math.abs(i-a)||r)),a=i)};for(s=0,o=n.length;si+a)))return l}function kO(t,e){at(t,n=>{const r=n.gc,s=r.length/2;let o;if(s>e){for(o=0;or?r:n,r=s&&n>r?n:r,{min:$n(n,$n(r,n)),max:$n(r,$n(n,r))}}getPadding(){return{left:this.paddingLeft||0,top:this.paddingTop||0,right:this.paddingRight||0,bottom:this.paddingBottom||0}}getTicks(){return this.ticks}getLabels(){const e=this.chart.data;return this.options.labels||(this.isHorizontal()?e.xLabels:e.yLabels)||e.labels||[]}getLabelItems(e=this.chart.chartArea){return this._labelItems||(this._labelItems=this._computeLabelItems(e))}beforeLayout(){this._cache={},this._dataLimitsCached=!1}beforeUpdate(){ht(this.options.beforeUpdate,[this])}update(e,n,r){const{beginAtZero:s,grace:o,ticks:i}=this.options,a=i.sampleSize;this.beforeUpdate(),this.maxWidth=e,this.maxHeight=n,this._margins=r=Object.assign({left:0,right:0,top:0,bottom:0},r),this.ticks=null,this._labelSizes=null,this._gridLineItems=null,this._labelItems=null,this.beforeSetDimensions(),this.setDimensions(),this.afterSetDimensions(),this._maxLength=this.isHorizontal()?this.width+r.left+r.right:this.height+r.top+r.bottom,this._dataLimitsCached||(this.beforeDataLimits(),this.determineDataLimits(),this.afterDataLimits(),this._range=qM(this,o,s),this._dataLimitsCached=!0),this.beforeBuildTicks(),this.ticks=this.buildTicks()||[],this.afterBuildTicks();const l=a{this.getDatasetMeta(n).controller.reset()},this)}reset(){this._resetElements(),this.notifyPlugins("reset")}update(e){const n=this.config;n.update();const r=this._options=n.createResolver(n.chartOptionScopes(),this.getContext()),s=this._animationsDisabled=!r.animation;if(this._updateScales(),this._checkEventBindings(),this._updateHiddenIndices(),this._plugins.invalidate(),this.notifyPlugins("beforeUpdate",{mode:e,cancelable:!0})===!1)return;const o=this.buildOrUpdateControllers();this.notifyPlugins("beforeElementsUpdate");let i=0;for(let c=0,d=this.data.datasets.length;c