HeuJung
ffab451b4a
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.
311 lines
14 KiB
PHP
311 lines
14 KiB
PHP
<?php
|
|
|
|
namespace Tests\Feature\Console;
|
|
|
|
use App\Console\Commands\Core\CoreUpdateCommand;
|
|
use App\Exceptions\UpgradeHandoffException;
|
|
use Illuminate\Console\OutputStyle;
|
|
use Illuminate\Support\Facades\File;
|
|
use PHPUnit\Framework\Attributes\Test;
|
|
use Symfony\Component\Console\Input\ArrayInput;
|
|
use Symfony\Component\Console\Output\BufferedOutput;
|
|
use Tests\TestCase;
|
|
|
|
/**
|
|
* stale 패키지 매니페스트로 인한 spawn 자식 부팅 실패 회귀 테스트 (dev-g7 #658).
|
|
*
|
|
* 회귀 시나리오 (sir.kr 제보, 7.0.9 → 7.0.10):
|
|
* 운영 사이트가 `composer install`(옵션 없음)로 깔린 dev 설치본이면
|
|
* `bootstrap/cache/packages.php` 에 require-dev 전이 의존성의 provider(`laravel/mcp` 의
|
|
* `McpServiceProvider` 등)가 등재된다. 코어 업데이트는 Step 6/8 에서 vendor 를 `--no-dev`
|
|
* 로 교체하지만 그 두 파일은 Step 11 까지 남고, Laravel 은 `packages.php` 가 **없을 때만**
|
|
* 다시 만든다. Step 10 spawn 자식은 그 목록을 읽어 새 vendor 에 없는 provider 를 `new`
|
|
* 하다 부팅 단계에서 죽고, 부모는 핸드오프(수동 재개 안내)로 중단한다.
|
|
*
|
|
* 세 계층을 각각 잠근다:
|
|
* - 계층 ① 부모가 spawn 직전에 두 파일을 비운다 (R1·R2)
|
|
* - 계층 ② 신버전 자식이 `G7_UPDATE_IN_PROGRESS=1` 이면 스스로 비우고 부팅한다 (R3)
|
|
* — 7.0.11 미만 부모는 비우지 않으므로 그 부모 아래에서는 이것이 유일한 방어다
|
|
* - 대조군: 업데이트 트리 밖 프로세스는 매니페스트를 건드리지 않는다 (R4)
|
|
*
|
|
* 격리: 실제 `bootstrap/cache/*` 를 백업하지 않고 `APP_PACKAGES_CACHE`/`APP_SERVICES_CACHE`
|
|
* 를 base_path 상대 POSIX 경로로 재지정한다(`Application::normalizeCachePath` 는 `/`·`\` 로
|
|
* 시작하지 않는 값을 basePath 상대로 해석하므로 Windows 절대 경로는 어긋난다). 자식도 같은
|
|
* env 를 물려받아 같은 파일을 가리킨다 — `CoreUpdateCommandSpawnFailureTest` 선례와 동일.
|
|
*/
|
|
class CoreUpdateCommandStalePackageManifestTest extends TestCase
|
|
{
|
|
/** @var array<string, string|null> 테스트가 덮어쓴 env 의 원값 (3채널 복원용) */
|
|
private array $originalEnv = [];
|
|
|
|
/** @var string base_path 상대 — packages.php 캐시 경로 */
|
|
private string $relativePackagesPath;
|
|
|
|
/** @var string base_path 상대 — services.php 캐시 경로 */
|
|
private string $relativeServicesPath;
|
|
|
|
private string $packagesPath;
|
|
|
|
private string $servicesPath;
|
|
|
|
protected function setUp(): void
|
|
{
|
|
parent::setUp();
|
|
|
|
$uniq = uniqid();
|
|
$this->relativePackagesPath = "storage/framework/testing/stale-manifest-{$uniq}/packages.php";
|
|
$this->relativeServicesPath = "storage/framework/testing/stale-manifest-{$uniq}/services.php";
|
|
$this->packagesPath = base_path($this->relativePackagesPath);
|
|
$this->servicesPath = base_path($this->relativeServicesPath);
|
|
|
|
File::ensureDirectoryExists(dirname($this->packagesPath));
|
|
|
|
$this->setEnv('APP_PACKAGES_CACHE', $this->relativePackagesPath);
|
|
$this->setEnv('APP_SERVICES_CACHE', $this->relativeServicesPath);
|
|
|
|
// 부모 PHPUnit 프로세스에 다른 테스트가 남긴 플래그가 있으면 대조군(R4)이 무의미해진다.
|
|
$this->setEnv('G7_UPDATE_IN_PROGRESS', null);
|
|
}
|
|
|
|
protected function tearDown(): void
|
|
{
|
|
foreach ($this->originalEnv as $key => $value) {
|
|
if ($value === null) {
|
|
unset($_ENV[$key], $_SERVER[$key]);
|
|
putenv($key);
|
|
} else {
|
|
$_ENV[$key] = $value;
|
|
$_SERVER[$key] = $value;
|
|
putenv($key.'='.$value);
|
|
}
|
|
}
|
|
$this->originalEnv = [];
|
|
|
|
$dir = dirname($this->packagesPath);
|
|
if (File::isDirectory($dir)) {
|
|
File::deleteDirectory($dir);
|
|
}
|
|
|
|
parent::tearDown();
|
|
}
|
|
|
|
/**
|
|
* 계층 ①: 부모는 자식이 부팅에 실패하더라도 그 전에 두 매니페스트를 비운다.
|
|
*
|
|
* 자식을 확실히 실패시키려고 `php_binary` 를 존재하지 않는 경로로 둔다 — 정리는
|
|
* `proc_open` 앞에서 일어나므로 자식의 성패와 무관하게 관측된다.
|
|
*
|
|
* @effects spawnUpgradeStepsProcess_clears_package_manifests_before_proc_open
|
|
*/
|
|
#[Test]
|
|
public function spawn_직전에_패키지_매니페스트를_비운다_자식이_부팅하지_못해도(): void
|
|
{
|
|
if (! function_exists('proc_open')) {
|
|
$this->markTestSkipped('proc_open 미지원 환경');
|
|
}
|
|
|
|
config(['app.update.spawn_failure_mode' => 'abort']);
|
|
config(['process.php_binary' => base_path('storage/framework/testing/no-such-php-binary')]);
|
|
|
|
$this->writeStaleManifests();
|
|
|
|
$this->assertSame($this->packagesPath, $this->app->getCachedPackagesPath(), '전제: APP_PACKAGES_CACHE 가 경로를 정한다');
|
|
$this->assertFileExists($this->packagesPath, '전제: 부모 시점에 packages.php 가 존재한다');
|
|
$this->assertFileExists($this->servicesPath, '전제: 부모 시점에 services.php 가 존재한다');
|
|
|
|
try {
|
|
$this->invokeSpawn();
|
|
$this->fail('자식이 부팅할 수 없으므로 abort 모드에서 UpgradeHandoffException 이 발생해야 한다');
|
|
} catch (UpgradeHandoffException) {
|
|
// 기대된 경로 — 아래 단언이 본 검증이다.
|
|
}
|
|
|
|
$this->assertFileDoesNotExist($this->packagesPath, 'spawn 전에 packages.php 를 비워야 자식이 새 vendor 기준으로 다시 만든다');
|
|
$this->assertFileDoesNotExist($this->servicesPath, 'spawn 전에 services.php 도 함께 비워야 한다');
|
|
}
|
|
|
|
/**
|
|
* 계층 ①: stale dev 매니페스트가 있어도 자식은 정상 부팅해 스텝 0건을 통과한다.
|
|
*
|
|
* 계층 ①②가 모두 없으면 자식이 `Class ... not found` 로 죽어 abort 예외가 난다.
|
|
*
|
|
* @effects spawn_child_boots_with_regenerated_package_manifest_when_parent_left_stale_dev_manifest
|
|
*/
|
|
#[Test]
|
|
public function stale_dev_매니페스트가_있어도_spawn_자식은_정상_부팅해_스텝_0건을_통과한다(): void
|
|
{
|
|
if (! function_exists('proc_open')) {
|
|
$this->markTestSkipped('proc_open 미지원 환경');
|
|
}
|
|
|
|
config(['app.update.spawn_failure_mode' => 'abort']);
|
|
|
|
$this->writeStaleManifests();
|
|
|
|
$result = $this->invokeSpawn();
|
|
|
|
$this->assertTrue($result, 'stale 매니페스트가 정리되면 자식은 정상 부팅해 스텝 0건으로 성공해야 한다');
|
|
$this->assertStringNotContainsString(
|
|
'NonExistentServiceProvider',
|
|
(string) @file_get_contents($this->packagesPath),
|
|
'재생성된 매니페스트에 존재하지 않는 provider 가 남아 있으면 안 된다'
|
|
);
|
|
}
|
|
|
|
/**
|
|
* 계층 ②: 업데이트 플래그를 물려받은 자식은 부모가 비우지 않았어도 스스로 비우고 부팅한다.
|
|
*
|
|
* 7.0.11 미만 부모(이미 배포된 7.0.9·7.0.10)는 spawn 직전에 비우지 않으므로, 그 부모
|
|
* 아래에서 도는 신버전 자식에게는 이것이 유일한 방어다. 부모 역할은 `proc_open` 으로
|
|
* 직접 재현한다 — 정리 없이 stale 매니페스트를 남긴 채 자식을 띄운다.
|
|
*
|
|
* @effects bootstrap_app_unlinks_stale_package_manifest_when_update_flag_present
|
|
*/
|
|
#[Test]
|
|
public function 업데이트_플래그가_있는_자식은_stale_매니페스트를_스스로_지우고_부팅한다(): void
|
|
{
|
|
if (! function_exists('proc_open')) {
|
|
$this->markTestSkipped('proc_open 미지원 환경');
|
|
}
|
|
|
|
$this->writeStaleManifests();
|
|
|
|
[$exitCode, $output] = $this->runArtisanChild(['G7_UPDATE_IN_PROGRESS' => '1']);
|
|
|
|
$this->assertSame(0, $exitCode, "업데이트 플래그가 있는 자식은 stale 매니페스트를 스스로 지우고 부팅해야 한다. 출력:\n{$output}");
|
|
$this->assertStringNotContainsString('NonExistentServiceProvider', $output, '자가 치유 후에는 없는 provider 를 참조하지 않는다');
|
|
}
|
|
|
|
/**
|
|
* 대조군: 업데이트 트리 밖 프로세스(웹 요청·큐 워커·운영자 셸)는 매니페스트를 건드리지 않는다.
|
|
*
|
|
* 자가 치유가 트리 밖으로 새면 평상시 모든 부팅이 매니페스트를 지웠다 다시 만들게 된다.
|
|
* 이 테스트는 계층 ② 도입 전후로 항상 green 이어야 한다.
|
|
*
|
|
* @effects bootstrap_app_leaves_package_manifest_untouched_without_update_flag
|
|
*/
|
|
#[Test]
|
|
public function 업데이트_플래그가_없는_프로세스는_매니페스트를_건드리지_않는다(): void
|
|
{
|
|
if (! function_exists('proc_open')) {
|
|
$this->markTestSkipped('proc_open 미지원 환경');
|
|
}
|
|
|
|
$this->writeStaleManifests();
|
|
$before = md5_file($this->packagesPath);
|
|
|
|
[$exitCode, $output] = $this->runArtisanChild(['G7_UPDATE_IN_PROGRESS' => null]);
|
|
|
|
$this->assertNotSame(0, $exitCode, '플래그 없는 자식은 stale 매니페스트 그대로 부팅해 실패해야 한다 (자가 치유가 트리 밖으로 새지 않았다는 증거)');
|
|
$this->assertStringContainsString('NonExistentServiceProvider', $output, '실패 원인이 stale provider 여야 한다');
|
|
$this->assertFileExists($this->packagesPath, '트리 밖 프로세스는 매니페스트를 지우지 않는다');
|
|
$this->assertSame($before, md5_file($this->packagesPath), '매니페스트 내용이 변경되지 않아야 한다');
|
|
}
|
|
|
|
/**
|
|
* 존재하지 않는 provider 를 등재한 stale 매니페스트 두 개를 만든다.
|
|
*/
|
|
private function writeStaleManifests(): void
|
|
{
|
|
File::ensureDirectoryExists(dirname($this->packagesPath));
|
|
|
|
File::put($this->packagesPath, "<?php return ['tests/stale-fixture' => ['providers' => ['Tests\\\\Fixtures\\\\Stale\\\\NonExistentServiceProvider']]];\n");
|
|
File::put($this->servicesPath, "<?php return ['providers' => ['Tests\\\\Fixtures\\\\Stale\\\\NonExistentServiceProvider'], 'eager' => ['Tests\\\\Fixtures\\\\Stale\\\\NonExistentServiceProvider'], 'deferred' => [], 'when' => []];\n");
|
|
|
|
clearstatcache();
|
|
}
|
|
|
|
/**
|
|
* `spawnUpgradeStepsProcess` 를 리플렉션으로 호출합니다.
|
|
*
|
|
* @return bool spawn 성공 여부
|
|
*/
|
|
private function invokeSpawn(): bool
|
|
{
|
|
$command = app(CoreUpdateCommand::class);
|
|
|
|
$input = new ArrayInput([]);
|
|
$output = new BufferedOutput;
|
|
$style = new OutputStyle($input, $output);
|
|
|
|
$reflection = new \ReflectionClass($command);
|
|
$property = $reflection->getProperty('output');
|
|
$property->setAccessible(true);
|
|
$property->setValue($command, $style);
|
|
|
|
if ($reflection->hasProperty('input')) {
|
|
$inputProp = $reflection->getProperty('input');
|
|
$inputProp->setAccessible(true);
|
|
$inputProp->setValue($command, $input);
|
|
}
|
|
|
|
$method = new \ReflectionMethod(CoreUpdateCommand::class, 'spawnUpgradeStepsProcess');
|
|
$method->setAccessible(true);
|
|
|
|
return (bool) $method->invoke($command, '9.9.8', '9.9.9', true, fn () => null);
|
|
}
|
|
|
|
/**
|
|
* `php artisan --version` 을 별도 프로세스로 실행합니다.
|
|
*
|
|
* 운영 코드(`spawnUpgradeStepsProcess`)와 동형으로 `getenv()` 기반 env 합집합을 넘긴다 —
|
|
* `variables_order` 에 `E` 가 없으면 `$_ENV` 만으로는 자식이 캐시 경로 재지정을 못 받는다.
|
|
*
|
|
* @param array<string, string|null> $overrides 덮어쓸 env (null 이면 자식 env 에서 제거)
|
|
* @return array{0: int, 1: string} 종료 코드와 stdout+stderr 합본
|
|
*/
|
|
private function runArtisanChild(array $overrides): array
|
|
{
|
|
$env = array_merge(getenv(), $_ENV);
|
|
foreach ($overrides as $key => $value) {
|
|
if ($value === null) {
|
|
unset($env[$key]);
|
|
} else {
|
|
$env[$key] = $value;
|
|
}
|
|
}
|
|
|
|
$commandLine = sprintf('%s %s --version', escapeshellarg(PHP_BINARY), escapeshellarg(base_path('artisan')));
|
|
|
|
$descriptors = [0 => ['pipe', 'r'], 1 => ['pipe', 'w'], 2 => ['pipe', 'w']];
|
|
$process = proc_open($commandLine, $descriptors, $pipes, base_path(), $env);
|
|
|
|
if (! is_resource($process)) {
|
|
$this->fail('proc_open 자원 생성 실패');
|
|
}
|
|
|
|
fclose($pipes[0]);
|
|
$out = (string) stream_get_contents($pipes[1]);
|
|
$err = (string) stream_get_contents($pipes[2]);
|
|
fclose($pipes[1]);
|
|
fclose($pipes[2]);
|
|
|
|
return [proc_close($process), $out."\n".$err];
|
|
}
|
|
|
|
/**
|
|
* env 를 세 채널($_ENV/$_SERVER/putenv)에 세우고 원값을 복원용으로 보관합니다.
|
|
*
|
|
* @param string $key 환경변수 이름
|
|
* @param string|null $value 세울 값. null 이면 제거
|
|
*/
|
|
private function setEnv(string $key, ?string $value): void
|
|
{
|
|
if (! array_key_exists($key, $this->originalEnv)) {
|
|
$current = $_ENV[$key] ?? $_SERVER[$key] ?? getenv($key);
|
|
$this->originalEnv[$key] = ($current === false || $current === null) ? null : (string) $current;
|
|
}
|
|
|
|
if ($value === null) {
|
|
unset($_ENV[$key], $_SERVER[$key]);
|
|
putenv($key);
|
|
|
|
return;
|
|
}
|
|
|
|
$_ENV[$key] = $value;
|
|
$_SERVER[$key] = $value;
|
|
putenv($key.'='.$value);
|
|
}
|
|
}
|