PHP 7.4 → 8.5 마이그레이션 실전 — DB 래퍼·복제 지연·엑셀 라이브러리

관리자 2026-11-01 22:34 조회 26
## 개요 운영 중인 업무 포털을 PHP 7.4 에서 8.5 로 올리며 발견한 문제들이다. 모델 62개를 CLI 로 읽기·쓰기 전수 테스트했고, 진짜 PHP 8 호환 버그는 아래 몇 가지였다(나머지 "실패"는 테스트가 잘못된 인자 타입을 넘긴 것이었다). ## 1. DB 래퍼의 불리언 결과 `free()` / `next()` / `getCount()` 가 SELECT 가 아닌 쿼리의 결과(`true`)에 `mysqli_free_result`·`mysqli_fetch_array`·`mysqli_num_rows` 를 그대로 호출했다. PHP 8.1 부터 TypeError 다. `instanceof mysqli_result` 가드를 추가해 해결했다. ## 2. 복제 지연이 만드는 레이스 래퍼가 읽기를 슬레이브로 분산하는 구조에서 `insert()` 직후 같은 요청의 `find($id)->update()` 가 **복제가 따라오기 전에 읽어** `false` 를 받고, `update()` 가 크래시했다. `Model::where("id=?", [$id])->update(...)` 로 바꾸면 SELECT 없이 바로 UPDATE 라 레이스가 사라진다. 앱 전체에서 11곳을 고쳤다. ## 3. 제거된 문법 - 중괄호 문자열·배열 오프셋 `$var{N}` → `$var[N]` (19곳) - `=& new` 참조 할당(PHP 7 부터 제거) - 서버 curl 빌드에 없는 상수(`CURLOPT_POSTFIELDSIZE`) 호출 — 어차피 불필요한 줄이라 삭제 ## 4. 엑셀 라이브러리 교체 개발이 중단된 PHPExcel 을 패치하는 대신 PhpSpreadsheet 로 전면 교체했다. 함정은 **좌표**다. - PHPExcel 의 컬럼은 0 기반, PhpSpreadsheet 배열 좌표 `setCellValue([$col,$row], $v)` 는 **1 기반**이라 전부 +1 보정이 필요하다(처음엔 셀이 한 칸씩 밀렸다). - Fill 스타일 키는 `type` → `fillType`, Writer 는 `Excel5`/`Excel2007` → `Xls`/`Xlsx`. - 서버에 composer 를 상주시키지 않고, 임시로 받아 빌드한 `vendor` 만 앱에 포함했다. ## 5. 검증 요령 - 문법 검사는 운영 설정과 같게 `-d short_open_tag=on` 으로 한다. 안 그러면 `
KO