PHP 8.6: 새로운 기능, 사용 중단된 함수, 그리고 실용적인 마이그레이션 가이드
PHP 8.6으로 업그레이드하고, 사용 중단된 PHP 함수, MySQLi, mbstring, CSV, 세션에 대한 전후 예시와 실용적인 마이그레이션 체크리스트를 제공합니다.
PHP 8.6.0은 2026년 11월 19일에 출시되었습니다. 주요 기능은 흥미롭지만, 실제 웹사이트를 유지하는 개발자에게는 종종 더 시급한 질문이 다릅니다: 기존 코드의 어떤 줄이 더 이상 사용되지 않음 알림을 내보내기 시작할지, 그리고 어떻게 다시 작성해야 할까요?
이 가이드는 마이그레이션 작업을 우선시합니다. 각 예시는 더 이상 사용되지 않는 API를 식별하고, 대체 방법을 보여주며, 기계적인 검색-치환이 위험할 수 있는 부분을 강조합니다. 더 이상 사용되지 않음 알림은 즉각적인 치명적 오류와 다릅니다: 코드에 주의가 필요함을 경고하며, 종종 미래의 메이저 버전이 API를 제거하기 전에 발생합니다.
1. Check your runtime before touching production
애플리케이션을 제공하는 동일한 PHP 환경에서 이러한 명령을 실행하세요(CLI와 웹 PHP는 서로 다른 바이너리와 설정을 사용할 수 있습니다):
php -v
php -m
php --ini
프로젝트가 사용하는 확장 기능을 확인하세요. 특히 mbstring, mysqli 및 intl을 확인하세요. 프레임워크, CMS, 확장 기능 및 호스팅 환경이 PHP 8.6을 명시적으로 지원하는지 확인하세요. 사이트가 시작된다고 해서 호환성을 추론하지 마세요.
스테이징 환경에서는 모든 오류를 로그에 기록하되, 진단 메시지는 공개 HTML에 노출되지 않도록 하세요:
<?php
error_reporting(E_ALL);
ini_set('log_errors', '1');
ini_set('display_errors', '0');
이러한 런타임 설정은 제어된 테스트에 유용합니다. 장기 실행 환경에서는 서버 수준에서 로깅을 구성하는 것을 선호하세요. 오류 로그가 쓰기 가능하고 비공개인지 확인하세요. 페이지가 여전히 렌더링되더라도 Deprecated 메시지는 조치 가능한 정보입니다.
2. Quick reference: deprecated APIs and what to use instead
| PHP 8.6에서 더 이상 사용되지 않음 | 권장 방법 | 마이그레이션 주의사항 |
|---|---|---|
is_integer(), is_long() |
is_int() |
직접 별칭 |
is_double() |
is_float() |
직접 별칭 |
doubleval() |
floatval() |
직접 별칭 |
spl_object_hash() |
spl_object_id() |
반환 타입이 string에서 int로 변경 |
mb_ereg(), mb_eregi() |
preg_match() |
패턴 구문 및 Unicode 플래그 조정 |
mb_ereg_replace() |
preg_replace() |
이스케이프, 대체 의미론 및 오류 확인 |
mysqli_stmt_init() |
mysqli_prepare() |
즉시 준비 |
mysqli_get_charset() |
mysqli_character_set_name() |
charset 이름이 필요한 경우에만 |
SplFileObject::fgetcsv() |
fgetcsv() on a stream |
스트림 위치 및 CSV 설정 검토 |
SplFileObject::fputcsv() |
fputcsv() on a stream |
구분 기호, 인클로저 및 이스케이프를 명시적으로 전달 |
strcoll() |
Collator::compare() |
intl 필요; 로케일 선택 |
SORT_LOCALE_STRING |
Collator::sort() / asort() |
로케일 동작이 변경될 수 있음 |
spl_classes() |
ReflectionExtension::getClassNames() |
적절한 확장 기능 검사 |
define()의 세 번째 인수 |
인수 생략 | 예전 대소문자 구분 무시 모드는 제거됨 |
finally 내의 return |
finally 외부에서 반환 |
예외 억제 피하기 |
array_walk()에 전달된 객체 |
먼저 get_object_vars() |
참조에 의한 편집이 더 이상 객체를 변경하지 않을 수 있음 |
metaphone() |
유지 관리되는 음성 구현 | 코어 직접 대체 없음 |
일부 API에는 정확한 대체 방법이 없습니다. 올바른 마이그레이션은 함수 이름을 바꾸는 것이 아니라 설계를 변경해야 할 수 있습니다. 공식 PHP 8.6 더 이상 사용되지 않는 기능 목록을 참조하세요.
3. Simple aliases: safe, fast fixes
Before — deprecated:
<?php
if (is_integer($quantity) && is_double($price)) {
$total = doubleval($price) * $quantity;
}
After:
<?php
if (is_int($quantity) && is_float($price)) {
$total = floatval($price) * $quantity;
}
이 별칭들은 동일한 의미론을 가집니다. is_float(40)이 true라고 가정하지 마세요: 정수는 여전히 정수입니다. 이 동작은 마이그레이션 전에도 이미 존재했습니다.
문자열 금액의 경우, floatval()은 변환이며, 돈에 안전한 십진수 표현이 아닙니다. 관련 없는 PHP 업그레이드의 일부로 변경하기보다 프로젝트의 기존 금액 처리 전략을 유지하세요.
4. Migrating mbstring regular expressions
mb_ereg* 계열은 기본 Oniguruma 정규 표현식 엔진이 더 이상 유지 관리되지 않기 때문에 더 이상 사용되지 않습니다. PHP는 많은 사용 사례에 대해 PCRE를 권장하지만, 패턴 방언은 동일하지 않습니다.
Before:
<?php
$isReference = mb_ereg('^[0-9]+$', $reference) !== false;
After (ASCII digits only):
<?php
$isReference = preg_match('/^[0-9]+$/D', $reference) === 1;
여기서 D 수정자는 $이 대상의 끝에서만 일치하도록 합니다. Unicode 텍스트의 경우 적절한 UTF-8 패턴과 u 수정자를 사용하세요:
<?php
$isName = preg_match('/^\p{L}+(?:[ -]\p{L}+)*$/uD', $name) === 1;
Before — replacement:
<?php
$clean = mb_ereg_replace('[[:space:]]+', ' ', $text);

