HeuJung
3945b6f1b3
공개 저장소 이슈 gnuboard/g7 (@bigmsg) 제보에서 출발한 작업이다. 브라우저가 화면을 그리려고 제3자 CDN 에 도달해야 하면, 그 도달 실패는 예외도 로그도 남기지 않고 화면 기능만 조용히 사라진다. 폐쇄망·방화벽·광고차단기에서 재현되는데 자체 서버 로그에는 흔적이 없어 운영자가 원인을 특정할 수 없다. 제보된 것은 편집기 하나였지만 같은 구조가 아이콘·글꼴·코드편집기·압축 라이브러리·설치 마법사·개발 대시보드에 똑같이 있었으므로, 번들 확장과 템플릿 전체를 자체 제공으로 옮겼다. 런타임에 외부로 나가는 것은 주소 검색 서비스 하나만 남았다. 자체 제공만으로는 부족하다 — 자기 서버에서 받는 파일도 실패할 수 있고, 종전에는 그 실패가 무음이었다. CSS 경로에 재시도 계층을 세우고(스크립트 경로와 동형), 서버가 HTML 에 직접 심는 externals 까지 실패를 붙잡아 안내 배너와 [다시 시도]로 표면화했다. 편집기·코드편집기는 확보 실패 시 평문 입력으로 내려앉되 저장 계약을 유지한다. 두 번째 축은 운영자가 CSS 를 덧붙일 자리가 없던 문제다(sir.kr 문의). 확장 디렉토리의 custom/ 을 운영자 소유로 정해, 확장 교체가 그 디렉토리만은 보존하게 했다. 출처에 의존하지 않는 서술자로 해석하므로 나중에 다른 출처가 붙어도 소비자는 바뀌지 않는다. 확장 자산과 같은 메커니즘으로 정적 게시되어 CSS 내부 상대 url 도 해석되고, 파일을 고치면 그 변경을 감지해 재게시까지 예약된다. FTP 접근이 없는 운영자에게는 그 자리도 없는 것과 같으므로 레이아웃 편집기에서 직접 넣고 고칠 수 있게 했다. 모듈·플러그인·템플릿이 한 엔드포인트를 공유한다 — 타입별로 나누면 같은 검증이 세 벌로 갈리고 그중 약한 하나가 우회로가 된다. 여기서 올린 스크립트는 그 레이아웃 한 장이 아니라 사이트 전 화면에서 실행되므로 레이아웃 편집과 분리된 전용 권한으로 연다. 운영자 CSS 가 화면을 조작 불능으로 만들면 그것을 고칠 화면에도 같은 CSS 가 실려 스스로 갇히므로, 서버가 목록을 비우는 탈출구(?custom=off)를 함께 뒀다. 동봉 자산은 재생성 경로에 버전 대조 가드를 붙였다. 선언과 다른 버전을 버전 디렉토리에 써 넣는 조용한 거짓말은 배포된 뒤에는 드러나지 않는다.
402 lines
15 KiB
PHP
402 lines
15 KiB
PHP
<?php
|
|
|
|
namespace App\Console\Commands\Core;
|
|
|
|
use App\Extension\Traits\ClearsTemplateCaches;
|
|
use Illuminate\Console\Command;
|
|
use Illuminate\Support\Facades\Log;
|
|
use Symfony\Component\Process\Process;
|
|
|
|
class BuildCoreCommand extends Command
|
|
{
|
|
use ClearsTemplateCaches;
|
|
|
|
/**
|
|
* The name and signature of the console command.
|
|
*/
|
|
protected $signature = 'core:build
|
|
{--watch : 파일 변경 감시 모드}
|
|
{--production : 프로덕션 빌드}
|
|
{--full : 전체 빌드 (npm run build)}';
|
|
|
|
/**
|
|
* The console command description.
|
|
*/
|
|
protected $description = '그누보드7 코어 프론트엔드 에셋을 빌드합니다';
|
|
|
|
/**
|
|
* Execute the console command.
|
|
*
|
|
* @return int 명령 실행 결과 코드
|
|
*/
|
|
public function handle(): int
|
|
{
|
|
$watchMode = $this->option('watch');
|
|
$productionMode = $this->option('production');
|
|
$full = $this->option('full');
|
|
|
|
try {
|
|
$projectPath = base_path();
|
|
$packageJsonPath = $projectPath.'/package.json';
|
|
|
|
// package.json 존재 확인
|
|
if (! file_exists($packageJsonPath)) {
|
|
$this->error('❌ package.json 파일이 없습니다.');
|
|
|
|
return Command::FAILURE;
|
|
}
|
|
|
|
// node_modules 확인 및 설치
|
|
if (! is_dir($projectPath.'/node_modules')) {
|
|
$this->info('📦 의존성 설치 중...');
|
|
$installResult = $this->runNpmCommand(['npm', 'install'], $projectPath);
|
|
|
|
if ($installResult !== Command::SUCCESS) {
|
|
$this->error('❌ npm install 실패');
|
|
|
|
return Command::FAILURE;
|
|
}
|
|
}
|
|
|
|
// 빌드 유형 결정: 기본은 템플릿 엔진만 빌드
|
|
if ($full) {
|
|
return $this->buildFull($projectPath, $watchMode, $productionMode);
|
|
}
|
|
|
|
return $this->buildEngineOnly($projectPath, $watchMode, $productionMode);
|
|
|
|
} catch (\Exception $e) {
|
|
$this->error('❌ '.$e->getMessage());
|
|
Log::error('코어 빌드 실패', [
|
|
'error' => $e->getMessage(),
|
|
]);
|
|
|
|
return Command::FAILURE;
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 템플릿 엔진만 빌드 (build:core)
|
|
*
|
|
* @param string $projectPath 프로젝트 경로
|
|
* @param bool $watchMode 파일 감시 모드
|
|
* @param bool $productionMode 프로덕션 빌드
|
|
* @return int 명령 실행 결과 코드
|
|
*/
|
|
private function buildEngineOnly(string $projectPath, bool $watchMode, bool $productionMode): int
|
|
{
|
|
// 감시 모드: 엔진 번들 + 편집기 번들(layout-editor.min.js)을 각각 vite --watch 로
|
|
// 병렬 감시한다. (기존 dev 서버는 코어 lib 를 빌드하지 않으므로 사용 불가)
|
|
if ($watchMode) {
|
|
$this->info('👀 파일 감시 모드로 코어 빌드 시작 (템플릿 엔진 + 레이아웃 편집기 + DevTools + 개발 대시보드 CSS)');
|
|
$this->line(' Ctrl+C로 종료할 수 있습니다.');
|
|
|
|
return $this->runWatchBundles($projectPath);
|
|
}
|
|
|
|
// 3개 번들을 npm 스크립트로 순차 호출하므로 빌드 환경변수를 세 곳 모두에 주입한다.
|
|
$buildEnv = $this->buildEnv($productionMode);
|
|
|
|
// ── 1) 템플릿 엔진 번들 (편집기 코드 제외) ──────────────────────────────
|
|
$this->info('🔨 코어 빌드 시작 (템플릿 엔진)'.($productionMode ? ' (프로덕션)' : ''));
|
|
$engineResult = $this->runNpmCommand(['npm', 'run', 'build:core'], $projectPath, true, $buildEnv);
|
|
|
|
if ($engineResult !== Command::SUCCESS) {
|
|
return $engineResult;
|
|
}
|
|
|
|
// ── 2) 레이아웃 편집기 번들 (lazy, /admin/layout-editor/* 진입 시 로드) ──
|
|
$this->info('🔨 코어 빌드 시작 (레이아웃 편집기)'.($productionMode ? ' (프로덕션)' : ''));
|
|
$editorResult = $this->runNpmCommand(['npm', 'run', 'build:core-editor'], $projectPath, true, $buildEnv);
|
|
|
|
if ($editorResult !== Command::SUCCESS) {
|
|
$this->error('❌ 레이아웃 편집기 번들 빌드 실패');
|
|
|
|
return $editorResult;
|
|
}
|
|
|
|
// ── 3) DevTools 번들 (lazy, 디버그 모드에서만 로드) ──
|
|
$this->info('🔨 코어 빌드 시작 (DevTools)'.($productionMode ? ' (프로덕션)' : ''));
|
|
$devtoolsResult = $this->runNpmCommand(['npm', 'run', 'build:core-devtools'], $projectPath, true, $buildEnv);
|
|
|
|
if ($devtoolsResult !== Command::SUCCESS) {
|
|
$this->error('❌ DevTools 번들 빌드 실패');
|
|
|
|
return $devtoolsResult;
|
|
}
|
|
|
|
// ── 4) 개발 대시보드 CSS (자체 제공 — 종전 Tailwind Play CDN 대체) ──
|
|
$this->info('🔨 코어 빌드 시작 (개발 대시보드 CSS)'.($productionMode ? ' (프로덕션)' : ''));
|
|
$dashboardResult = $this->runNpmCommand(['npm', 'run', 'build:core-devdashboard'], $projectPath, true, $buildEnv);
|
|
|
|
if ($dashboardResult !== Command::SUCCESS) {
|
|
$this->error('❌ 개발 대시보드 CSS 빌드 실패');
|
|
|
|
return $dashboardResult;
|
|
}
|
|
|
|
$this->info('✅ 코어 빌드 완료 (템플릿 엔진 + 레이아웃 편집기 + DevTools + 개발 대시보드 CSS)');
|
|
$this->showEngineBuildResults($projectPath);
|
|
$this->incrementExtensionCacheVersion();
|
|
|
|
return Command::SUCCESS;
|
|
}
|
|
|
|
/**
|
|
* 감시 모드에서 엔진 번들 + 편집기 번들을 병렬로 vite --watch 실행합니다.
|
|
*
|
|
* @param string $projectPath 프로젝트 경로
|
|
* @return int 명령 실행 결과 코드
|
|
*/
|
|
private function runWatchBundles(string $projectPath): int
|
|
{
|
|
// 엔진 + 편집기 + DevTools + 개발 대시보드 CSS 를 각각 vite --watch 로 병렬 감시.
|
|
// 1회 빌드가 굽는 산출물과 같은 집합이어야 한다 — 한쪽만 빠지면 감시 모드에서
|
|
// 그 산출물만 조용히 stale 해진다.
|
|
$bundles = [
|
|
'engine' => ['npm', 'run', 'build:core-watch'],
|
|
'editor' => ['npm', 'run', 'build:core-editor-watch'],
|
|
'devtools' => ['npm', 'run', 'build:core-devtools-watch'],
|
|
'dashboard' => ['npm', 'run', 'build:core-devdashboard-watch'],
|
|
];
|
|
|
|
/** @var array<string, Process> $processes */
|
|
$processes = [];
|
|
|
|
foreach ($bundles as $label => $command) {
|
|
if (PHP_OS_FAMILY === 'Windows') {
|
|
$command = array_merge(['cmd', '/c'], $command);
|
|
}
|
|
|
|
$process = new Process($command);
|
|
$process->setWorkingDirectory($projectPath);
|
|
$process->setTimeout(null);
|
|
$process->start(function ($type, $buffer) use ($label) {
|
|
$this->output->write("[{$label}] ".$buffer);
|
|
});
|
|
|
|
$processes[$label] = $process;
|
|
}
|
|
|
|
// 하나라도 실행 중이면 계속 대기 (Ctrl+C 로 종료)
|
|
do {
|
|
$anyRunning = false;
|
|
foreach ($processes as $process) {
|
|
if ($process->isRunning()) {
|
|
$anyRunning = true;
|
|
}
|
|
}
|
|
usleep(100000); // 100ms
|
|
} while ($anyRunning);
|
|
|
|
return Command::SUCCESS;
|
|
}
|
|
|
|
/**
|
|
* 전체 빌드
|
|
*
|
|
* @param string $projectPath 프로젝트 경로
|
|
* @param bool $watchMode 파일 감시 모드
|
|
* @param bool $productionMode 프로덕션 빌드
|
|
* @return int 명령 실행 결과 코드
|
|
*/
|
|
private function buildFull(string $projectPath, bool $watchMode, bool $productionMode): int
|
|
{
|
|
$buildCommand = ['npm', 'run'];
|
|
|
|
if ($watchMode) {
|
|
$buildCommand[] = 'dev';
|
|
$this->info('👀 파일 감시 모드로 코어 빌드 시작 (전체)');
|
|
$this->line(' Ctrl+C로 종료할 수 있습니다.');
|
|
} else {
|
|
$buildCommand[] = 'build';
|
|
$this->info('🔨 코어 빌드 시작 (전체)'.($productionMode ? ' (프로덕션)' : ''));
|
|
}
|
|
|
|
// 감시 모드에는 소스맵 억제를 주입하지 않는다 — 개발 중 디버깅 필요
|
|
$result = $this->runNpmCommand(
|
|
$buildCommand,
|
|
$projectPath,
|
|
! $watchMode,
|
|
$watchMode ? [] : $this->buildEnv($productionMode)
|
|
);
|
|
|
|
if ($result === Command::SUCCESS && ! $watchMode) {
|
|
$this->info('✅ 코어 빌드 완료 (전체)');
|
|
$this->showFullBuildResults($projectPath);
|
|
$this->incrementExtensionCacheVersion();
|
|
}
|
|
|
|
return $result;
|
|
}
|
|
|
|
/**
|
|
* 템플릿 엔진 빌드 결과 출력
|
|
*
|
|
* @param string $projectPath 프로젝트 경로
|
|
*/
|
|
private function showEngineBuildResults(string $projectPath): void
|
|
{
|
|
$corePath = $projectPath.'/public/build/core';
|
|
|
|
if (! is_dir($corePath)) {
|
|
return;
|
|
}
|
|
|
|
$this->line(' 빌드 결과:');
|
|
|
|
// template-engine.min.js 확인 (일반 페이지 초기 로드 = 이 번들만)
|
|
$engineFile = $corePath.'/template-engine.min.js';
|
|
if (file_exists($engineFile)) {
|
|
$fileSize = number_format(filesize($engineFile) / 1024, 2);
|
|
$this->line(" - template-engine.min.js ({$fileSize} KB)");
|
|
}
|
|
|
|
// layout-editor.min.js 확인 (편집기 lazy 번들, /admin/layout-editor/* 진입 시 로드)
|
|
$editorFile = $corePath.'/layout-editor.min.js';
|
|
if (file_exists($editorFile)) {
|
|
$fileSize = number_format(filesize($editorFile) / 1024, 2);
|
|
$this->line(" - layout-editor.min.js ({$fileSize} KB, lazy)");
|
|
}
|
|
|
|
// devtools.min.js 확인 (DevTools lazy 번들, 디버그 모드에서만 로드)
|
|
$devtoolsFile = $corePath.'/devtools.min.js';
|
|
if (file_exists($devtoolsFile)) {
|
|
$fileSize = number_format(filesize($devtoolsFile) / 1024, 2);
|
|
$this->line(" - devtools.min.js ({$fileSize} KB, lazy/debug)");
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 전체 빌드 결과 출력
|
|
*
|
|
* @param string $projectPath 프로젝트 경로
|
|
*/
|
|
private function showFullBuildResults(string $projectPath): void
|
|
{
|
|
$buildPath = $projectPath.'/public/build';
|
|
|
|
if (! is_dir($buildPath)) {
|
|
return;
|
|
}
|
|
|
|
$this->line(' 빌드 결과:');
|
|
|
|
// manifest.json 확인
|
|
$manifestPath = $buildPath.'/manifest.json';
|
|
if (file_exists($manifestPath)) {
|
|
$manifest = json_decode(file_get_contents($manifestPath), true);
|
|
if ($manifest) {
|
|
foreach ($manifest as $source => $info) {
|
|
if (is_array($info) && isset($info['file'])) {
|
|
$filePath = $buildPath.'/'.$info['file'];
|
|
if (file_exists($filePath)) {
|
|
$fileName = $info['file'];
|
|
$fileSize = number_format(filesize($filePath) / 1024, 2);
|
|
$this->line(" - {$fileName} ({$fileSize} KB)");
|
|
}
|
|
}
|
|
}
|
|
}
|
|
} else {
|
|
// manifest가 없으면 직접 파일 탐색
|
|
$this->scanBuildFiles($buildPath, 'assets');
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 빌드 파일 스캔 및 출력
|
|
*
|
|
* @param string $buildPath 빌드 경로
|
|
* @param string $subDir 하위 디렉토리
|
|
*/
|
|
private function scanBuildFiles(string $buildPath, string $subDir): void
|
|
{
|
|
$assetsPath = $buildPath.'/'.$subDir;
|
|
|
|
if (! is_dir($assetsPath)) {
|
|
return;
|
|
}
|
|
|
|
$files = scandir($assetsPath);
|
|
foreach ($files as $file) {
|
|
if ($file === '.' || $file === '..') {
|
|
continue;
|
|
}
|
|
|
|
$filePath = $assetsPath.'/'.$file;
|
|
if (is_file($filePath)) {
|
|
$fileName = $subDir.'/'.$file;
|
|
$fileSize = number_format(filesize($filePath) / 1024, 2);
|
|
$this->line(" - {$fileName} ({$fileSize} KB)");
|
|
}
|
|
}
|
|
}
|
|
|
|
/**
|
|
* 빌드 프로세스에 주입할 환경변수를 구성합니다.
|
|
*
|
|
* 프로덕션 빌드에서는 소스맵을 생성하지 않습니다. 배포 산출물에 원본 코드가
|
|
* 포함되는 것을 막기 위함이며, 각 vite config 가 이 값을 읽습니다.
|
|
*
|
|
* @param bool $productionMode 프로덕션 빌드 여부
|
|
* @return array<string, string> Process 에 주입할 환경변수
|
|
*/
|
|
private function buildEnv(bool $productionMode): array
|
|
{
|
|
return $productionMode ? ['G7_BUILD_SOURCEMAP' => '0'] : [];
|
|
}
|
|
|
|
/**
|
|
* npm 명령 실행
|
|
*
|
|
* @param array $command 실행할 명령
|
|
* @param string $cwd 작업 디렉토리
|
|
* @param bool $waitForCompletion 완료 대기 여부
|
|
* @param array<string, string> $env 추가로 주입할 환경변수 (부모 환경에 병합됨)
|
|
* @return int 명령 실행 결과 코드
|
|
*/
|
|
private function runNpmCommand(array $command, string $cwd, bool $waitForCompletion = true, array $env = []): int
|
|
{
|
|
// Windows 환경에서는 cmd /c 사용
|
|
if (PHP_OS_FAMILY === 'Windows') {
|
|
$command = array_merge(['cmd', '/c'], $command);
|
|
}
|
|
|
|
$process = new Process($command);
|
|
$process->setWorkingDirectory($cwd);
|
|
|
|
// Symfony Process 는 지정한 env 를 부모 환경에 병합하므로(PATH 등 유지) 추가분만 넘긴다.
|
|
if ($env !== []) {
|
|
$process->setEnv($env);
|
|
}
|
|
$process->setTimeout(null); // 타임아웃 없음
|
|
|
|
if ($waitForCompletion) {
|
|
$process->run(function ($type, $buffer) {
|
|
// 출력 표시
|
|
if ($type === Process::ERR) {
|
|
// stderr이지만 npm은 정상 출력도 stderr로 보내므로 그냥 표시
|
|
$this->output->write($buffer);
|
|
} else {
|
|
$this->output->write($buffer);
|
|
}
|
|
});
|
|
|
|
return $process->isSuccessful() ? Command::SUCCESS : Command::FAILURE;
|
|
}
|
|
|
|
// 감시 모드: 인터럽트까지 실행
|
|
$process->start(function ($type, $buffer) {
|
|
$this->output->write($buffer);
|
|
});
|
|
|
|
// 프로세스가 실행 중인 동안 대기
|
|
while ($process->isRunning()) {
|
|
usleep(100000); // 100ms
|
|
}
|
|
|
|
return Command::SUCCESS;
|
|
}
|
|
}
|