Webb & utveckling

PHP 8.6: Nya funktioner, föråldrade funktioner och en praktisk migrationsguide

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

Uppgradera till PHP 8.6 med före- och efterexempel för föråldrade PHP-funktioner, MySQLi, mbstring, CSV, sessioner och en praktisk migrationschecklista.

PHP 8.6.0 släpptes den 19 november 2026. Huvudfunktionerna är intressanta, men för utvecklare som underhåller riktiga webbplatser är den angelägna frågan ofta en annan: vilka rader i befintlig kod börjar avge deprecation-varningar, och hur bör de skrivas om?

Den här guiden sätter migreringsarbetet först. Varje exempel identifierar ett föråldrat API, visar en ersättning och lyfter fram var en mekanisk sök-och-ersätt skulle vara farlig. En deprecation-varning är inte samma sak som ett omedelbart fatalt fel: den varnar för att koden behöver ses över, ofta innan en framtida major-version tar bort API:et.

PHP 8.6 migreringsväg: inventering, staging, loggar, åtgärder och regressionstester

1. Kontrollera din körtid innan du rör produktion

Kör dessa kommandon i samma PHP-miljö som betjänar applikationen (CLI och webb-PHP kan använda olika binärfiler och inställningar):

php -v
php -m
php --ini

Kontrollera de extensioner som projektet använder, särskilt mbstring, mysqli och intl. Verifiera att ramverket, CMS:et, extensionerna och hostingmiljön uttryckligen stöder PHP 8.6; dra inte slutsatsen att det är kompatibelt bara för att en webbplats startar.

I en stagingmiljö, logga alla fel medan diagnostiska meddelanden hålls borta från offentlig HTML:

<?php
error_reporting(E_ALL);
ini_set('log_errors', '1');
ini_set('display_errors', '0');

Dessa körtidsinställningar är användbara för ett kontrollerat test. Föredra att konfigurera loggning på servernivå för långvariga miljöer; se till att felloggen är skrivbar och privat. Ett Deprecated-meddelande är åtgärdbart även när sidan fortfarande renderas.

2. Snabbreferens: föråldrade API:er och vad du bör använda i stället

Föråldrat i PHP 8.6 Rekommenderat tillvägagångssätt Migreringsvarning
is_integer(), is_long() is_int() Direkta alias
is_double() is_float() Direkt alias
doubleval() floatval() Direkt alias
spl_object_hash() spl_object_id() Returtypen ändras från string till int
mb_ereg(), mb_eregi() preg_match() Anpassa mönstersyntax och Unicode-flaggor
mb_ereg_replace() preg_replace() Kontrollera escapehantering, ersättningssemantik och fel
mysqli_stmt_init() mysqli_prepare() Förbered omedelbart
mysqli_get_charset() mysqli_character_set_name() Endast om teckenuppsättningens namn behövs
SplFileObject::fgetcsv() fgetcsv() på en ström Se över strömposition och CSV-inställningar
SplFileObject::fputcsv() fputcsv() på en ström Ange avgränsare, omslutning och escape explicit
strcoll() Collator::compare() Kräver intl; välj en locale
SORT_LOCALE_STRING Collator::sort() / asort() Locale-beteende kan ändras
spl_classes() ReflectionExtension::getClassNames() Inspektera lämplig extension
Tredje argumentet till define() Utelämna argumentet Det gamla skiftlägesokänsliga läget är borta
return i finally Returnera utanför finally Undvik att undertrycka undantag
Objekt som skickas till array_walk() get_object_vars() först Redigeringar via referens kanske inte längre muterar objektet
metaphone() En underhållen fonetisk implementation Ingen direkt ersättning i kärnan

Vissa API:er har ingen exakt ersättning. Den korrekta migreringen kan kräva att designen ändras i stället för att en funktion byter namn. Se den officiella listan över föråldrade funktioner i PHP 8.6.

3. Enkla alias: säkra, snabba åtgärder

Före — föråldrat:

<?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;
}

Aliasen har samma semantik. Anta inte att is_float(40) är true: ett heltal förblir ett heltal. Det beteendet fanns redan före migreringen.

För ett belopp i strängform är floatval() en konvertering, inte en penning-säker decimalrepresentation. Behåll projektets befintliga strategi för penninghantering i stället för att ändra den som en del av en orelaterad PHP-uppgradering.

4. Migrera mbstring-reguljära uttryck

Familjen mb_ereg* är föråldrad eftersom dess underliggande Oniguruma-regexmotor inte längre underhålls. PHP rekommenderar PCRE för många användningsfall, men mönsterdialekterna är inte identiska.

Före:

<?php
$isReference = mb_ereg('^[0-9]+$', $reference) !== false;