After — replacement:
<?php
$clean = preg_replace('/\s+/u', ' ', $text);
if ($clean === null) {
throw new RuntimeException('Regular expression failed');
}
두 패턴은 일부 Unicode 공백에서 다를 수 있습니다. 실제 마이그레이션에서는 악센트 문자, 개행, 잘못된 UTF-8, 캡처 그룹 및 역참조를 실제 프로젝트 데이터로 테스트하세요. 표현식을 검토하지 않고 모든 mb_ereg 호출을 대량 교체하지 마세요.
5. MySQLi: prepare a statement in one step
Before — deprecated:
<?php
$stmt = mysqli_stmt_init($mysqli);
mysqli_stmt_prepare($stmt, 'SELECT name FROM users WHERE id = ?');
mysqli_stmt_bind_param($stmt, 'i', $userId);
mysqli_stmt_execute($stmt);
After:
<?php
$stmt = mysqli_prepare($mysqli, 'SELECT name FROM users WHERE id = ?');
mysqli_stmt_bind_param($stmt, 'i', $userId);
mysqli_stmt_execute($stmt);
객체 지향 API에서는 $mysqli->stmt_init()에 이어 prepare()을 사용하는 대신 $mysqli->prepare($sql)을 사용하세요. 기존 오류 처리와 명령문 종료를 적절히 유지하세요.
별도의 mysqli_get_charset() API도 더 이상 사용되지 않습니다. 현재 charset 이름만 필요한 경우:
<?php
$charsetName = mysqli_character_set_name($mysqli);
이것은 이전 charset 정보 객체의 모든 필드를 대체하는 것이 아닙니다. 코드가 정렬 메타데이터에 의존하는 경우, 실제로 필요한 사항을 확인하고 서버에 적절히 쿼리하세요.
6. CSV: replace deprecated SplFileObject CSV methods
SplFileObject의 CSV 전용 메서드는 더 이상 사용되지 않습니다. 새로운 코드와 마이그레이션된 코드에서는 스트림 기반 fgetcsv() 및 fputcsv() 함수를 사용하세요.
Before:
<?php
$file = new SplFileObject($path, 'r');
while (!$file->eof()) {
$row = $file->fgetcsv();
// Process row
}
After:
<?php
$handle = fopen($path, 'rb');
if ($handle === false) {
throw new RuntimeException('Cannot open CSV file');
}
try {
while (($row = fgetcsv($handle, 0, ',', '"', '')) !== false) {
// Process row
}
} finally {
fclose($handle);
}
빈 이스케이프 인수는 PHP의 독점 이스케이프 메커니즘을 비활성화합니다. 소스 시스템이 내보내는 형식에 대해 이 선택을 테스트하세요. 공백 줄, 헤더, 구분 기호, 내장 개행 및 인코딩을 확인하세요. 이 예시는 API 변경을 보여줄 뿐, 보편적인 CSV 파서는 아닙니다.
쓰기에는 fputcsv($handle, $fields, ',', '"', '')을 사용하세요. 원래 파일의 예상 방언을 유지하세요.
7. Object identity: spl_object_hash() is not a content hash
Before:
<?php
$key = spl_object_hash($object);
After:
<?php
$key = spl_object_id($object);
대체 메서드는 정수를 반환하며 문자열이 아닙니다. 키가 직렬화되거나 데이터베이스에 저장되거나 API를 통해 노출되는 경우, 먼저 소비자를 검토하세요. 두 함수 모두 요청 간 지속 가능한 식별자를 생성하지 않으며, 객체가 소멸된 후 ID가 재사용될 수 있습니다. 실시간 객체 ID를 키로 하는 맵의 경우, 수명 요구 사항에 따라 SplObjectStorage 또는 WeakMap을 고려하세요.
8. A return in finally can hide failures
Before — deprecated and misleading:
<?php
function loadSettings(): array
{
try {
return readSettings();
} finally {
return []; // Overrides the result and hides exceptions
}
}
After — preserve cleanup without overriding the result:

