HeuJung
3945b6f1b3
공개 저장소 이슈 gnuboard/g7 (@bigmsg) 제보에서 출발한 작업이다. 브라우저가 화면을 그리려고 제3자 CDN 에 도달해야 하면, 그 도달 실패는 예외도 로그도 남기지 않고 화면 기능만 조용히 사라진다. 폐쇄망·방화벽·광고차단기에서 재현되는데 자체 서버 로그에는 흔적이 없어 운영자가 원인을 특정할 수 없다. 제보된 것은 편집기 하나였지만 같은 구조가 아이콘·글꼴·코드편집기·압축 라이브러리·설치 마법사·개발 대시보드에 똑같이 있었으므로, 번들 확장과 템플릿 전체를 자체 제공으로 옮겼다. 런타임에 외부로 나가는 것은 주소 검색 서비스 하나만 남았다. 자체 제공만으로는 부족하다 — 자기 서버에서 받는 파일도 실패할 수 있고, 종전에는 그 실패가 무음이었다. CSS 경로에 재시도 계층을 세우고(스크립트 경로와 동형), 서버가 HTML 에 직접 심는 externals 까지 실패를 붙잡아 안내 배너와 [다시 시도]로 표면화했다. 편집기·코드편집기는 확보 실패 시 평문 입력으로 내려앉되 저장 계약을 유지한다. 두 번째 축은 운영자가 CSS 를 덧붙일 자리가 없던 문제다(sir.kr 문의). 확장 디렉토리의 custom/ 을 운영자 소유로 정해, 확장 교체가 그 디렉토리만은 보존하게 했다. 출처에 의존하지 않는 서술자로 해석하므로 나중에 다른 출처가 붙어도 소비자는 바뀌지 않는다. 확장 자산과 같은 메커니즘으로 정적 게시되어 CSS 내부 상대 url 도 해석되고, 파일을 고치면 그 변경을 감지해 재게시까지 예약된다. FTP 접근이 없는 운영자에게는 그 자리도 없는 것과 같으므로 레이아웃 편집기에서 직접 넣고 고칠 수 있게 했다. 모듈·플러그인·템플릿이 한 엔드포인트를 공유한다 — 타입별로 나누면 같은 검증이 세 벌로 갈리고 그중 약한 하나가 우회로가 된다. 여기서 올린 스크립트는 그 레이아웃 한 장이 아니라 사이트 전 화면에서 실행되므로 레이아웃 편집과 분리된 전용 권한으로 연다. 운영자 CSS 가 화면을 조작 불능으로 만들면 그것을 고칠 화면에도 같은 CSS 가 실려 스스로 갇히므로, 서버가 목록을 비우는 탈출구(?custom=off)를 함께 뒀다. 동봉 자산은 재생성 경로에 버전 대조 가드를 붙였다. 선언과 다른 버전을 버전 디렉토리에 써 넣는 조용한 거짓말은 배포된 뒤에는 드러나지 않는다.
421 lines
16 KiB
PHP
421 lines
16 KiB
PHP
<?php
|
|
|
|
namespace App\Http\Resources;
|
|
|
|
use App\Contracts\Repositories\ModuleRepositoryInterface;
|
|
use App\Contracts\Repositories\PluginRepositoryInterface;
|
|
use App\Services\ExtensionStaticCacheService;
|
|
use App\Support\TemplateExternals;
|
|
use Composer\Semver\Semver;
|
|
use Illuminate\Http\Request;
|
|
use Illuminate\Support\Facades\App;
|
|
|
|
/**
|
|
* 템플릿 API 리소스
|
|
*
|
|
* name, description 필드는 현재 로케일에 맞는 값을 반환합니다.
|
|
*/
|
|
class TemplateResource extends BaseApiResource
|
|
{
|
|
/**
|
|
* 템플릿 목록용 리소스를 배열로 변환합니다 (간소화된 정보).
|
|
*
|
|
* @param Request $request HTTP 요청 객체
|
|
* @return array<string, mixed> 변환된 템플릿 데이터 배열
|
|
*/
|
|
public function toArray(Request $request): array
|
|
{
|
|
return [
|
|
'identifier' => $this->getValue('identifier'),
|
|
'vendor' => $this->getValue('vendor'),
|
|
'name' => $this->getLocalizedField('name'),
|
|
'version' => $this->getValue('version'),
|
|
'type' => $this->getValue('type'),
|
|
'status' => $this->getValue('status'),
|
|
'description' => $this->getLocalizedField('description'),
|
|
'dependencies' => $this->getDependenciesSummary(),
|
|
'dependencies_met' => $this->areDependenciesMet(),
|
|
// 업데이트 관련 필드
|
|
'update_available' => $this->getValue('update_available', false),
|
|
'update_source' => $this->getValue('update_source'),
|
|
'latest_version' => $this->getValue('latest_version'),
|
|
'file_version' => $this->getValue('file_version'),
|
|
'github_url' => $this->getValue('github_url'),
|
|
'github_changelog_url' => $this->getValue('github_changelog_url'),
|
|
// pending/bundled 상태
|
|
'is_pending' => $this->getValue('is_pending', false),
|
|
'is_bundled' => $this->getValue('is_bundled', false),
|
|
// 비활성화 메타 (코어 버전 호환성)
|
|
'deactivated_reason' => $this->getDeactivatedReasonValue(),
|
|
'deactivated_at' => $this->getValue('deactivated_at'),
|
|
'incompatible_required_version' => $this->getValue('incompatible_required_version'),
|
|
...$this->resourceMeta($request),
|
|
];
|
|
}
|
|
|
|
/**
|
|
* deactivated_reason 을 항상 string|null 로 직렬화합니다.
|
|
*
|
|
* @return string|null
|
|
*/
|
|
protected function getDeactivatedReasonValue(): ?string
|
|
{
|
|
$value = $this->getValue('deactivated_reason');
|
|
|
|
if ($value instanceof \BackedEnum) {
|
|
return $value->value;
|
|
}
|
|
|
|
return $value;
|
|
}
|
|
|
|
/**
|
|
* 리소스별 권한 매핑을 반환합니다.
|
|
*
|
|
* @return array<string, string>
|
|
*/
|
|
protected function abilityMap(): array
|
|
{
|
|
return [
|
|
'can_install' => 'core.templates.install',
|
|
'can_activate' => 'core.templates.activate',
|
|
'can_uninstall' => 'core.templates.uninstall',
|
|
'can_edit_layouts' => 'core.templates.layouts.edit',
|
|
];
|
|
}
|
|
|
|
/**
|
|
* 템플릿 상세 정보를 배열로 반환합니다.
|
|
*
|
|
* @return array<string, mixed> 상세 템플릿 정보
|
|
*/
|
|
public function toDetailArray(): array
|
|
{
|
|
return [
|
|
'identifier' => $this->getValue('identifier'),
|
|
'vendor' => $this->getValue('vendor'),
|
|
'name' => $this->getLocalizedField('name'),
|
|
'version' => $this->getValue('version'),
|
|
'latest_version' => $this->getValue('latest_version'),
|
|
'update_available' => $this->getValue('update_available', false),
|
|
'update_source' => $this->getValue('update_source'),
|
|
'file_version' => $this->getValue('file_version'),
|
|
'type' => $this->getValue('type'),
|
|
'status' => $this->getValue('status'),
|
|
'description' => $this->getLocalizedField('description'),
|
|
'github_url' => $this->getValue('github_url'),
|
|
'github_changelog_url' => $this->getValue('github_changelog_url'),
|
|
'requires_core' => $this->getValue('requires_core'),
|
|
// pending/bundled 상태
|
|
'is_pending' => $this->getValue('is_pending', false),
|
|
'is_bundled' => $this->getValue('is_bundled', false),
|
|
// 비활성화 메타 (코어 버전 호환성)
|
|
'deactivated_reason' => $this->getDeactivatedReasonValue(),
|
|
'deactivated_at' => $this->getValue('deactivated_at'),
|
|
'incompatible_required_version' => $this->getValue('incompatible_required_version'),
|
|
// 상세 정보
|
|
'locales' => $this->getValue('locales', []),
|
|
'layouts_count' => $this->getValue('layouts_count', 0),
|
|
'components' => $this->getValue('components', ['basic' => [], 'composite' => []]),
|
|
'license' => $this->getValue('license'),
|
|
'metadata' => $this->getValue('metadata', []),
|
|
// 외부 리소스 (template.json externals) — 정규화 책임은 TemplateExternals 에 위임.
|
|
// `asset` 항목의 URL 해석에는 식별자와 캐시 버전이 필요하므로 뷰 컴포저
|
|
// (CollectsTemplateExternals) 와 같은 인자를 넘긴다 — 빠뜨리면 `asset` 항목이
|
|
// "식별자 미상" 으로 조용히 버려져 응답에서 사라진다.
|
|
'externals' => TemplateExternals::normalize(
|
|
$this->getValue('externals', []),
|
|
$this->getValue('identifier'),
|
|
// 트레이트를 사용하는 클래스 경유로 호출한다 — 트레이트 정적 메서드
|
|
// 직접 호출(`ClearsTemplateCaches::`)은 PHP 8.1+ E_DEPRECATED 라
|
|
// 템플릿 상세 응답마다 로그를 남긴다 (AssetUrl::staticExtBase 와 동형).
|
|
ExtensionStaticCacheService::getExtensionCacheVersion(),
|
|
),
|
|
// 의존성 상세 정보
|
|
'dependencies' => $this->getDetailedDependencies(),
|
|
// 타임스탬프
|
|
'created_at' => $this->getValue('created_at'),
|
|
'updated_at' => $this->getValue('updated_at'),
|
|
];
|
|
}
|
|
|
|
/**
|
|
* 마켓플레이스용 간단한 형태의 배열을 반환합니다.
|
|
*
|
|
* @return array<string, mixed> 마켓플레이스용 템플릿 정보
|
|
*/
|
|
public function toMarketplaceArray(): array
|
|
{
|
|
return [
|
|
'identifier' => $this->getValue('identifier'),
|
|
'name' => $this->getLocalizedField('name'),
|
|
'version' => $this->getValue('version'),
|
|
'type' => $this->getValue('type'),
|
|
'status' => $this->getValue('status'),
|
|
'description' => $this->getLocalizedField('description'),
|
|
];
|
|
}
|
|
|
|
/**
|
|
* 의존성 체크용 간단한 형태의 배열을 반환합니다.
|
|
*
|
|
* @return array<string, mixed> 의존성 확인용 템플릿 정보
|
|
*/
|
|
public function toDependencyArray(): array
|
|
{
|
|
return [
|
|
'identifier' => $this->getValue('identifier'),
|
|
'name' => $this->getLocalizedField('name'),
|
|
'version' => $this->getValue('version'),
|
|
'type' => $this->getValue('type'),
|
|
'status' => $this->getValue('status'),
|
|
];
|
|
}
|
|
|
|
/**
|
|
* 다국어 필드 값을 현재 로케일에 맞게 반환합니다.
|
|
*
|
|
* @param string $field 필드명
|
|
* @return string|array|null 다국어 값
|
|
*/
|
|
protected function getLocalizedField(string $field)
|
|
{
|
|
$value = $this->getValue($field);
|
|
|
|
if ($value === null) {
|
|
return null;
|
|
}
|
|
|
|
// 이미 문자열이면 그대로 반환
|
|
if (is_string($value)) {
|
|
return $value;
|
|
}
|
|
|
|
// 배열(다국어)이면 현재 로케일에 맞는 값 반환
|
|
if (is_array($value)) {
|
|
$locale = App::getLocale();
|
|
$fallbackLocale = config('app.fallback_locale', 'ko');
|
|
|
|
return $value[$locale] ?? $value[$fallbackLocale] ?? reset($value) ?: null;
|
|
}
|
|
|
|
// Model의 getLocalizedName() 등의 메서드가 있으면 사용
|
|
$methodName = 'getLocalized'.ucfirst($field);
|
|
if (is_object($this->resource) && method_exists($this->resource, $methodName)) {
|
|
return $this->resource->{$methodName}();
|
|
}
|
|
|
|
return $value;
|
|
}
|
|
|
|
/**
|
|
* 의존성 요약 정보를 반환합니다 (목록용).
|
|
*
|
|
* @return array 의존성 목록 ['modules' => [...], 'plugins' => [...]]
|
|
*/
|
|
protected function getDependenciesSummary(): array
|
|
{
|
|
$dependencies = $this->getValue('dependencies', []);
|
|
|
|
$moduleRepository = app(ModuleRepositoryInterface::class);
|
|
$pluginRepository = app(PluginRepositoryInterface::class);
|
|
|
|
$modules = [];
|
|
$plugins = [];
|
|
|
|
// 모듈 의존성 정보 추출 (identifier + name + type)
|
|
if (isset($dependencies['modules']) && is_array($dependencies['modules'])) {
|
|
foreach ($dependencies['modules'] as $moduleIdentifier => $versionConstraint) {
|
|
$module = $moduleRepository->findByIdentifier($moduleIdentifier);
|
|
$modules[] = [
|
|
'identifier' => $moduleIdentifier,
|
|
'name' => $module ? $this->getExtensionName($module) : $moduleIdentifier,
|
|
'type' => 'module',
|
|
];
|
|
}
|
|
}
|
|
|
|
// 플러그인 의존성 정보 추출 (identifier + name + type)
|
|
if (isset($dependencies['plugins']) && is_array($dependencies['plugins'])) {
|
|
foreach ($dependencies['plugins'] as $pluginIdentifier => $versionConstraint) {
|
|
$plugin = $pluginRepository->findByIdentifier($pluginIdentifier);
|
|
$plugins[] = [
|
|
'identifier' => $pluginIdentifier,
|
|
'name' => $plugin ? $this->getExtensionName($plugin) : $pluginIdentifier,
|
|
'type' => 'plugin',
|
|
];
|
|
}
|
|
}
|
|
|
|
return [
|
|
'modules' => $modules,
|
|
'plugins' => $plugins,
|
|
];
|
|
}
|
|
|
|
/**
|
|
* 모든 의존성이 충족되었는지 확인합니다.
|
|
*
|
|
* @return bool 모든 의존성 충족 여부
|
|
*/
|
|
protected function areDependenciesMet(): bool
|
|
{
|
|
$dependencies = $this->getValue('dependencies', []);
|
|
|
|
// 의존성이 없으면 충족으로 간주
|
|
if (empty($dependencies)) {
|
|
return true;
|
|
}
|
|
|
|
$moduleRepository = app(ModuleRepositoryInterface::class);
|
|
$pluginRepository = app(PluginRepositoryInterface::class);
|
|
|
|
// 모듈 의존성 확인
|
|
if (isset($dependencies['modules']) && is_array($dependencies['modules'])) {
|
|
foreach ($dependencies['modules'] as $moduleIdentifier => $versionConstraint) {
|
|
$module = $moduleRepository->findActiveByIdentifier($moduleIdentifier);
|
|
if (! $module) {
|
|
return false;
|
|
}
|
|
|
|
// 버전 체크
|
|
if (! $this->checkVersionConstraint($module->version, $versionConstraint)) {
|
|
return false;
|
|
}
|
|
}
|
|
}
|
|
|
|
// 플러그인 의존성 확인
|
|
if (isset($dependencies['plugins']) && is_array($dependencies['plugins'])) {
|
|
foreach ($dependencies['plugins'] as $pluginIdentifier => $versionConstraint) {
|
|
$plugin = $pluginRepository->findActiveByIdentifier($pluginIdentifier);
|
|
if (! $plugin) {
|
|
return false;
|
|
}
|
|
|
|
// 버전 체크
|
|
if (! $this->checkVersionConstraint($plugin->version, $versionConstraint)) {
|
|
return false;
|
|
}
|
|
}
|
|
}
|
|
|
|
return true;
|
|
}
|
|
|
|
/**
|
|
* 상세 의존성 정보를 반환합니다 (상세 모달용).
|
|
*
|
|
* @return array{modules: array, plugins: array} 상세 의존성 정보
|
|
*/
|
|
protected function getDetailedDependencies(): array
|
|
{
|
|
$dependencies = $this->getValue('dependencies', []);
|
|
|
|
$moduleRepository = app(ModuleRepositoryInterface::class);
|
|
$pluginRepository = app(PluginRepositoryInterface::class);
|
|
|
|
$moduleDeps = [];
|
|
$pluginDeps = [];
|
|
|
|
// 모듈 의존성 상세 정보
|
|
if (isset($dependencies['modules']) && is_array($dependencies['modules'])) {
|
|
foreach ($dependencies['modules'] as $moduleIdentifier => $versionConstraint) {
|
|
$module = $moduleRepository->findByIdentifier($moduleIdentifier);
|
|
$activeModule = $moduleRepository->findActiveByIdentifier($moduleIdentifier);
|
|
|
|
$installedVersion = $module?->version;
|
|
$isActive = (bool) $activeModule;
|
|
$isMet = $isActive && $installedVersion && $this->checkVersionConstraint($installedVersion, $versionConstraint);
|
|
|
|
$moduleDeps[] = [
|
|
'identifier' => $moduleIdentifier,
|
|
'name' => $this->getExtensionName($module),
|
|
'required_version' => $versionConstraint,
|
|
'installed_version' => $installedVersion,
|
|
'is_active' => $isActive,
|
|
'is_met' => $isMet,
|
|
];
|
|
}
|
|
}
|
|
|
|
// 플러그인 의존성 상세 정보
|
|
if (isset($dependencies['plugins']) && is_array($dependencies['plugins'])) {
|
|
foreach ($dependencies['plugins'] as $pluginIdentifier => $versionConstraint) {
|
|
$plugin = $pluginRepository->findByIdentifier($pluginIdentifier);
|
|
$activePlugin = $pluginRepository->findActiveByIdentifier($pluginIdentifier);
|
|
|
|
$installedVersion = $plugin?->version;
|
|
$isActive = (bool) $activePlugin;
|
|
$isMet = $isActive && $installedVersion && $this->checkVersionConstraint($installedVersion, $versionConstraint);
|
|
|
|
$pluginDeps[] = [
|
|
'identifier' => $pluginIdentifier,
|
|
'name' => $this->getExtensionName($plugin),
|
|
'required_version' => $versionConstraint,
|
|
'installed_version' => $installedVersion,
|
|
'is_active' => $isActive,
|
|
'is_met' => $isMet,
|
|
];
|
|
}
|
|
}
|
|
|
|
return [
|
|
'modules' => $moduleDeps,
|
|
'plugins' => $pluginDeps,
|
|
];
|
|
}
|
|
|
|
/**
|
|
* 버전 제약조건을 검증합니다.
|
|
*
|
|
* @param string $installedVersion 설치된 버전
|
|
* @param string $versionConstraint 요구 버전 제약조건 (예: '>=1.0.0', '^2.0', '~1.2.3')
|
|
* @return bool 제약조건 충족 여부
|
|
*/
|
|
protected function checkVersionConstraint(string $installedVersion, string $versionConstraint): bool
|
|
{
|
|
try {
|
|
return Semver::satisfies($installedVersion, $versionConstraint);
|
|
} catch (\Exception $e) {
|
|
return false;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 확장(모듈/플러그인)의 다국어 이름을 반환합니다.
|
|
*
|
|
* @param object|null $extension 확장 모델
|
|
* @return string|null 다국어 이름
|
|
*/
|
|
protected function getExtensionName(?object $extension): ?string
|
|
{
|
|
if (! $extension) {
|
|
return null;
|
|
}
|
|
|
|
$name = $extension->name;
|
|
|
|
// 다국어 배열인 경우
|
|
if (is_array($name)) {
|
|
$locale = App::getLocale();
|
|
$fallbackLocale = config('app.fallback_locale', 'ko');
|
|
|
|
return $name[$locale] ?? $name[$fallbackLocale] ?? reset($name) ?: null;
|
|
}
|
|
|
|
// JSON 문자열인 경우
|
|
if (is_string($name) && str_starts_with($name, '{')) {
|
|
$decoded = json_decode($name, true);
|
|
if (is_array($decoded)) {
|
|
$locale = App::getLocale();
|
|
$fallbackLocale = config('app.fallback_locale', 'ko');
|
|
|
|
return $decoded[$locale] ?? $decoded[$fallbackLocale] ?? reset($decoded) ?: null;
|
|
}
|
|
}
|
|
|
|
return $name;
|
|
}
|
|
}
|