HeuJung
e426498fb3
파일 목록과 선택한 파일의 설명에 `$t:…` / `{{ … }}` 가 그대로 보였다.
설명 원문은 소유 템플릿의 다국어 키인데 응답 조립 시점에는 요청 템플릿의
사전만 열려 있어 다른 템플릿의 레이아웃을 편집하면 키를 찾지 못했다.
번역 실패가 예외 없이 원문 노출로 이어져 화면에만 나타났다.
목록·상세가 같은 규칙을 쓰도록 표시 해석을 App\Support\LayoutDescription 으로
모으고, 컨트롤러가 소유 템플릿 사전을 주입한다. 표현식이 섞인 설명과 번역을
찾지 못한 경우는 파일 이름으로 대체한다.
목록만 고치면 상세 헤더에 그대로 남는다 — 브라우저 실측에서 목록 수정 후에도
헤더가 새던 것을 확인해 상세 경로(LayoutResource)까지 함께 처리했다.
131 lines
4.6 KiB
PHP
131 lines
4.6 KiB
PHP
<?php
|
|
|
|
namespace App\Http\Resources;
|
|
|
|
use App\Support\LayoutDescription;
|
|
use Carbon\Carbon;
|
|
use Illuminate\Http\Request;
|
|
|
|
/**
|
|
* 레이아웃 **목록** 전용 리소스
|
|
*
|
|
* 코드 편집 화면의 파일 목록은 행마다 이름·설명·라우트·크기·수정일·업데이트 표시만 쓴다.
|
|
* 편집 대상 본문은 선택 시 상세 엔드포인트(`current_layout`)가 따로 받아온다.
|
|
*
|
|
* 종전에는 목록·상세가 {@see LayoutResource} 하나를 공용해 목록 응답에도 각 레이아웃의
|
|
* `content`(본문 전체) · `components` · `data_sources` · `metadata` 가 실렸다.
|
|
* 실측(sirsoft-admin_basic): 응답 18.30MB 중 `content` 가 17.41MB(95%). 화면은 102개 중
|
|
* 1개 본문만 필요한데 101개를 더 받아 전역 상태에 상주시켰고, 디버그 모드에서는 그 상태를
|
|
* 추적하다 렌더러가 메모리 한계를 넘었다.
|
|
*
|
|
* 본문에서 파생되는 값(`description` · `size`)은 조회 계층이 미리 계산해 넘긴다 —
|
|
* 이 리소스는 본문을 보지 않는다.
|
|
*
|
|
* @since 7.0.6
|
|
*/
|
|
class LayoutListResource extends BaseApiResource
|
|
{
|
|
/** @var array<string, string|null> 레이아웃 이름 → 라우트 path 매핑 */
|
|
private array $routePathMap = [];
|
|
|
|
/** @var array<string, mixed> 소유 템플릿의 프론트엔드 다국어 사전 (점 표기 중첩) */
|
|
private array $translations = [];
|
|
|
|
/**
|
|
* 라우트 path 매핑을 주입합니다.
|
|
*
|
|
* @param array<string, string|null> $routePathMap 레이아웃 이름 → 라우트 path
|
|
* @return $this
|
|
*/
|
|
public function withRoutePathMap(array $routePathMap): self
|
|
{
|
|
$this->routePathMap = $routePathMap;
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* 설명 해석에 쓸 소유 템플릿 사전을 주입합니다.
|
|
*
|
|
* @param array $translations 템플릿 프론트엔드 다국어 데이터
|
|
* @return $this
|
|
*/
|
|
public function withTranslations(array $translations): self
|
|
{
|
|
$this->translations = $translations;
|
|
|
|
return $this;
|
|
}
|
|
|
|
/**
|
|
* 목록 행을 배열로 변환합니다.
|
|
*
|
|
* @param Request $request 요청 객체
|
|
* @return array 목록 행 데이터
|
|
*/
|
|
public function toArray(Request $request): array
|
|
{
|
|
$name = $this->getValue('name');
|
|
$size = (int) $this->getValue('size', 0);
|
|
|
|
return [
|
|
'id' => $this->getValue('id'),
|
|
'template_id' => $this->getValue('template_id'),
|
|
'name' => $name,
|
|
'description' => LayoutDescription::resolve($this->getValue('description'), $name, $this->translations),
|
|
|
|
// 이 레이아웃을 사용하는 라우트의 path (routes.json 기준). 파일 선택 시 ?route=
|
|
// 동기화 / 위지윅에서 넘어온 ?route= 로 해당 파일 복원에 사용.
|
|
'route_path' => $this->routePathMap[$name] ?? null,
|
|
|
|
'size' => $size,
|
|
'size_formatted' => $this->formatFileSize($size),
|
|
'has_update' => false,
|
|
|
|
// 낙관적 잠금 — 편집 진입 후 저장 요청에 expected_lock_version 으로 전달
|
|
'lock_version' => (int) $this->getValue('lock_version', 0),
|
|
|
|
// 상세 응답(LayoutResource)의 formatTimestamps() 와 같은 규약 — 사용자 timezone
|
|
// 기준 문자열이다. 원시 ISO 를 그대로 내보내면 목록의 수정일 표기만 형식이 달라진다.
|
|
'created_at' => $this->formatDateTimeStringForUser($this->toCarbon($this->getValue('created_at'))),
|
|
'updated_at' => $this->formatDateTimeStringForUser($this->toCarbon($this->getValue('updated_at'))),
|
|
];
|
|
}
|
|
|
|
/**
|
|
* 값을 Carbon 인스턴스로 변환합니다.
|
|
*
|
|
* 경량 조회는 배열 행을 넘기므로 값이 Carbon 일 수도, 문자열일 수도, null 일 수도 있다.
|
|
*
|
|
* @param mixed $value 변환할 값
|
|
* @return Carbon|null 변환된 Carbon 또는 null
|
|
*/
|
|
private function toCarbon(mixed $value): ?Carbon
|
|
{
|
|
if ($value === null || $value === '') {
|
|
return null;
|
|
}
|
|
|
|
return $value instanceof Carbon ? $value : Carbon::parse($value);
|
|
}
|
|
|
|
/**
|
|
* 파일 크기를 사람이 읽는 단위로 변환합니다.
|
|
*
|
|
* @param int $bytes 바이트 수
|
|
* @return string 변환된 크기 문자열
|
|
*/
|
|
private function formatFileSize(int $bytes): string
|
|
{
|
|
if ($bytes < 1024) {
|
|
return $bytes.' B';
|
|
}
|
|
|
|
if ($bytes < 1048576) {
|
|
return round($bytes / 1024, 1).' KB';
|
|
}
|
|
|
|
return round($bytes / 1048576, 1).' MB';
|
|
}
|
|
}
|