HeuJung
1eedbbdda1
Laravel chunk/each 는 OFFSET 기반이라, 콜백이 행의 필터 소속을 바꾸면 (필터 컬럼을 채우거나 매칭 행을 삭제하면) 다음 조회가 그만큼 앞으로 밀려 미처리 행을 조용히 건너뛴다. 250건/청크 100 이면 정확히 100건이 남는다. 코어·번들 확장 전수 조사로 확정한 6곳을 chunkById(키셋 순회)로 통일했다. 브라우저 검수(28축)에서 계획에 없던 결함 12건이 드러나 같은 사슬에서 수정했다. 이 중 layout_strategy=keep 무효화와 수정 감지 실패 시 "수정 없음" 오보는 사용자 작업 소실에 직결된다. 재발 방지로 audit 룰을 추가했고, 수정 6곳을 원복해 red 6건 / 복원 후 green 0건으로 판별력을 검증했다.
70 lines
2.8 KiB
PHP
70 lines
2.8 KiB
PHP
<?php
|
|
|
|
namespace App\Upgrades;
|
|
|
|
use App\Contracts\Extension\UpgradeStepInterface;
|
|
use App\Extension\UpgradeContext;
|
|
use Illuminate\Support\Facades\DB;
|
|
use Illuminate\Support\Facades\Schema;
|
|
use Illuminate\Support\Str;
|
|
|
|
/**
|
|
* 코어 7.0.0-alpha.15 업그레이드 스텝
|
|
*
|
|
* 기존 사용자 레코드에 UUID v7을 백필하고 NOT NULL 제약을 추가합니다.
|
|
* 신규 설치 시에는 User 모델 boot() creating 이벤트에서 UUID가 자동 생성되므로
|
|
* 이 스텝은 기존 운영 DB 업그레이드 시에만 실질적으로 동작합니다.
|
|
*/
|
|
class Upgrade_7_0_0_alpha_15 implements UpgradeStepInterface
|
|
{
|
|
/**
|
|
* 업그레이드 스텝을 실행합니다.
|
|
*
|
|
* @param UpgradeContext $context 업그레이드 컨텍스트
|
|
* @return void
|
|
*/
|
|
public function run(UpgradeContext $context): void
|
|
{
|
|
if (! Schema::hasColumn('users', 'uuid')) {
|
|
$context->logger->warning('users 테이블에 uuid 컬럼이 없습니다. 마이그레이션을 먼저 실행하세요.');
|
|
|
|
return;
|
|
}
|
|
|
|
// 1. UUID가 없는 기존 레코드에 백필
|
|
$nullCount = DB::table('users')->whereNull('uuid')->count();
|
|
|
|
if ($nullCount > 0) {
|
|
$context->logger->info("UUID 백필 시작: {$nullCount}건의 기존 레코드");
|
|
|
|
// chunkById(키셋 순회) 필수 — 콜백이 필터 컬럼(uuid)을 채우므로 처리된 행이
|
|
// 필터 결과에서 이탈한다. OFFSET 기반 chunk() 는 그만큼 앞으로 밀려 미처리 행을 건너뛴다.
|
|
DB::table('users')->whereNull('uuid')->chunkById(100, function ($users) {
|
|
foreach ($users as $user) {
|
|
DB::table('users')
|
|
->where('id', $user->id)
|
|
->update(['uuid' => Str::orderedUuid()->toString()]);
|
|
}
|
|
});
|
|
|
|
$context->logger->info("UUID 백필 완료: {$nullCount}건 처리");
|
|
} else {
|
|
$context->logger->info('모든 사용자 레코드에 UUID가 이미 존재합니다.');
|
|
}
|
|
|
|
// 2. NOT NULL 제약 추가 (아직 nullable인 경우)
|
|
$columnType = DB::selectOne("SHOW COLUMNS FROM {$context->table('users')} WHERE Field = 'uuid'");
|
|
|
|
if ($columnType && $columnType->Null === 'YES') {
|
|
// unique 인덱스는 add_uuid_to_users_table 마이그레이션이 이미 생성했다.
|
|
// change() 에 ->unique() 를 함께 붙이면 동일 이름의 인덱스를 다시 만들려 해
|
|
// "Duplicate key name" 으로 실패한다 (MODIFY COLUMN 은 기존 인덱스를 보존).
|
|
Schema::table('users', function ($table) {
|
|
$table->uuid('uuid')->nullable(false)->change();
|
|
});
|
|
|
|
$context->logger->info('uuid 컬럼에 NOT NULL 제약을 추가했습니다.');
|
|
}
|
|
}
|
|
}
|