fix(core,installer): dev vendor 설치본의 코어 업데이트 중단 수정 — stale 패키지 매니페스트 3계층

Laravel PackageManifest 는 bootstrap/cache/packages.php 가 있으면 stale 여부를 검사하지
않고 그대로 읽어 등재된 provider 를 new 한다. 코어 업데이트는 Step 6/8 에서 vendor 를
--no-dev 로 교체하지만 그 파일은 Step 11 까지 이전 설치본의 것이 남으므로, 옵션 없는
`composer install` 로 깔린 사이트에서는 Step 10 spawn 자식이 새 vendor 에 없는 provider 를
찾다 부팅 단계에서 죽는다. 부팅 전이라 앱 로그에 흔적이 없고 부모에게는 자식의 비정상
종료로만 보여, 운영자에게는 「Class ... not found」 와 수동 재개 안내만 남는다.
(sir.kr 커뮤니티 제보, 7.0.9 → 7.0.10)

3계층으로 막는다.

 1. 부모 — spawn 직전 PackageManifestCacheHelper::clear
 2. 자식 — bootstrap/app.php 가 G7_UPDATE_IN_PROGRESS 를 보고 스스로 정리한다.
 이미 배포된 7.0.9·7.0.10 부모는 고칠 수 없으므로 그 아래에서 도는 신버전
 자식의 유일한 방어다. App\ 클래스를 참조하지 않고 실패는 무시한다.
 3. 범위 — CoreVersionChecker 의 env APP_VERSION 우선을 CoreUpdateContext 트리 안으로
 축소한다. 업데이트 전에 뜬 artisan serve·큐 워커가 옛 값을 물고 확장을
 incompatible_core 로 끄던 경로를 닫는다(관리자 템플릿이 대상이면 복구 UI
 자체에 도달할 수 없다).

업데이트 트리 판정은 App\Support\CoreUpdateContext 가 단독 소유하고
CoreServiceProvider::isCoreUpdateInProgress 는 위임으로 남는다. bootstrap/app.php 의
복제본은 부팅 전이라 불가피한 예외이며, 두 조건의 동형성을 테스트가 단언한다.

실측 중 드러난 결함 2건을 함께 고쳤다.

 - ConfigCacheHelper::withPreservedContainer 가 파사드 애플리케이션을 되돌리지 않아
 Step 11 이 `Target class [command.tinker] does not exist` 로 실패·롤백했다.
 - updateVersionInEnv 가 프로세스 환경을 갱신하지 않아 config 캐시에 이전 버전이 구워졌다
 (Laravel env 저장소가 불변이라 재부팅으로도 덮이지 않는다).

인스톨러는 재사용 vendor 의 개발용 패키지를 installed.json 으로 감지해 설치 환경 확인
카드·설치 로그로 알리되 설치를 차단하지 않고( 결정 D1), 재사용 경로에서도 컴파일 캐시를
정리한다. 실행되는 명령만이 아니라 실패 시 안내하는 수동 명령까지 --no-dev 로 맞췄다.
코어 업데이트 완료·핸드오프·단독 재개 사후 단계에서 queue:restart 신호를 보낸다(D3).

코어 7.0.10 → 7.0.11.
This commit is contained in:
HeuJung committed 2026-09-08 09:46:57 +09:00
1 parent 21177c8e17
commit ffab451b4a
42 files changed
+2660 -82

No files matched your search

+19 -27
View File
@@ -97,6 +97,7 @@ use App\Services\LayoutExtensionService;
use App\Services\TemplateLayoutAttachmentService;
use App\Services\TemplateService;
use App\Services\UniqueIdService;
use App\Support\CoreUpdateContext;
use App\Support\ExtensionSettingsMirror;
use App\Support\PrivilegedDatabaseAccounts;
use Illuminate\Support\Facades\Config;
@@ -562,7 +563,7 @@ class CoreServiceProvider extends ServiceProvider
'type' => $type,
'identifier' => $identifier,
'required_version' => $requiredVersion,
'core_version' => config('app.version'),
'core_version' => CoreVersionChecker::getCoreVersion(),
]);
}
}
@@ -626,6 +627,21 @@ class CoreServiceProvider extends ServiceProvider
$cache->put($cacheKey, $recovered, CoreVersionChecker::getCacheTtl());
}
/**
* 현재 프로세스가 코어 업데이트 중인지 판정합니다.
*
* 판정은 `App\Support\CoreUpdateContext::isInProgress()` 가 단독으로 소유한다 — 같은
* 플래그가 확장 자동 비활성화 스킵 · 코어 버전의 env 우선 판독 · `bootstrap/app.php` 의
* 패키지 매니페스트 자가 치유를 함께 게이트하므로, 판정이 갈라지면 한 경로만 조용히
* 다르게 동작한다. 이 메서드는 기존 호출처(각 Manager)를 위한 위임으로 남는다.
*
* @return bool 업데이트 트리 안이면 true (version-based 자동 비활성화 스킵)
*/
public static function isCoreUpdateInProgress(): bool
{
return CoreUpdateContext::isInProgress();
}
/**
* 호환되지 않는 템플릿을 자동 비활성화합니다.
*
@@ -634,30 +650,6 @@ class CoreServiceProvider extends ServiceProvider
*
* @param TemplateManager $templateManager 템플릿 매니저
*/
/**
* 현재 프로세스가 코어 업데이트 중인지 판정합니다.
*
* 판정 조건 (OR):
* 1. 환경변수 `G7_UPDATE_IN_PROGRESS=1` — 부모 CoreUpdateCommand 가 시작 시 설정,
* spawn 자식에도 `$env` 로 전파
* 2. artisan command 이름이 `core:update` / `core:execute-upgrade-steps` — 1 이 전파되지
* 않은 극단 상황 대비 보조 판정
*
* 둘 중 하나라도 true 면 업데이트 컨텍스트로 간주하여 version-based 자동 비활성화 스킵.
*/
public static function isCoreUpdateInProgress(): bool
{
$envFlag = $_ENV['G7_UPDATE_IN_PROGRESS'] ?? $_SERVER['G7_UPDATE_IN_PROGRESS'] ?? getenv('G7_UPDATE_IN_PROGRESS');
if ($envFlag === '1' || $envFlag === 1 || $envFlag === true) {
return true;
}
$argv = $_SERVER['argv'] ?? [];
$command = $argv[1] ?? '';
return in_array($command, ['core:update', 'core:execute-upgrade-steps'], true);
}
protected function validateAndDeactivateIncompatibleTemplates(TemplateManager $templateManager): void
{
// 업데이트 중 자동 비활성화 스킵 (validateAndDeactivateIncompatibleExtensions 와 동일 사유)
@@ -702,7 +694,7 @@ class CoreServiceProvider extends ServiceProvider
'type' => 'templates',
'identifier' => $identifier,
'required_version' => $requiredVersion,
'core_version' => config('app.version'),
'core_version' => CoreVersionChecker::getCoreVersion(),
]);
}
}
@@ -730,7 +722,7 @@ class CoreServiceProvider extends ServiceProvider
$alerts = $cache->get('ext.compatibility_alerts', []);
$alerts[$type] = [
'deactivated' => $deactivated,
'core_version' => config('app.version'),
'core_version' => CoreVersionChecker::getCoreVersion(),
'timestamp' => now()->toIso8601String(),
];
$cache->put('ext.compatibility_alerts', $alerts, 86400); // 24시간