PHP 8.6: Nye funktioner, forældede funktioner og en praktisk migrationsguide
Opgrader til PHP 8.6 med før- og efter-eksempler for forældede PHP-funktioner, MySQLi, mbstring, CSV, sessioner og en praktisk migrationscheckliste.
PHP 8.6.0 blev udgivet den 19. november 2026. De mest fremhævede funktioner er interessante, men for udviklere, der vedligeholder rigtige websteder, er det akutte spørgsmål ofte et andet: hvilke linjer af eksisterende kode vil begynde at udstøde forældelsesmeddelelser, og hvordan skal de omskrives?
Denne guide sætter migrationsarbejdet først. Hvert eksempel identificerer et forældet API, viser en erstatning og fremhæver, hvor en mekanisk søg-og-erstat ville være farlig. En forældelsesmeddelelse er ikke det samme som en umiddelbar fatal fejl: den advarer om, at koden har brug for opmærksomhed, ofte før en fremtidig major version fjerner API'et.
1. Kontroller din runtime før du rører ved produktion
Kør disse kommandoer i det samme PHP-miljø, der tjener applikationen (CLI og web PHP kan bruge forskellige binære filer og indstillinger):
php -v
php -m
php --ini
Kontroller udvidelser, der bruges af projektet, især mbstring, mysqli og intl. Verificér at framework, CMS, udvidelser og hosting-miljø eksplicit understøtter PHP 8.6; konkludér ikke kompatibilitet blot fordi et websted starter.
I et staging-miljø, log alle fejl mens du holder diagnosticeringsmeddelelser væk fra offentlig HTML:
<?php
error_reporting(E_ALL);
ini_set('log_errors', '1');
ini_set('display_errors', '0');
Disse runtime-indstillinger er nyttige til en kontrolleret test. Foretræk at konfigurere logging på serverniveau til længerevarende miljøer; sørg for, at fejlloggen er skrivbar og privat. En Deprecated besked kan handhæves, selv når siden stadig gengives.
2. Hurtig reference: forældede APIs og hvad man skal bruge i stedet
| Forældet i PHP 8.6 | Anbefalet tilgang | Migrationsforbehold |
|---|---|---|
is_integer(), is_long() |
is_int() |
Direkte aliaser |
is_double() |
is_float() |
Direkte alias |
doubleval() |
floatval() |
Direkte alias |
spl_object_hash() |
spl_object_id() |
Returtype ændres fra string til int |
mb_ereg(), mb_eregi() |
preg_match() |
Tilpas mønstersyntaks og Unicode-flags |
mb_ereg_replace() |
preg_replace() |
Kontroller escaping, erstatningssemantik og fejl |
mysqli_stmt_init() |
mysqli_prepare() |
Forbered straks |
mysqli_get_charset() |
mysqli_character_set_name() |
Kun hvis charsets navn er nødvendigt |
SplFileObject::fgetcsv() |
fgetcsv() på en stream |
Genovervej stream-position og CSV-indstillinger |
SplFileObject::fputcsv() |
fputcsv() på en stream |
Angiv delimiter, enclosure og escape eksplicit |
strcoll() |
Collator::compare() |
Kræver intl; vælg et locale |
SORT_LOCALE_STRING |
Collator::sort() / asort() |
Locale-adfærd kan ændre sig |
spl_classes() |
ReflectionExtension::getClassNames() |
Undersøg den passende udvidelse |
Tredje argument i define() |
Udlad argumentet | Den gamle case-insensitive mode er væk |
return i finally |
Returnér udenfor finally |
Undgå at undertrykke undtagelser |
Objekt sendt til array_walk() |
get_object_vars() først |
By-reference ændringer muterer muligvis ikke længere objektet |
metaphone() |
En vedligeholdt fonetisk implementering | Ingen drop-in core-erstatning |
Nogle APIs har ingen præcis erstatning. Den korrekte migration kan kræve at ændre designet frem for at omdøbe en funktion. Se den officielle PHP 8.6 forældelsesliste.
3. Enkle aliaser: sikre, hurtige rettelser
Før — forældet:
<?php
if (is_integer($quantity) && is_double($price)) {
$total = doubleval($price) * $quantity;
}
Efter:
<?php
if (is_int($quantity) && is_float($price)) {
$total = floatval($price) * $quantity;
}
Aliasserne har samme semantik. Antag ikke, at is_float(40) er sandt: en integer forbliver en integer. Den adfærd var allerede tilstede før migrationen.
For et string-beløb er floatval() en konvertering, ikke en penge-sikker decimal-repræsentation. Bevar projektets eksisterende penge-håndteringsstrategi frem for at ændre den som en del af en urelateret PHP-opgradering.
4. Migrering af mbstring regulære udtryk
mb_ereg*-familien er forældet, fordi dens underliggende Oniguruma regex-motor ikke længere vedligeholdes. PHP anbefaler PCRE til mange brugssager, men mønsterdialekterne er ikke identiske.
Før:
<?php
$isReference = mb_ereg('^[0-9]+$', $reference) !== false;
Efter (kun ASCII-cifre):
<?php
$isReference = preg_match('/^[0-9]+$/D', $reference) === 1;
Her gør D-modifikatoren, at $ kun matcher i slutningen af subject. Til Unicode-tekst, brug et passende UTF-8 mønster og u-modifikatoren:
<?php
$isName = preg_match('/^\p{L}+(?:[ -]\p{L}+)*$/uD', $name) === 1;
Før — erstatning:
<?php
$clean = mb_ereg_replace('[[:space:]]+', ' ', $text);

