fix(core): 라우트 캐시 상태에서 DevTools 덤프·브라우저 로그 수집 복구
route:cache 가 걸리면 RouteServiceProvider 가 캐시 로드로 분기해 라우트 파일이 실행되지 않는다. routes/devtools.php 는 전역 함수 5개를 정의하고 핸들러가 호출했고, boost 의 browser-logs 는 프로바이더 boot 등록분이라 setCompiledRoutes 교체로 폐기됐다. 7.0.6 의 RouteCacheHelper 가 12개 라이프사이클 지점에서 캐시를 자동 생성하면서, 확장을 한 번이라도 건드린 사이트에서 항상 재현됐다. 로직을 오토로드되는 App\Support\DevTools\* 로 옮기고 browser-logs URI 를 G7 가 직접 소유해 캐시에 함께 구워지게 했다. 게이트가 참조하던 App\Models\Setting 은 저장소에 없는 유물이라 ConfigRepositoryInterface 로 교체했다. 같은 부류의 재발은 정적 검사(route-file-local-function)로 차단하고, 재현이 in-process 로 불가능하므로 서브프로세스 하네스로 회귀를 고정했다.
This commit is contained in:
HeuJung
@@ -0,0 +1,284 @@
|
||||
<?php
|
||||
|
||||
namespace App\Support\DevTools;
|
||||
|
||||
use Illuminate\Http\JsonResponse;
|
||||
use Illuminate\Http\Request;
|
||||
use Illuminate\Support\Facades\File;
|
||||
|
||||
/**
|
||||
* G7 DevTools 상태 덤프 기록기.
|
||||
*
|
||||
* 브라우저가 전송한 디버깅 데이터를 `storage/debug-dump/` 아래 섹션별 파일로 저장한다.
|
||||
* 전송 모드는 세 가지이며 저장 결과(파일명·이력 규칙)는 모두 동일하다.
|
||||
*
|
||||
* - bulk 소용량: 모든 섹션이 단일 요청의 `sections` 배열에 담겨 온다
|
||||
* - sectional 대용량: 섹션 → 청크 단위로 쪼개 여러 요청에 나눠 온다
|
||||
* - legacy 하위 호환: 섹션명이 요청의 최상위 키로 온다
|
||||
*
|
||||
* 왜 라우트 파일이 아니라 클래스인가:
|
||||
* 원래 이 로직은 `routes/devtools.php` 안의 전역 함수 5개였다. `route:cache` 가 걸리면
|
||||
* `RouteServiceProvider::boot()` 이 `loadCachedRoutes()` 로 분기해 **라우트 파일 자체가
|
||||
* 로드되지 않는다**. 클로저는 `SerializableClosure` 로 복원되지만 전역 함수는 오토로드
|
||||
* 대상이 아니라 정의되지 않아, 핸들러가 호출하는 즉시 `Call to undefined function` 500 이
|
||||
* 된다. 클래스로 옮겨야 오토로더가 캐시 여부와 무관하게 심볼을 찾아준다.
|
||||
*
|
||||
* 왜 `app/Http/Controllers/` 가 아닌가:
|
||||
* 코어 컨트롤러는 API 레퍼런스 문서(`docs/backend/api/**`) 동반이 강제된다. 이 엔드포인트는
|
||||
* 디버그 모드 전용 개발 도구라 공개 API 표면이 아니므로, 문서 의무가 붙는 위치를 피해
|
||||
* `app/Support/` 하위 도메인 디렉토리에 둔다 (`ApiDoc/`, `Query/`, `Routing/` 과 동일 관례).
|
||||
*
|
||||
* 응답 스키마는 MCP 도구와 브라우저 클라이언트가 의존하므로 변경하지 않는다.
|
||||
*/
|
||||
class DebugDumpWriter
|
||||
{
|
||||
/**
|
||||
* 섹션명 → 저장 파일명 매핑 (SSoT).
|
||||
*
|
||||
* 세 전송 모드가 모두 이 표 하나만 본다. 과거에는 같은 29행이 세 곳에 복제되어 있어
|
||||
* 섹션 하나를 추가할 때 세 곳을 모두 고쳐야 했다.
|
||||
*
|
||||
* @var array<string, string>
|
||||
*/
|
||||
public const SECTION_FILES = [
|
||||
'state' => 'state-latest.json',
|
||||
'actions' => 'actions-latest.json',
|
||||
'cache' => 'cache-latest.json',
|
||||
'lifecycle' => 'lifecycle-latest.json',
|
||||
'network' => 'network-latest.json',
|
||||
'expressions' => 'expressions-latest.json',
|
||||
'forms' => 'form-latest.json',
|
||||
'performance' => 'performance-latest.json',
|
||||
'conditionals' => 'conditionals-latest.json',
|
||||
'dataSources' => 'datasources-latest.json',
|
||||
'handlers' => 'handlers-latest.json',
|
||||
'componentEvents' => 'component-events-latest.json',
|
||||
'stateRendering' => 'state-rendering-latest.json',
|
||||
'stateHierarchy' => 'state-hierarchy-latest.json',
|
||||
'contextFlow' => 'context-flow-latest.json',
|
||||
'styleValidation' => 'style-validation-latest.json',
|
||||
'authDebug' => 'auth-debug-latest.json',
|
||||
'logs' => 'logs-latest.json',
|
||||
'layout' => 'layout-latest.json',
|
||||
'changeDetection' => 'change-detection-latest.json',
|
||||
'sequenceTracking' => 'sequence-latest.json',
|
||||
'staleClosureTracking' => 'stale-closure-latest.json',
|
||||
'cacheDecisionTracking' => 'cache-decisions-latest.json',
|
||||
'dataPathTransformTracking' => 'data-path-transform-latest.json',
|
||||
'nestedContextTracking' => 'nested-context-latest.json',
|
||||
'formBindingValidationTracking' => 'form-binding-validation-latest.json',
|
||||
'computedDependencyTracking' => 'computed-dependency-latest.json',
|
||||
'modalStateScopeTracking' => 'modal-state-scope-latest.json',
|
||||
'namedActionTracking' => 'named-action-tracking-latest.json',
|
||||
];
|
||||
|
||||
/** 이력 파일(`state-{timestamp}.json`)을 남기는 섹션 */
|
||||
private const HISTORY_SECTION = 'state';
|
||||
|
||||
/** 오래된 세션 디렉토리 정리 기준 (초) */
|
||||
private const SESSION_TTL_SECONDS = 600;
|
||||
|
||||
/** JSON 저장 공통 플래그 */
|
||||
private const JSON_FLAGS = JSON_PRETTY_PRINT | JSON_UNESCAPED_UNICODE;
|
||||
|
||||
/**
|
||||
* 섹션별 청크 분할 전송을 처리합니다 (대용량 데이터).
|
||||
*
|
||||
* @param Request $request 덤프 요청
|
||||
* @param string $debugDir 최종 저장 디렉토리
|
||||
* @param string $sessionsDir 청크 임시 디렉토리
|
||||
* @return JsonResponse 처리 결과
|
||||
*/
|
||||
public static function handleSectional(Request $request, string $debugDir, string $sessionsDir): JsonResponse
|
||||
{
|
||||
$sessionId = $request->input('sessionId');
|
||||
$sectionName = $request->input('sectionName');
|
||||
$chunkData = $request->input('chunkData');
|
||||
$chunkIndex = (int) $request->input('chunkIndex', 0);
|
||||
$totalChunks = (int) $request->input('totalChunks', 1);
|
||||
$isLastChunk = $request->boolean('isLastChunk');
|
||||
$isLastSection = $request->boolean('isLastSection');
|
||||
$timestamp = $request->input('timestamp');
|
||||
$saveHistory = $request->boolean('saveHistory');
|
||||
|
||||
// 세션 디렉토리 생성
|
||||
$sessionDir = $sessionsDir.'/'.$sessionId;
|
||||
if (! File::isDirectory($sessionDir)) {
|
||||
File::makeDirectory($sessionDir, 0755, true);
|
||||
}
|
||||
|
||||
// 청크를 임시 파일에 저장
|
||||
File::put($sessionDir.'/'.$sectionName.'.chunk.'.$chunkIndex, $chunkData);
|
||||
|
||||
// 해당 섹션의 마지막 청크이면 모든 청크를 병합
|
||||
if ($isLastChunk) {
|
||||
$mergedData = '';
|
||||
for ($i = 0; $i < $totalChunks; $i++) {
|
||||
$chunkPath = $sessionDir.'/'.$sectionName.'.chunk.'.$i;
|
||||
if (File::exists($chunkPath)) {
|
||||
$mergedData .= File::get($chunkPath);
|
||||
File::delete($chunkPath);
|
||||
}
|
||||
}
|
||||
|
||||
File::put($sessionDir.'/'.$sectionName.'.json', $mergedData);
|
||||
}
|
||||
|
||||
// 전체 덤프의 마지막 섹션이면 최종 파일 생성 후 세션 정리
|
||||
if ($isLastSection) {
|
||||
self::mergeSectionsToFinalFiles($sessionDir, $debugDir, $saveHistory, $timestamp);
|
||||
|
||||
File::deleteDirectory($sessionDir);
|
||||
self::cleanupOldSessions($sessionsDir);
|
||||
}
|
||||
|
||||
return response()->json([
|
||||
'status' => 'success',
|
||||
'sessionId' => $sessionId,
|
||||
'sectionName' => $sectionName,
|
||||
'chunkIndex' => $chunkIndex,
|
||||
'totalChunks' => $totalChunks,
|
||||
'isLastSection' => $isLastSection,
|
||||
]);
|
||||
}
|
||||
|
||||
/**
|
||||
* 일괄 전송을 처리합니다 (소용량 데이터).
|
||||
*
|
||||
* @param Request $request 덤프 요청
|
||||
* @param string $debugDir 최종 저장 디렉토리
|
||||
* @return JsonResponse 처리 결과
|
||||
*/
|
||||
public static function handleBulk(Request $request, string $debugDir): JsonResponse
|
||||
{
|
||||
$sections = $request->input('sections', []);
|
||||
$saveHistory = $request->boolean('saveHistory');
|
||||
$timestampStr = self::formatTimestamp($request->input('timestamp'));
|
||||
|
||||
$savedSections = [];
|
||||
|
||||
foreach ((array) $sections as $sectionName => $sectionData) {
|
||||
if (! isset(self::SECTION_FILES[$sectionName])) {
|
||||
continue;
|
||||
}
|
||||
|
||||
$json = json_encode($sectionData, self::JSON_FLAGS);
|
||||
File::put($debugDir.'/'.self::SECTION_FILES[$sectionName], $json);
|
||||
$savedSections[] = $sectionName;
|
||||
|
||||
if ($saveHistory && $sectionName === self::HISTORY_SECTION) {
|
||||
File::put($debugDir."/state-{$timestampStr}.json", $json);
|
||||
}
|
||||
}
|
||||
|
||||
return response()->json([
|
||||
'status' => 'success',
|
||||
'mode' => 'bulk',
|
||||
'savedSections' => $savedSections,
|
||||
'timestamp' => $timestampStr,
|
||||
]);
|
||||
}
|
||||
|
||||
/**
|
||||
* 레거시 전체 전송을 처리합니다 (하위 호환성 — 섹션명이 요청 최상위 키).
|
||||
*
|
||||
* @param Request $request 덤프 요청
|
||||
* @param string $debugDir 최종 저장 디렉토리
|
||||
* @return JsonResponse 처리 결과
|
||||
*/
|
||||
public static function handleLegacy(Request $request, string $debugDir): JsonResponse
|
||||
{
|
||||
$timestamp = now()->format('Ymd_His');
|
||||
$saveHistory = $request->boolean('saveHistory');
|
||||
|
||||
foreach (self::SECTION_FILES as $sectionName => $fileName) {
|
||||
if (! $request->has($sectionName)) {
|
||||
continue;
|
||||
}
|
||||
|
||||
$json = json_encode($request->input($sectionName), self::JSON_FLAGS);
|
||||
File::put($debugDir.'/'.$fileName, $json);
|
||||
|
||||
if ($saveHistory && $sectionName === self::HISTORY_SECTION) {
|
||||
File::put($debugDir."/state-{$timestamp}.json", $json);
|
||||
}
|
||||
}
|
||||
|
||||
return response()->json([
|
||||
'status' => 'success',
|
||||
'path' => $debugDir.'/state-latest.json',
|
||||
'timestamp' => $timestamp,
|
||||
]);
|
||||
}
|
||||
|
||||
/**
|
||||
* 세션 디렉토리의 섹션 파일들을 최종 저장 위치로 옮깁니다.
|
||||
*
|
||||
* @param string $sessionDir 세션 임시 디렉토리
|
||||
* @param string $debugDir 최종 저장 디렉토리
|
||||
* @param bool $saveHistory 이력 파일 저장 여부
|
||||
* @param mixed $timestamp 클라이언트가 보낸 밀리초 타임스탬프
|
||||
* @return void
|
||||
*/
|
||||
private static function mergeSectionsToFinalFiles(
|
||||
string $sessionDir,
|
||||
string $debugDir,
|
||||
bool $saveHistory,
|
||||
mixed $timestamp
|
||||
): void {
|
||||
$timestampStr = self::formatTimestamp($timestamp);
|
||||
|
||||
foreach (File::files($sessionDir) as $file) {
|
||||
$sectionName = pathinfo($file, PATHINFO_FILENAME);
|
||||
|
||||
if (! isset(self::SECTION_FILES[$sectionName])) {
|
||||
continue;
|
||||
}
|
||||
|
||||
File::copy($file, $debugDir.'/'.self::SECTION_FILES[$sectionName]);
|
||||
|
||||
if ($saveHistory && $sectionName === self::HISTORY_SECTION) {
|
||||
File::copy($file, $debugDir."/state-{$timestampStr}.json");
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 오래된 세션 디렉토리를 정리합니다.
|
||||
*
|
||||
* @param string $sessionsDir 세션 루트 디렉토리
|
||||
* @return void
|
||||
*/
|
||||
private static function cleanupOldSessions(string $sessionsDir): void
|
||||
{
|
||||
if (! File::isDirectory($sessionsDir)) {
|
||||
return;
|
||||
}
|
||||
|
||||
$cutoffTime = time() - self::SESSION_TTL_SECONDS;
|
||||
|
||||
foreach (File::directories($sessionsDir) as $sessionDir) {
|
||||
if (File::lastModified($sessionDir) < $cutoffTime) {
|
||||
File::deleteDirectory($sessionDir);
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 클라이언트 타임스탬프(밀리초)를 이력 파일명용 문자열로 변환합니다.
|
||||
*
|
||||
* `date()` 의 두 번째 파라미터는 int 이므로 `$timestamp / 1000` 의 float 결과를 그대로
|
||||
* 넘기면 PHP 8.1+ 에서 암묵 형변환 deprecation 이 발생한다 — 명시적으로 캐스팅한다.
|
||||
*
|
||||
* @param mixed $timestamp 밀리초 타임스탬프 (없으면 현재 시각 사용)
|
||||
* @return string `Ymd_His` 형식 문자열
|
||||
*/
|
||||
private static function formatTimestamp(mixed $timestamp): string
|
||||
{
|
||||
if (! is_numeric($timestamp)) {
|
||||
return now()->format('Ymd_His');
|
||||
}
|
||||
|
||||
return date('Ymd_His', (int) ($timestamp / 1000));
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user