PHP 7.4 → 8.5 마이그레이션 실전 — DB 래퍼·복제 지연·엑셀 라이브러리
## 개요
운영 중인 업무 포털을 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` 으로 한다. 안 그러면 `` 단축 태그 파일에서 대량 오탐이 난다.
- 정규식 일괄 치환은 문자열·주석 안까지 건드린다. `token_get_all` 로 토큰 단위 치환이 안전하다.
- 소스 빌드한 PHP 는 `mysqli` 소켓과 `include_path` 기본값이 달라 localhost DB 사이트가 500 이 날 수 있다. 호환 ini 를 함께 배포한다.
게시글 목록
| 제목 | 작성일 | 조회 |
|---|---|---|
| 자체 개발 웹 엔진 nginx-drsoft로 수백 개 도메인 무중단 운영하기 | 264 | |
| Redis Cluster를 활용한 멀티테넌트 환경 세션 관리 시스템 구축 사례 | 83 |