Efter (endast ASCII-siffror):

<?php
$isReference = preg_match('/^[0-9]+$/D', $reference) === 1;

Här gör D-modifieraren så att $ endast matchar i slutet av subjektet. För Unicode-text, använd ett lämpligt UTF-8-mönster och u-modifieraren:

<?php
$isName = preg_match('/^\p{L}+(?:[ -]\p{L}+)*$/uD', $name) === 1;

Före — ersättning:

<?php
$clean = mb_ereg_replace('[[:space:]]+', ' ', $text);
Illustration of the article's main concept

Efter — ersättning:

<?php
$clean = preg_replace('/\s+/u', ' ', $text);
if ($clean === null) {
    throw new RuntimeException('Regular expression failed');
}

De två mönstren kan skilja sig åt för viss Unicode-whitespace. För riktiga migreringar, testa accenterade tecken, radbrytningar, ogiltig UTF-8, capture-grupper och backreferences mot faktiska projektdata. Massersätt inte varje mb_ereg-anrop utan att granska uttrycket.

5. MySQLi: förbered en statement i ett steg

Före — föråldrat:

<?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 objektorienterade API:et, använd $mysqli->prepare($sql) i stället för $mysqli->stmt_init() följt av prepare(). Behåll din befintliga felhantering och stäng statements på lämpligt sätt.

Det separata API:et mysqli_get_charset() är också föråldrat. Om du bara behöver det aktuella teckenuppsättningsnamnet:

<?php
$charsetName = mysqli_character_set_name($mysqli);

Detta är inte en ersättning för alla fält i det gamla teckenuppsättningsinformationsobjektet. Om koden är beroende av collation-metadata, inspektera vad den faktiskt behöver och fråga servern på lämpligt sätt.

6. CSV: ersätt föråldrade CSV-metoder i SplFileObject

De CSV-specifika metoderna på SplFileObject är föråldrade. För ny och migrerad kod, använd de strömbaserade funktionerna fgetcsv() och fputcsv().

Före:

<?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 tomma escape-argumentet inaktiverar PHPs proprietära escape-mekanism; testa detta val mot det format som ditt källsystem exporterar. Kontrollera tomma rader, rubriker, avgränsare, inbäddade radbrytningar och kodning. Det här exemplet illustrerar API-ändringen, inte en universell CSV-parser.

För skrivning, använd fputcsv($handle, $fields, ',', '"', ''). Behåll den ursprungliga filens förväntade dialekt.

7. Objektidentitet: spl_object_hash() är inte en innehållshash

Före:

<?php
$key = spl_object_hash($object);

Efter:

<?php
$key = spl_object_id($object);

Ersättningen returnerar ett heltal, inte en sträng. Om nycklar serialiseras, lagras i en databas eller exponeras via ett API, granska konsumenterna först. Ingen av funktionerna producerar en beständig identifierare mellan förfrågningar, och ID:n kan återanvändas efter att objekt har förstörts. För en map med nyckel baserad på levande objektidentitet, överväg SplObjectStorage eller WeakMap, beroende på livstidskrav.

8. En return i finally kan dölja fel

Före — föråldrat och missvisande:

<?php
function loadSettings(): array
{
    try {
        return readSettings();
    } finally {
        return []; // Overrides the result and hides exceptions
    }
}

Efter — behåll städning utan att åsidosätta resultatet:

Technical workflow illustration
<?php
function loadSettings(): array
{
    try {
        return readSettings();
    } finally {
        releaseTemporaryResources();
    }
}

Om den ursprungliga koden avsiktligt returnerade en fallback, flytta det beslutet till ett catch-block med explicit hantering. Svälj inte tyst ett undantag som bör nå anroparen.

9. Locale-känslig sortering och andra mindre uppenbara ändringar

strcoll() och sorteringsflaggan SORT_LOCALE_STRING är föråldrade. Det rekommenderade alternativet intl är Collator:

<?php
$collator = new Collator('fr_FR');
$names = ['Émile', 'Alice', 'Zoé'];
$collator->sort($names);

Kontrollera att intl är installerad. Locale-medveten sortering är en affärsregel: testa din förväntade ordning i stället för att anta att ICU och en processglobal locale alltid beter sig identiskt.