Efter — erstatning:
<?php
$clean = preg_replace('/\s+/u', ' ', $text);
if ($clean === null) {
throw new RuntimeException('Regular expression failed');
}
De to mønstre kan adskille sig på nogle Unicode-whitespace-tegn. Til reelle migrationer, test accenterede tegn, ny linjer, ugyldig UTF-8, capture groups og backreferences mod faktiske projektdata. Mas-omskriv ikke hvert mb_ereg-kald uden at gennemgå udtrykket.
5. MySQLi: forbered et statement i ét trin
Før — forældet:
<?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);
Efter:
<?php
$stmt = mysqli_prepare($mysqli, 'SELECT name FROM users WHERE id = ?');
mysqli_stmt_bind_param($stmt, 'i', $userId);
mysqli_stmt_execute($stmt);
Med det objektorienterede API, brug $mysqli->prepare($sql) i stedet for $mysqli->stmt_init() efterfulgt af prepare(). Bevar din eksisterende fejlhåndtering og luk statements passende.
Det separate mysqli_get_charset() API er også forældet. Hvis du kun har brug for det nuværende charset-navn:
<?php
$charsetName = mysqli_character_set_name($mysqli);
Dette er ikke en erstatning for alle felter i det gamle charset-informationsobjekt. Hvis koden afhænger af collation-metadata, undersøg hvad det faktisk har brug for, og forespørg serveren passende.
6. CSV: erstat forældede SplFileObject CSV-metoder
De CSV-specifikke metoder på SplFileObject er forældet. Til ny og migreret kode, brug de stream-baserede fgetcsv() og fputcsv()-funktioner.
Før:
<?php
$file = new SplFileObject($path, 'r');
while (!$file->eof()) {
$row = $file->fgetcsv();
// Process row
}
Efter:
<?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);
}
Det tomme escape-argument deaktiverer PHPs proprietære escape-mekanisme; test dette valg mod formatet, dit kildesystem eksporterer. Kontroller tomme linjer, headers, delimitere, indlejrede ny linjer og encoding. Dette eksempel illustrerer API-ændringen, ikke en universal CSV-parser.
Til skrivning, brug fputcsv($handle, $fields, ',', '"', ''). Bevar den oprindelige fils forventede dialekt.
7. Objektidentitet: spl_object_hash() er ikke en indholdshash
Før:
<?php
$key = spl_object_hash($object);
Efter:
<?php
$key = spl_object_id($object);
Erstatningen returnerer et integer, ikke en string. Hvis nøgler serialiseres, gemmes i en database eller eksponeres gennem et API, gennemgå forbrugere først. Ingen funktion producerer en persistent identifikator på tværs af anmodninger, og IDs kan genbruges efter objekter er ødelagt. Til et map nøglet af live objektidentitet, overvej SplObjectStorage eller WeakMap, afhængigt af livscykluskrav.
8. Et return i finally kan skjule fejl
Før — forældet og forvirrende:
<?php
function loadSettings(): array
{
try {
return readSettings();
} finally {
return []; // Overrides the result and hides exceptions
}
}
Efter — bevar oprydning uden at overskrive resultatet:

