HeuJung
01d319e74b
한국어 Windows 에서 whoami 가 CP949 로 출력해 계정명에 한글이 있으면 invalid UTF-8 이 응답 배열에 실리고 json_encode 가 false 를 반환한다. echo false 는 빈 문자열이라 HTTP 200 + 빈 본문이 나가는데 예외도 로그도 남지 않아, 설치 마법사 2단계가 진행 불가 상태로 멈춘다. 2026-07 수정(7.0.2)은 로그 축 4곳만 막았다. 출처에서 정규화하고(1차), 응답 경계를 단일 헬퍼로 닫고(2차), 실패 시 문제 필드 경로를 로그에 남기도록(3차) 세 층으로 처리해 다른 경로가 열린 채 남지 않게 했다. 정규화는 복원 가능한 코드페이지 출력을 먼저 되살리므로, 종전 mb_scrub 단독 처리와 달리 한글이 U+FFFD 로 훼손되지 않는다. 같은 원인으로 한국어 Windows 에서 관리자 환경설정의 시스템 정보가 500 이 되던 것도 함께 막았다.
401 lines
16 KiB
PHP
401 lines
16 KiB
PHP
<?php
|
|
|
|
/**
|
|
* G7 인스톨러 - 설치 상태 관리 통합 API
|
|
*
|
|
* 설치 상태 조회, 초기화, 중단 기능을 하나의 API로 통합
|
|
*
|
|
* 엔드포인트:
|
|
* - GET ?action=get : 현재 설치 상태 조회 (action 생략 시 기본값)
|
|
* - POST ?action=reset : 설치 상태 초기화 (Step 3로 이동)
|
|
* - POST ?action=abort : 설치 중단 (현재 작업만 롤백)
|
|
*/
|
|
|
|
/**
|
|
* 설치 상태 관리 API 클래스
|
|
*/
|
|
class StateManagementApi
|
|
{
|
|
/**
|
|
* 요청 처리 메인 메서드
|
|
*/
|
|
public function handleRequest(): void
|
|
{
|
|
// JSON 헤더 설정
|
|
$this->setJsonHeaders();
|
|
|
|
// HTTP 메서드 및 action 파라미터 확인
|
|
$method = $_SERVER['REQUEST_METHOD'];
|
|
$action = $_GET['action'] ?? ($method === 'GET' ? 'get' : null);
|
|
|
|
try {
|
|
// action에 따라 적절한 메서드 호출
|
|
match ($action) {
|
|
'get' => $this->getState(),
|
|
'reset' => $this->resetState(),
|
|
'abort' => $this->abortInstallation(),
|
|
default => $this->error400('Invalid action parameter'),
|
|
};
|
|
} catch (Exception $e) {
|
|
$this->error500($e);
|
|
}
|
|
}
|
|
|
|
/**
|
|
* JSON 응답 헤더 설정
|
|
*/
|
|
private function setJsonHeaders(): void
|
|
{
|
|
header('Content-Type: application/json; charset=utf-8');
|
|
header('Cache-Control: no-cache, no-store, must-revalidate');
|
|
header('Pragma: no-cache');
|
|
header('Expires: 0');
|
|
}
|
|
|
|
/**
|
|
* GET ?action=get
|
|
* 현재 설치 상태 조회
|
|
*
|
|
* JavaScript 폴링(1초 간격)으로 호출되어 실시간 진행 상황을 업데이트합니다.
|
|
*/
|
|
private function getState(): void
|
|
{
|
|
// GET 메서드만 허용
|
|
if ($_SERVER['REQUEST_METHOD'] !== 'GET') {
|
|
http_response_code(405);
|
|
echo installer_json_encode([
|
|
'error' => 'Method Not Allowed',
|
|
'message' => lang('error_get_method_required'),
|
|
], JSON_UNESCAPED_UNICODE);
|
|
exit;
|
|
}
|
|
|
|
// state.json 파일 실제 존재 여부 (getInstallationState는 부재 시 DEFAULT_INSTALLATION_STATE를 반환하므로
|
|
// isset($state['installation_status']) 로는 "기본 상태"와 "실제 파일 상태"를 구분할 수 없다)
|
|
$stateFileExists = file_exists(STATE_PATH);
|
|
$installedFlagPath = BASE_PATH.'/storage/app/g7_installed';
|
|
|
|
// 현재 설치 상태 조회
|
|
$state = getInstallationState();
|
|
|
|
// installation_status 값을 status로 매핑
|
|
$status = 'pending';
|
|
|
|
if (! $stateFileExists && file_exists($installedFlagPath)) {
|
|
// state.json 삭제 + g7_installed 플래그 존재 → 설치 완료 후 정리된 상태
|
|
// 폴링이 완료 시점을 놓치면 이후 주기에서 이 분기로 completed 전환
|
|
$status = 'completed';
|
|
} elseif ($stateFileExists && isset($state['installation_status'])) {
|
|
switch ($state['installation_status']) {
|
|
case 'not_started':
|
|
case 'ready': // ready도 pending으로 매핑 (설치 대기 상태)
|
|
$status = 'pending';
|
|
break;
|
|
case 'running':
|
|
$status = 'running';
|
|
break;
|
|
case 'completed':
|
|
$status = 'completed';
|
|
break;
|
|
case 'failed':
|
|
$status = 'failed';
|
|
break;
|
|
case 'aborted':
|
|
$status = 'aborted';
|
|
break;
|
|
default:
|
|
$status = $state['installation_status'];
|
|
}
|
|
}
|
|
|
|
// 폴링 모드 증분 조회 지원 (?log_offset=N)
|
|
$logOffset = isset($_GET['log_offset']) ? max(0, (int) $_GET['log_offset']) : 0;
|
|
|
|
// 로그 파일에서 로그 읽기 (offset 이후만)
|
|
$logs = getInstallationLogs($logOffset);
|
|
$logTotal = getInstallationLogCount();
|
|
|
|
// API 응답 형식으로 변환
|
|
$response = [
|
|
'status' => $status,
|
|
'current_step' => $state['current_step'] ?? 0,
|
|
'current_task' => $state['current_task'] ?? null,
|
|
'completed_tasks' => $state['completed_tasks'] ?? [],
|
|
'logs' => $logs,
|
|
'log_total' => $logTotal,
|
|
'error' => $state['error'] ?? null,
|
|
'last_updated' => $state['last_updated'] ?? null,
|
|
|
|
// 실패 정보 (새로고침 후에도 표시용)
|
|
'failed_task' => $state['failed_task'] ?? null,
|
|
'error_message_key' => $state['error_message_key'] ?? null,
|
|
'error_detail' => $state['error_detail'] ?? null,
|
|
'rollback_failure' => $state['rollback_failure'] ?? null,
|
|
'manual_commands' => $state['manual_commands'] ?? null,
|
|
|
|
// SSE/폴링 듀얼 모드 지원
|
|
'installation_mode' => $state['installation_mode'] ?? 'sse',
|
|
];
|
|
|
|
// JSON 응답 반환
|
|
//
|
|
// 최종 안전망 (gnuboard/g7#62): $response 의 로그·경로에 invalid UTF-8 바이트가
|
|
// 섞이면 표준 json_encode 는 false 를 반환하고, echo false = 빈 본문(HTTP 200) 이 되어
|
|
// 프론트 폴링(res.json())이 "Unexpected end of JSON input" 으로 폭주한다.
|
|
//
|
|
// installer_json_encode 는 값을 정규화하고 substitute 를 적용하며,
|
|
// 실패하더라도 파싱 가능한 오류 JSON 을 돌려주므로 빈 본문이 나갈 수 없다.
|
|
//
|
|
// 폴백에도 `status`/`logs`/`log_total` 을 실어 보낸다. 프론트 PollingMonitor 는
|
|
// `state.status` 로 진행/완료/실패를 판정하므로, 그 키가 없는 응답은 파싱은 되지만
|
|
// 아무 전이도 일으키지 못해 화면이 조용히 멈춘 것처럼 보인다(파싱 실패 카운터도
|
|
// 걸리지 않는다). 도달 확률과 무관하게 소비자 계약을 폴백에서도 유지한다.
|
|
echo installer_json_encode(
|
|
$response,
|
|
JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT,
|
|
['status' => $status, 'logs' => [], 'log_total' => $logTotal]
|
|
);
|
|
}
|
|
|
|
/**
|
|
* POST ?action=reset
|
|
* 설치 상태 초기화 및 적절한 Step으로 이동
|
|
*
|
|
* 설치 상태를 초기화하여 설정 페이지로 돌아갈 수 있도록 합니다.
|
|
* DB 롤백은 수행하지 않습니다 (사용자가 수동으로 DB 정리 필요).
|
|
* (마이그레이션 실패 시 자동 롤백은 install-worker.php에서 처리)
|
|
*/
|
|
private function resetState(): void
|
|
{
|
|
// POST 메서드만 허용
|
|
if ($_SERVER['REQUEST_METHOD'] !== 'POST') {
|
|
http_response_code(405);
|
|
echo installer_json_encode([
|
|
'success' => false,
|
|
'message' => 'Only POST method is allowed',
|
|
], JSON_UNESCAPED_UNICODE);
|
|
exit;
|
|
}
|
|
|
|
// 현재 상태 조회
|
|
$state = getInstallationState();
|
|
|
|
// 항상 Step 4 (확장 선택)로 이동
|
|
$targetStep = 4;
|
|
|
|
addLog(lang('state_reset_requested'));
|
|
addLog(lang('state_reset_db_notice'));
|
|
|
|
// 상태 초기화 (DB 롤백 없이)
|
|
$state['current_step'] = $targetStep;
|
|
$_SESSION['installer_current_step'] = $targetStep;
|
|
$state['step_status'][$targetStep] = 'pending';
|
|
$state['installation_status'] = 'not_started';
|
|
$state['completed_tasks'] = [];
|
|
$state['current_task'] = null;
|
|
$state['error'] = null;
|
|
$state['failed_task'] = null;
|
|
$state['failed_task_target'] = null;
|
|
$state['error_message_key'] = null;
|
|
$state['error_detail'] = null;
|
|
$state['rollback_failure'] = null;
|
|
$state['manual_commands'] = null;
|
|
$state['last_updated'] = gmdate('Y-m-d\TH:i:s\Z');
|
|
|
|
// 보존되는 config 에서 비밀 제거 (이슈 #465) — 초기화 후 무기한 잔존 가능하므로
|
|
// 평문이 남지 않아야 한다. 비밀번호는 runtime.php 에 있고, 재설치 시 Step 3
|
|
// 재입력 또는 runtime 폴백으로 복원된다.
|
|
$state = redactInstallationStateSecrets($state);
|
|
|
|
// 상태 저장
|
|
$saved = saveInstallationState($state);
|
|
|
|
if (! $saved) {
|
|
throw new Exception(lang('state_save_failed'));
|
|
}
|
|
|
|
addLog(lang('state_reset_completed', ['step' => $targetStep]));
|
|
|
|
// 성공 응답
|
|
http_response_code(200);
|
|
|
|
echo installer_json_encode([
|
|
'success' => true,
|
|
'message' => lang('state_reset_completed', ['step' => $targetStep]),
|
|
'target_step' => $targetStep,
|
|
], JSON_UNESCAPED_UNICODE);
|
|
}
|
|
|
|
/**
|
|
* POST ?action=abort
|
|
* 설치 중단 (현재 작업만 롤백)
|
|
*
|
|
* 사용자가 명시적으로 설치 중단 버튼을 클릭했을 때 호출됩니다.
|
|
* 현재 진행 중인 작업만 롤백하고, 완료된 작업은 유지합니다.
|
|
*/
|
|
private function abortInstallation(): void
|
|
{
|
|
// POST 메서드만 허용
|
|
if ($_SERVER['REQUEST_METHOD'] !== 'POST') {
|
|
http_response_code(405);
|
|
echo installer_json_encode([
|
|
'success' => false,
|
|
'message' => lang('api_method_not_allowed'),
|
|
]);
|
|
exit;
|
|
}
|
|
|
|
addLog(lang('abort_api_requested'));
|
|
|
|
// 설치 상태 가져오기
|
|
$state = getInstallationState();
|
|
|
|
// 디버그: 현재 state 상태 로깅
|
|
addLog(lang('abort_api_current_status', ['status' => $state['installation_status'] ?? 'null']));
|
|
addLog(lang('abort_api_current_task', ['task' => $state['current_task'] ?? 'null']));
|
|
addLog(lang('abort_api_completed_count', ['count' => count($state['completed_tasks'] ?? [])]));
|
|
|
|
// 설치가 이미 완료된 경우
|
|
if (isset($state['installation_status']) && $state['installation_status'] === 'completed') {
|
|
addLog(lang('abort_api_already_completed'));
|
|
echo installer_json_encode([
|
|
'success' => false,
|
|
'message' => lang('abort_api_already_completed'),
|
|
]);
|
|
exit;
|
|
}
|
|
|
|
// 이미 중단된 경우 - 멱등성 보장 (재진입 시 400 에러 방지)
|
|
if (isset($state['installation_status']) && $state['installation_status'] === 'aborted') {
|
|
addLog(lang('abort_api_already_aborted'));
|
|
echo installer_json_encode([
|
|
'success' => true,
|
|
'message' => lang('abort_api_already_aborted'),
|
|
]);
|
|
exit;
|
|
}
|
|
|
|
// 설치가 진행 중이 아닌 경우
|
|
if (! isset($state['installation_status']) || $state['installation_status'] !== 'running') {
|
|
addLog(lang('abort_api_not_running', ['status' => $state['installation_status'] ?? 'null']));
|
|
echo installer_json_encode([
|
|
'success' => false,
|
|
'message' => lang('abort_api_not_running', ['status' => $state['installation_status'] ?? 'null']),
|
|
]);
|
|
exit;
|
|
}
|
|
|
|
addLog(lang('abort_user_requested'));
|
|
|
|
// 현재 진행 중인 작업만 롤백 (완료된 작업은 유지)
|
|
// 결과는 rollbackCurrentTask()에서 로깅됨
|
|
$rollbackResult = rollbackCurrentTask($state);
|
|
|
|
// 설치 상태를 'aborted'로 변경
|
|
addLog(lang('abort_api_status_change'));
|
|
$state['installation_status'] = 'aborted';
|
|
// current_step은 5를 유지 (중단된 화면을 보여주기 위해 - Step 5 = Installation)
|
|
$state['current_task'] = null;
|
|
// completed_tasks는 유지 (이미 완료된 작업은 롤백하지 않음)
|
|
$state['aborted_at'] = date('Y-m-d H:i:s');
|
|
$state['abort_reason'] = 'User requested';
|
|
|
|
// 롤백 실패 정보 저장 (새로고침 후에도 표시용)
|
|
if (isset($rollbackResult['success']) && ! $rollbackResult['success']) {
|
|
$state['rollback_failure'] = [
|
|
'task' => $rollbackResult['task'] ?? null,
|
|
'message' => $rollbackResult['message'] ?? null,
|
|
'message_key' => 'failed_rollback_manual_cleanup',
|
|
'detail_key' => 'failed_rollback_manual_cleanup_detail',
|
|
];
|
|
}
|
|
// 세션도 Step 5를 유지 (중단 화면 표시)
|
|
|
|
// 중단 상태는 무기한 잔존 가능 — 보존되는 config 에서 비밀 제거 (이슈 #465)
|
|
$state = redactInstallationStateSecrets($state);
|
|
|
|
$saveResult = saveInstallationState($state);
|
|
addLog(lang('abort_api_save_result', ['result' => $saveResult ? 'success' : 'failed']));
|
|
|
|
// 저장 후 실제 state.json 확인
|
|
$verifyState = getInstallationState();
|
|
addLog(lang('abort_api_verify_status', ['status' => $verifyState['installation_status'] ?? 'null']));
|
|
|
|
addLog(lang('abort_installation_stopped'));
|
|
|
|
// 성공 응답 (리다이렉트 없음 - 현재 Step 5 유지)
|
|
echo installer_json_encode([
|
|
'success' => true,
|
|
'message' => lang('abort_installation_stopped'),
|
|
]);
|
|
}
|
|
|
|
/**
|
|
* 400 Bad Request 응답
|
|
*/
|
|
private function error400(string $message): void
|
|
{
|
|
http_response_code(400);
|
|
echo installer_json_encode([
|
|
'success' => false,
|
|
'error' => 'Bad Request',
|
|
'message' => $message,
|
|
], JSON_UNESCAPED_UNICODE);
|
|
exit;
|
|
}
|
|
|
|
/**
|
|
* 500 Internal Server Error 응답
|
|
*/
|
|
private function error500(Exception $e): void
|
|
{
|
|
// 에러 로깅
|
|
if (function_exists('logInstallationError')) {
|
|
logInstallationError(lang('error_state_management'), $e);
|
|
} elseif (function_exists('addLog')) {
|
|
addLog(lang('error_log_prefix', ['error' => $e->getMessage()]));
|
|
}
|
|
|
|
// 에러 응답
|
|
http_response_code(500);
|
|
echo installer_json_encode([
|
|
'success' => false,
|
|
'error' => 'Internal Server Error',
|
|
'message' => $e->getMessage(),
|
|
], JSON_UNESCAPED_UNICODE);
|
|
exit;
|
|
}
|
|
}
|
|
|
|
// ========================================
|
|
// 실행 부분
|
|
// ========================================
|
|
|
|
// 필수 파일 로드 (config.php가 BASE_PATH를 정의함)
|
|
require_once __DIR__.'/../includes/config.php';
|
|
require_once __DIR__.'/../includes/session.php';
|
|
require_once __DIR__.'/../includes/functions.php';
|
|
require_once __DIR__.'/../includes/installer-state.php';
|
|
|
|
// 롤백 함수 로드 (reset, abort 액션에서 필요)
|
|
require_once __DIR__.'/rollback-functions.php';
|
|
|
|
// 설치 완료 후 진입 차단 (KVE-2026-1056)
|
|
// finalize 전용 가드 — `.env` 의 INSTALLER_COMPLETED=true 단독으로만 차단한다.
|
|
// 일반 가드(installer_guard_or_410)는 `g7_installed` 락 파일도 차단 사유로 삼는데,
|
|
// 그 락 파일은 마지막 task `complete_flag` 가 먼저 생성한다. 그 직후에도 본 엔드포인트의
|
|
// action=get 폴링(1초 간격)이 계속되어 `completed` 상태를 받아야 완료 화면으로 전환되므로,
|
|
// 락 파일 기준으로 차단하면 정상 설치가 "진행 중"에 고착되는 자가 차단 회귀가 발생한다.
|
|
// 완전 완료 신호인 `.env` 플래그를 기준으로 삼아 get/reset/abort 를
|
|
// 일괄 차단하면서 폴링 구간은 비파괴로 통과시킨다.
|
|
require_once __DIR__.'/_guard.php';
|
|
installer_guard_finalize_or_410();
|
|
|
|
// 다국어 로드
|
|
$currentLang = getCurrentLanguage();
|
|
$translations = loadTranslations($currentLang);
|
|
|
|
// API 인스턴스 생성 및 요청 처리
|
|
$api = new StateManagementApi;
|
|
$api->handleRequest();
|