공개 제보 https://github.com/gnuboard/g7/issues/122 대응 — 초기 부트스트랩 리소스(다국어 병합·컴포넌트 정의·라우트·확장 번들·템플릿 dist)를 캐시 버전 디렉토리(public/build/ext/{v}/)에 실파일로 게시해 웹서버가 rewrite 전에 직접 서빙한다. 부트 임계 경로의 PHP 왕복을 제거하고(실측 TTFB 131~144ms → 1~7ms), 미게시·부분게시·GC 직후에는 fetch·태그·번들 3계층이 종전 API 로 즉시 폴백한다. - 게시: 원자적 tmp→rename→manifest(존재=완료), 캐시 락 단일 실행, 인라인 GC (현재+직전 1개), incrementExtensionCacheVersion 단일 지점 terminating 트리거 + blade 자가 치유 + 설치기 태스크(best_effort) + 일일 cleanup 스케줄, sudo 업데이트 대비 소유권 정상화(normalizeOwnership)·prune/백업 제외 - 프론트(engine-v1.61.0): blade 주입 cache_version 1급 시드(이중 부트 로드 제거), fetchStaticFirst 즉시 폴백, ComponentRegistry 버전 키드 매니페스트, ModuleAssetLoader 번들 정적→레거시 폴백, asset-url-recovery staticToLegacy 역변환 - 폴백 API 품질: lang/components/routes ETag+304 + 환경 분기 Cache-Control, 열화 라우트 스냅샷 공개 캐시 금지(서버측 캐시 회피와 대칭), 게시 .htaccess mod_deflate + nginx gzip 스니펫(압축 전송량 회귀 방지) - SEO 정합: 봇 HTML 은 GC 대상 정적 URL 미사용(allowStatic:false), props $switch 봇측 해석 구현(engine-v1.56.0 패리티), 패리티 룰 expression-dialect 그룹 신설, 상주 allow 헤더 제거로 잠금 복원, _comment* 접두 주석 키 분류 - 검증: 전 수정 red→green 4단계, Playwright 라이브 21건, Chrome MCP 24축+M1~M3, 봇 curl 3축, 캐시 저장소(file/redis/database) 축 판정, 히스토리·공개이슈·커밋 이력 전수 재조사 반영 - 코어 7.0.10, engine-v1.61.0. kill-switch: G7_STATIC_CACHE=false
54 lines
1.8 KiB
PHP
54 lines
1.8 KiB
PHP
<?php
|
|
|
|
namespace App\Console\Commands;
|
|
|
|
use App\Services\ExtensionStaticCacheService;
|
|
use Illuminate\Console\Command;
|
|
|
|
/**
|
|
* 부트스트랩 리소스 정적 게시(bake)를 수동 수행하는 커맨드
|
|
*
|
|
* 수명주기 이벤트(terminating 트리거)와 blade 자가 치유가 정상 경로지만,
|
|
* 배포 직후 워밍이나 수동 복구가 필요할 때 이 커맨드로 즉시 게시한다.
|
|
* 설치기 완료 단계에서도 호출된다 (#122).
|
|
*/
|
|
class PublishExtensionStaticCacheCommand extends Command
|
|
{
|
|
/**
|
|
* The name and signature of the console command.
|
|
*/
|
|
protected $signature = 'ext-static:publish {--force : 게시 완료 상태여도 강제 재게시}';
|
|
|
|
/**
|
|
* The console command description.
|
|
*/
|
|
protected $description = '부트스트랩 리소스(다국어·컴포넌트·라우트·번들·템플릿 에셋)를 정적 파일로 게시합니다';
|
|
|
|
/**
|
|
* Execute the console command.
|
|
*
|
|
* @param ExtensionStaticCacheService $service 정적 게시 서비스
|
|
* @return int 명령 실행 결과 코드
|
|
*/
|
|
public function handle(ExtensionStaticCacheService $service): int
|
|
{
|
|
if (! $service->isEnabled()) {
|
|
$this->warn('정적 게시가 비활성화되어 있습니다 (G7_STATIC_CACHE=false). 게시를 건너뜁니다.');
|
|
|
|
return self::SUCCESS;
|
|
}
|
|
|
|
$published = $service->publishCurrent(force: (bool) $this->option('force'));
|
|
|
|
if (! $published) {
|
|
$this->error('정적 게시에 실패했습니다. 로그를 확인하세요 — 사이트는 API 폴백으로 정상 동작합니다.');
|
|
|
|
return self::FAILURE;
|
|
}
|
|
|
|
$this->info('부트스트랩 리소스 정적 게시가 완료되었습니다.');
|
|
|
|
return self::SUCCESS;
|
|
}
|
|
}
|