Andra migreringspunkter förtjänar explicit uppmärksamhet:

  • ArrayIterator: sortering, flaggor och serialiseringsmetoder som asort(), ksort(), setFlags() och serialize() är föråldrade. Sortera den underliggande arrayen eller använd ArrayObject när dess API är lämpligt; anta inte att en iterator och en container är utbytbara.
  • Anpassade sessionshanterare: implementera både create_sid() och validateId() enligt de uppdaterade gränssnitten/beteendet. PHP 8.6 aktiverar striktare sessionsstandardvärden; testa inloggning, sessionsrotation och persistens.
  • __debugInfo(): använd en icke-nullbar returtyp array; att returnera null var redan föråldrat.
  • define(): ta bort det tredje case_insensitive-argumentet, även när det är false.
  • http_build_query() och array_walk(): att skicka objekt där arrayer förväntas är föråldrat. Konvertera avsiktligt med get_object_vars() eller konstruera den önskade arrayen explicit.
  • metaphone(): det finns ingen motsvarande inbyggd PHP-ersättning. Välj och testa en underhållen, språklämplig fonetisk algoritm.
  • Reserverade identifierare: namn som let, is, readonly (funktion) och namespace (klasskonstant) har nya begränsningar för föråldrade funktioner. Byt namn på berörda deklarationer försiktigt.
  • Reflection: granska ogiltiga objekt som skickas till ReflectionProperty::setValue() och objektargument som anges vid anrop av statiska metoder.

Se den fullständiga migreringsguiden för kantfall som inte tas upp i detta praktiska urval.

10. Hitta föråldrade anrop i ett befintligt projekt

Börja med en skrivskyddad inventering. 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

Ersätt ./src med den faktiska katalogen. Denna textsökning kan matcha kommentarer eller strängar och kommer att missa dynamiska anrop, namespaced alias och andra föråldrade API:er. Det är en startpunkt, inte en fullständig statisk analysator.

För ett plattformsoberoende alternativ kan en editors Sök i filer söka efter samma namn. Redigera inte vendor- eller CMS-kärnfiler direkt: uppdatera det uppströms paketet eller skicka en patch till dess underhållare.

Ett säkert migreringsarbetsflöde för PHP 8.6 med staging, logggranskning och regressionstestning

En reproducerbar migreringssekvens

  1. Anteckna aktuell PHP-version och aktiverade extensioner.
  2. Säkerhetskopiera filer och databas; förbered en stagingkopia.
  3. Kör projektet under PHP 8.6 med loggning av deprecation-varningar aktiverad.
  4. Inventera varningar per fil och rad, gruppera sedan per API.
  5. Åtgärda förstapartskod med riktade ändringar; uppdatera tredjepartsberoenden separat.
  6. Kör om enhets-/integrationstester och viktiga användarflöden.
  7. Kontrollera formulär, inloggning, sessioner, e-post, betalningar, schemalagda jobb, CSV-import/export och databasåtkomst.
  8. Driftsätt med en återställningsplan; övervaka felloggar efter release.

Joomla och WordPress: att PHP 8.6 släpps betyder inte att varje CMS-version, extension eller plugin stöder det. Bekräfta kompatibilitet med de exakta versioner som används och testa en stagingmiljö först. Använd inte uppgraderingen som en anledning att patcha kärn- eller vendor-kod direkt.

11. Vad är faktiskt nytt i PHP 8.6?

Utöver föråldrade funktioner lägger releasen till flera språk- och körtidsfunktioner:

Funktion Praktisk användning
Partiell funktionsapplikation Förifyll argument och få en callable för de återstående
clamp() Begränsa ett värde mellan ett minimum och ett maximum
\Time\Duration Representera förfluten tid i stället för ett kalenderdatum
SortDirection Uttryck stigande/fallande riktning via en standard-enum
Io\Poll Stöd för strömpolling i event-loop- och I/O-bibliotek
Standardvärden för readonly-egenskaper Förenkla utvalda deklarationer av oföränderliga klasser

Ett litet, omedelbart användbart exempel är clamp():

<?php
// Before PHP 8.6
$percentage = min(100, max(0, $input));

// PHP 8.6
$percentage = clamp($input, 0, 100);

Koden är lättare att läsa, men migreringsprioriteringen bör fortfarande vara kompatibilitetstestning. De andra funktionerna är inte nödvändiga bara för att hålla en befintlig applikation igång. Se det officiella releasemeddelandet.

12. Innan du byter PHP-version i produktion

Behandla PHP 8.6 som en kontrollerad uppgradering, inte som en knapp att klicka på i en belastad produktionsserver. En rimlig checklista för release är: CMS och beroenden som stöds; tillgängliga extensioner; ingen oväntad flod av deprecation-varningar; tester som går igenom; verifierat databas- och sessionsbeteende; testade säkerhetskopior; och en återställningsprocedur.

Kort sagt: PHP 8.6 ger användbara funktioner, men det är ofta i dess föråldrade funktioner som underhållsarbetet börjar. Åtgärda de enkla aliasen först och testa sedan beteendemigreringar—särskilt regex, CSV, sessioner och locale-känsliga operationer—mot riktiga data.

Officiella källor