v7.0.0 release
This commit is contained in:
1 parent
0e7fa04b03
commit
c4ea9a6cd1
3582 files changed
+626189
-160151
No files matched your search
@@ -0,0 +1,94 @@
|
||||
<?php
|
||||
|
||||
namespace App\Services\LanguagePack;
|
||||
|
||||
/**
|
||||
* 레이아웃 콘텐츠에서 참조되는 커스텀 다국어 키 스캐너.
|
||||
*
|
||||
* 레이아웃 content(JSON 디코드 배열)를 깊이 우선으로 순회하며 모든 문자열
|
||||
* 값에서 `$t:custom.{layout}.{seq}` 형태로 참조되는 커스텀 키를 수집합니다.
|
||||
* 노드의 `text` 뿐 아니라 props 값·표현식 내 `$t:custom.` 문자열도 보수적으로
|
||||
* 전부 스캔합니다(인라인 편집은 `text` 에만 쓰지만, 코드 편집기 경유 props/표현식
|
||||
* 참조도 보존 — 과소 orphaned 방지).
|
||||
*
|
||||
* DB 무접근 순수 함수이므로 단위 테스트가 용이합니다. 좀비(고아) 키 자동 감지
|
||||
* 리스너(MarkOrphanedCustomTranslations)가 본 스캐너로 "사용 중" 키 집합을 얻어
|
||||
* 미참조 키를 orphaned 로 전이시킵니다.
|
||||
*
|
||||
* @since engine-v1.54.0
|
||||
*/
|
||||
class CustomTranslationUsageScanner
|
||||
{
|
||||
/**
|
||||
* `$t:custom.{layoutKey}.{seq}` 매칭 정규식.
|
||||
*
|
||||
* - layoutKey: 영숫자/언더스코어/하이픈 (normalizeLayoutKey 출력과 동형)
|
||||
* - seq: 숫자
|
||||
*/
|
||||
private const CUSTOM_KEY_RE = '/\$t:(custom\.[A-Za-z0-9_\-]+\.\d+)/';
|
||||
|
||||
/**
|
||||
* 레이아웃 content 에서 참조되는 커스텀 키 목록을 수집합니다.
|
||||
*
|
||||
* @param mixed $content 레이아웃 content (배열/객체/문자열 — 보수적으로 전체 순회)
|
||||
* @return array<int, string> 참조된 커스텀 키 목록 (중복 제거, 예: ['custom.home.1'])
|
||||
*/
|
||||
public function collectReferencedKeys(mixed $content): array
|
||||
{
|
||||
$keys = [];
|
||||
$this->walk($content, $keys);
|
||||
|
||||
return array_values(array_unique($keys));
|
||||
}
|
||||
|
||||
/**
|
||||
* 레이아웃 이름을 키 네임스페이스로 정규화합니다 (커스텀 키 생성/매칭 SSoT).
|
||||
*
|
||||
* `board/list` → `board_list`. 슬래시/공백을 언더스코어로 치환하고
|
||||
* 키에 안전한 문자만 남깁니다. 키 저장(TemplateCustomTranslationService::createKey)과
|
||||
* 스캐너의 layoutKey 추출이 동일 정규화를 공유하도록 단일 SSoT 로 둡니다.
|
||||
*
|
||||
* @param string $layoutName 레이아웃 이름
|
||||
* @return string 정규화된 키 네임스페이스
|
||||
*/
|
||||
public static function normalizeLayoutKey(string $layoutName): string
|
||||
{
|
||||
$normalized = preg_replace('/[\/\s]+/', '_', trim($layoutName));
|
||||
$normalized = preg_replace('/[^A-Za-z0-9_\-]/', '', (string) $normalized);
|
||||
|
||||
return $normalized === '' ? 'layout' : $normalized;
|
||||
}
|
||||
|
||||
/**
|
||||
* 값을 깊이 우선 순회하며 문자열에서 커스텀 키를 누적합니다.
|
||||
*
|
||||
* @param mixed $value 순회 대상 값
|
||||
* @param array<int, string> $keys 누적 키 (참조 전달)
|
||||
*/
|
||||
private function walk(mixed $value, array &$keys): void
|
||||
{
|
||||
if (is_string($value)) {
|
||||
if (str_contains($value, '$t:custom.') && preg_match_all(self::CUSTOM_KEY_RE, $value, $matches)) {
|
||||
foreach ($matches[1] as $key) {
|
||||
$keys[] = $key;
|
||||
}
|
||||
}
|
||||
|
||||
return;
|
||||
}
|
||||
|
||||
if (is_array($value)) {
|
||||
foreach ($value as $item) {
|
||||
$this->walk($item, $keys);
|
||||
}
|
||||
|
||||
return;
|
||||
}
|
||||
|
||||
if (is_object($value)) {
|
||||
foreach (get_object_vars($value) as $item) {
|
||||
$this->walk($item, $keys);
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
Reference in new issue
Block a user