Web & Udvikling

PHP 8.6: Nye funktioner, forældede funktioner og en praktisk migrationsguide

PHP 8.6: New Features, Deprecated Functions, and a Practical Migration Guide

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.

PHP 8.6 migrationssti: inventar, staging, log, rettelser og regressionstests

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);
Illustration of the article's main concept

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:

Technical workflow illustration
<?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 som asort(), ksort(), setFlags() og serialize() er forældet. Sorter det underliggende array eller brug ArrayObject, 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() og validateId(), 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-nullable array-returtype; at returnere null var allerede forældet.
  • define(): fjern det tredje case_insensitive-argument, selv når det er false.
  • http_build_query() og array_walk(): at sende objekter, hvor arrays forventes, er forældet. Konverter bevidst ved hjælp af get_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) og namespace (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 sikker PHP 8.6 migrations-workflow med staging, loggennemgang og regressionstesting

En reproducerbar migrationssekvens

  1. Registrer den aktuelle PHP-version og aktiverede udvidelser.
  2. Sikkerhedskopier filer og database; forbered en staging-kopi.
  3. Kør projektet under PHP 8.6 med forældelseslogging aktiveret.
  4. Inventariser advarsler efter fil og linje, grupper derefter efter API.
  5. Ret first-party kode med målrettede ændringer; opdater third-party afhængigheder separat.
  6. Kør enheds-/integrations-tests og vigtige brugerrejser igen.
  7. Kontroller formularer, login, sessioner, e-mail, betalinger, planlagte jobs, CSV import/eksport og databaseadgang.
  8. 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.

Officielle kilder