<?php
function loadSettings(): array
{
try {
return readSettings();
} finally {
releaseTemporaryResources();
}
}
원래 코드가 의도적으로 폴백을 반환했다면, 명시적 처리가 있는 catch 블록으로 해당 결정을 옮기세요. 호출자에게 도달해야 하는 예외를 침묵하지 마세요.
9. Locale-sensitive sorting and other less obvious changes
strcoll() 및 SORT_LOCALE_STRING 정렬 플래그는 더 이상 사용되지 않습니다. 권장 intl 대체 방법은 Collator입니다:
<?php
$collator = new Collator('fr_FR');
$names = ['Émile', 'Alice', 'Zoé'];
$collator->sort($names);
intl이 설치되어 있는지 확인하세요. 로케일 기반 정렬은 비즈니스 규칙입니다: ICU와 프로세스 전역 로케일이 항상 동일하게 동작한다고 가정하기보다 예상되는 순서를 테스트하세요.
다른 마이그레이션 항목은 명시적인 주의가 필요합니다:
ArrayIterator: 정렬, 플래그 및asort(),ksort(),setFlags(),serialize()과 같은 직렬화 메서드는 더 이상 사용되지 않습니다. 기본 배열을 정렬하거나 API가 적절한 경우ArrayObject을 사용하세요. 이터레이터와 컨테이너가 교환 가능하다고 가정하지 마세요.- 사용자 정의 세션 핸들러: 업데이트된 인터페이스/동작에 따라
create_sid()과validateId()을 모두 구현하세요. PHP 8.6은 더 엄격한 세션 기본값을 활성화합니다. 로그인, 세션 로테이션 및 지속성을 테스트하세요. __debugInfo(): null을 허용하지 않는array반환 타입을 사용하세요.null반환은 이미 더 이상 사용되지 않았습니다.define(): 세 번째case_insensitive인수를 제거하세요.false인 경우에도 마찬가지입니다.http_build_query()및array_walk(): 배열이 예상되는 곳에 객체를 전달하는 것은 더 이상 사용되지 않습니다.get_object_vars()을 사용하여 의도적으로 변환하거나 원하는 배열을 명시적으로 구성하세요.metaphone(): 동등한 PHP 내장 대체 방법이 없습니다. 유지 관리되는 언어 적합한 음성 알고리즘을 선택하고 테스트하세요.- 예약된 식별자:
let,is,readonly(함수) 및namespace(클래스 상수)과 같은 이름에는 새로운 더 이상 사용되지 않음 제한이 있습니다. 영향을 받는 선언을 주의 깊게 이름을 바꾸세요. - 리플렉션:
ReflectionProperty::setValue()에 전달된 잘못된 객체와 정적 메서드 호출 시 제공된 객체 인수를 검토하세요.
이 실용적인 선택에서 다루지 않는 특수 사례에 대해서는 전체 마이그레이션 가이드를 참조하세요.
10. Find deprecated calls in an existing project
읽기 전용 인벤토리부터 시작하세요. Linux 또는 macOS에서:
grep -RnE --include='*.php' \
'is_integer\(|is_long\(|is_double\(|doubleval\(|spl_object_hash\(|mb_ereg\(|mb_ereg_replace\(|mysqli_stmt_init\(|mysqli_get_charset\(' \
./src
./src을 실제 디렉터리로 교체하세요. 이 텍스트 검색은 주석이나 문자열에 일치할 수 있으며, 동적 호출, 네임스페이스 별칭 및 기타 더 이상 사용되지 않는 API는 놓칠 수 있습니다. 시작점일 뿐, 완전한 정적 분석기는 아닙니다.
교차 플랫폼 옵션으로, 편집기의 파일 내 찾기를 사용하여 동일한 이름을 검색할 수 있습니다. vendor 또는 CMS 핵심 파일을 직접 수정하지 마세요: 상류 패키지를 업데이트하거나 유지 관리자에게 패치를 제출하세요.
재현 가능한 마이그레이션 순서
- 현재 PHP 버전과 활성화된 확장 기능을 기록하세요.
- 파일과 데이터베이스를 백업하고 스테이징 사본을 준비하세요.
- 더 이상 사용되지 않음 로깅을 활성화하여 PHP 8.6에서 프로젝트를 실행하세요.
- 파일 및 줄별로 경고를 인벤토리한 다음 API별로 그룹화하세요.
- 타겟된 변경으로 자체 코드를 수정하고 서드 파티 의존성은 별도로 업데이트하세요.
- 단위/통합 테스트와 중요한 사용자 여정을 다시 실행하세요.
- 폼, 로그인, 세션, 이메일, 결제, 예약 작업, CSV 가져오기/내보내기 및 데이터베이스 액세스를 확인하세요.
- 롤백 계획과 함께 배포하세요. 릴리스 후 오류 로그를 모니터링하세요.
Joomla 및 WordPress: PHP 8.6이 출시되었다고 해서 모든 CMS 버전, 확장 기능 또는 플러그인이 이를 지원하는 것은 아닙니다. 사용 중인 정확한 버전과의 호환성을 확인하고 먼저 스테이징 환경에서 테스트하세요. 업그레이드를 핑계로 핵심 또는 vendor 코드를 직접 패치하는 이유로 사용하지 마세요.
11. What is actually new in PHP 8.6?
더 이상 사용되지 않는 기능 외에도, 이 릴리스는 여러 언어 및 런타임 기능을 추가합니다:
| 기능 | 실용적 용도 |
|---|---|
| 부분 함수 적용 | 인수를 미리 채우고 나머지 인수에 대한 콜러블을 얻음 |
clamp() |
값을 최소값과 최대값 사이에서 제약 |
\Time\Duration |
캘린더 날짜가 아닌 경과 시간 표현 |
SortDirection |
표준 열거형을 통해 오름차순/내림차순 방향 표현 |
Io\Poll |
이벤트 루프 및 I/O 라이브러리에서 스트림 폴링 지원 |
| readonly 프로퍼티 기본값 | 선택한 불변 클래스 선언 단순화 |
작으면서 즉시 유용한 예시는 clamp()입니다:
<?php
// Before PHP 8.6
$percentage = min(100, max(0, $input));
// PHP 8.6
$percentage = clamp($input, 0, 100);
코드는 읽기 쉬워지지만, 마이그레이션 우선순위는 여전히 호환성 테스트여야 합니다. 다른 기능들은 기존 애플리케이션을 작동 유지하기 위해 필수적이지 않습니다. 공식 릴리스 발표를 참조하세요.
12. Before you switch the production PHP version
PHP 8.6을 바쁜 프로덕션 서버에서 클릭할 버튼이 아닌 제어된 업그레이드로 간주하세요. 합리적인 릴리스 체크리스트는 다음과 같습니다: 지원되는 CMS와 의존성; 사용 가능한 확장 기능; 예기치 않은 더 이상 사용되지 않음 홍수 없음; 테스트 통과; 검증된 데이터베이스 및 세션 동작; 테스트된 백업; 롤백 절차.
결론: PHP 8.6은 유용한 기능을 가져오지만, 더 이상 사용되지 않는 기능은 종종 유지 관리 작업의 시작점입니다. 간단한 별칭부터 먼저 수정한 다음, 실제 데이터로 정규 표현식, CSV, 세션 및 로케일 기반 연산과 같은 행동 마이그레이션을 테스트하세요.