<?php
function loadSettings(): array
{
try {
return readSettings();
} finally {
releaseTemporaryResources();
}
}
Hvis den oprindelige kode bevidst returnerede en fallback, flyt den beslutning ind i en catch-blok med eksplicit håndtering. Slug ikke en undtagelse stil, der bør nå kalderen.
9. Locale-følsom sortering og andre mindre åbenlyse ændringer
strcoll() og SORT_LOCALE_STRING sorterings-flaget er forældet. Den anbefalede intl-alternativ er Collator:
<?php
$collator = new Collator('fr_FR');
$names = ['Émile', 'Alice', 'Zoé'];
$collator->sort($names);
Kontroller at intl er installeret. Locale-medveten sortering er en forretningsregel: test din forventede rækkefølge frem for at antage, at ICU og et proces-globalt locale altid vil opføre sig identisk.
Andre migrationspunkter fortjener eksplicit opmærksomhed:
ArrayIterator: sortering, flags og serialiseringsmetoder somasort(),ksort(),setFlags()ogserialize()er forældet. Sorter det underliggende array eller brugArrayObject, når dets API er passende; antag ikke, at en iterator og en container er udvekselbare.- Brugerdefinerede session-håndterere: implementér både
create_sid()ogvalidateId(), som kræves af de opdaterede interfaces/adfærd. PHP 8.6 aktiverer strengere session-standarder; test login, sessionsrotation og persistence. __debugInfo(): brug en ikke-nullablearray-returtype; at returnerenullvar allerede forældet.define(): fjern det tredjecase_insensitive-argument, selv når det erfalse.http_build_query()ogarray_walk(): at sende objekter, hvor arrays forventes, er forældet. Konverter bevidst ved hjælp afget_object_vars()eller konstruer det ønskede array eksplicit.metaphone(): ingen ækvivalent indbygget PHP-erstatning findes. Vælg og test en vedligeholdt, sprogpassende fonetisk algoritme.- Reserverede identifikatorer: navne som
let,is,readonly(funktion) ognamespace(klassekonstant) har nye forældelsesrestriktioner. Omdøb berørte deklarationer omhyggeligt. - Reflection: gennemgå ugyldige objekter sendt til
ReflectionProperty::setValue()og objektargumenter leveret ved påkald af statiske metoder.
Konsult den fulde migrationsguide for edge cases, der ikke er dækket i dette praktiske udvalg.
10. Find forældede kald i et eksisterende projekt
Start med et skrivebeskyttet inventar. På Linux eller 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
Erstat ./src med den faktiske mappe. Denne tekst-søgning kan matche kommentarer eller strings, og vil mangle dynamiske kald, navnerum-aliasser og andre forældede APIs. Det er et udgangspunkt, ikke en komplet statisk analyzer.
Til en cross-platform mulighed, kan en editors Find in Files søge efter de samme navne. Redigér ikke vendor eller CMS kerne-filer direkte: opdater upstream-pakken eller send et patch til dens vedligeholder.
En reproducerbar migrationssekvens
- Registrer den aktuelle PHP-version og aktiverede udvidelser.
- Sikkerhedskopier filer og database; forbered en staging-kopi.
- Kør projektet under PHP 8.6 med forældelseslogging aktiveret.
- Inventariser advarsler efter fil og linje, grupper derefter efter API.
- Ret first-party kode med målrettede ændringer; opdater third-party afhængigheder separat.
- Kør enheds-/integrations-tests og vigtige brugerrejser igen.
- Kontroller formularer, login, sessioner, e-mail, betalinger, planlagte jobs, CSV import/eksport og databaseadgang.
- Udrul med en rollback-plan; overvåg fejllogge efter release.
Joomla og WordPress: At PHP 8.6 er udgivet betyder ikke, at hver CMS-version, udvidelse eller plugin understøtter det. Bekræft kompatibilitet med de præcise versioner i brug, og test et staging-miljø først. Brug ikke opgraderingen som en grund til at patche kerne- eller vendor-kode direkte.
11. Hvad er faktisk nyt i PHP 8.6?
Udover forældelser tilføjer udgivelsen flere sprog- og runtime-funktioner:
| Funktion | Praktisk anvendelse |
|---|---|
| Partiel funktionsapplikation | Udfyld argumenter forhånd og få et callable til de resterende |
clamp() |
Begræns en værdi mellem et minimum og maksimum |
\Time\Duration |
Repræsenter forløbet tid frem for en kalenderdato |
SortDirection |
Udtryk stigende/faldende retning gennem et standard enum |
Io\Poll |
Understøt stream polling i event-loop og I/O-biblioteker |
| Standarder for readonly properties | Forenkler udvalgte immutable klasse-deklarationer |
Et lille, med det samme nyttigt eksempel er clamp():
<?php
// Before PHP 8.6
$percentage = min(100, max(0, $input));
// PHP 8.6
$percentage = clamp($input, 0, 100);
Koden er lettere at læse, men migrationsprioriteten bør stadig være kompatibilitetstest. De andre funktioner er ikke nødvendige bare for at holde en eksisterende applikation kørende. Se den officielle udgivelsesmeddelelse.
12. Før du skifter produktions-PHP-versionen
Behandl PHP 8.6 som en kontrolleret opgradering, ikke en knap at trykke på en travl produktionsserver. En fornuftig release-checkliste er: understøttet CMS og afhængigheder; tilgængelige udvidelser; ingen uventet forældelses-flod; tests passerer; verificeret database- og sessionsadfærd; testede backups; og en rollback-procedure.
Konklusion: PHP 8.6 bringer nyttige funktioner, men dets forældelser er ofte, hvor vedligeholdelsesarbejdet begynder. Ret de simple aliaser først, test derefter adfærdsmigrationer — især regex, CSV, sessioner og locale-følsomme operationer — mod rigtige data.