PHP 8.6: Funcții noi, funcții depreciate și un ghid practic de migrare
Actualizați la PHP 8.6 cu exemple înainte și după pentru funcțiile PHP depreciate, MySQLi, mbstring, CSV, sesiuni și un checklist practic de migrare.
PHP 8.6.0 a fost lansat pe 19 noiembrie 2026. Funcțiile principale sunt interesante, dar pentru dezvoltatorii care întrețin site-uri web reale, întrebarea urgentă este adesea alta: ce linii din codul existent vor începe să emită notificări de depreciere și cum ar trebui rescrise?
Acest ghid pune munca de migrare pe primul loc. Fiecare exemplu identifică un API depreciat, arată un înlocuitor și evidențiază unde o căutare-și-înlocuire mecanică ar fi periculoasă. O notificare de depreciere nu este același lucru cu o eroare fatală imediată: avertizează că un cod necesită atenție, adesea înainte ca o versiune majoră viitoare să elimine API-ul.
1. Verifică runtime-ul înainte de a atinge producția
Rulează aceste comenzi în același mediu PHP care deservește aplicația (PHP din CLI și PHP web pot folosi binare și setări diferite):
php -v
php -m
php --ini
Verifică extensiile folosite de proiect, în special mbstring, mysqli și intl. Verifică dacă framework-ul, CMS-ul, extensiile și mediul de găzduire suportă explicit PHP 8.6; nu deduce compatibilitatea doar pentru că un site pornește.
Într-un mediu de staging, înregistrează toate erorile păstrând în același timp mesajele de diagnostică în afara HTML-ului public:
<?php
error_reporting(E_ALL);
ini_set('log_errors', '1');
ini_set('display_errors', '0');
Aceste setări de runtime sunt utile pentru un test controlat. Preferă configurarea logării la nivel de server pentru mediile cu rulare de lungă durată; asigură-te că logul de erori este inscriptibil și privat. Un mesaj Deprecated este acționabil chiar și atunci când pagina încă se randează.
2. Referință rapidă: API-uri depreciate și ce să folosești în schimb
| Depreciat în PHP 8.6 | Abordare recomandată | Precauție la migrare |
|---|---|---|
is_integer(), is_long() |
is_int() |
Aliasuri directe |
is_double() |
is_float() |
Alias direct |
doubleval() |
floatval() |
Alias direct |
spl_object_hash() |
spl_object_id() |
Tipul de retur se schimbă de la string la int |
mb_ereg(), mb_eregi() |
preg_match() |
Adaptează sintaxa pattern-ului și indicatorii Unicode |
mb_ereg_replace() |
preg_replace() |
Verifică escaping-ul, semantica înlocuirii și erorile |
mysqli_stmt_init() |
mysqli_prepare() |
Pregătește imediat |
mysqli_get_charset() |
mysqli_character_set_name() |
Doar dacă este necesar numele setului de caractere |
SplFileObject::fgetcsv() |
fgetcsv() pe un stream |
Revizuiește poziția în stream și setările CSV |
SplFileObject::fputcsv() |
fputcsv() pe un stream |
Pasează delimiter, enclosure și escape explicit |
strcoll() |
Collator::compare() |
Necesită intl; alege o localizare |
SORT_LOCALE_STRING |
Collator::sort() / asort() |
Comportamentul localizării se poate schimba |
spl_classes() |
ReflectionExtension::getClassNames() |
Inspectează extensia corespunzătoare |
Al treilea argument al define() |
Omite argumentul | Vechiul mod fără sens la majuscule/minuscule a dispărut |
return în finally |
Retur în afara finally |
Evită suprimarea excepțiilor |
Obiect pasat la array_walk() |
get_object_vars() mai întâi |
Editările prin referință s-ar putea să nu mai modifice obiectul |
metaphone() |
O implementare fonetică întreținută | Nu există un înlocuitor direct în core |
Unele API-uri nu au un înlocuitor exact. Migrarea corectă poate necesita schimbarea designului, nu doar redenumirea unei funcții. Consultă lista oficială a deprecărilor PHP 8.6.
3. Aliasuri simple: corecții sigure și rapide
Înainte — depreciat:
<?php
if (is_integer($quantity) && is_double($price)) {
$total = doubleval($price) * $quantity;
}
După:
<?php
if (is_int($quantity) && is_float($price)) {
$total = floatval($price) * $quantity;
}
Aliasurile au aceeași semantică. Nu presupune că is_float(40) este adevărat: un întreg rămâne un întreg. Acest comportament era deja prezent înainte de migrare.
Pentru o sumă de tip string, floatval() este o conversie, nu o reprezentare zecimală sigură pentru bani. Păstrează strategia existentă a proiectului de gestionare a banilor, în loc să o schimbi ca parte a unei actualizări PHP fără legătură.
4. Migrarea expresiilor regulate mbstring
Familia mb_ereg* este depreciată deoarece motorul său subiacent de regex Oniguruma nu mai este întreținut. PHP recomandă PCRE pentru multe cazuri de utilizare, dar dialéctele pattern-urilor nu sunt identice.
Înainte:
<?php
$isReference = mb_ereg('^[0-9]+$', $reference) !== false;
După (doar cifre ASCII):
<?php
$isReference = preg_match('/^[0-9]+$/D', $reference) === 1;
Aici, modificatorul D face ca $ să se potrivească doar la sfârșitul subiectului. Pentru text Unicode, folosește un pattern UTF-8 adecvat și modificatorul u:
<?php
$isName = preg_match('/^\p{L}+(?:[ -]\p{L}+)*$/uD', $name) === 1;
Înainte — înlocuire:
<?php
$clean = mb_ereg_replace('[[:space:]]+', ' ', $text);

După — înlocuire:
<?php
$clean = preg_replace('/\s+/u', ' ', $text);
if ($clean === null) {
throw new RuntimeException('Regular expression failed');
}
Cele două pattern-uri pot diferi în ceea ce privește unele spații albe Unicode. Pentru migrări reale, testează caracterele accentate, liniile noi, UTF-8 invalid, grupurile de capturare și referințele inverse față de datele reale ale proiectului. Nu înlocui în masă fiecare apel mb_ereg fără a revizui expresia.
5. MySQLi: pregătește o instrucțiune într-un singur pas
Înainte — depreciat:
<?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);
După:
<?php
$stmt = mysqli_prepare($mysqli, 'SELECT name FROM users WHERE id = ?');
mysqli_stmt_bind_param($stmt, 'i', $userId);
mysqli_stmt_execute($stmt);
Cu API-ul orientat pe obiecte, folosește $mysqli->prepare($sql) în locul $mysqli->stmt_init() urmat de prepare(). Păstrează gestionarea existentă a erorilor și închide instrucțiunile în mod corespunzător.
API-ul separat mysqli_get_charset() este de asemenea depreciat. Dacă ai nevoie doar de numele setului de caractere curent:
<?php
$charsetName = mysqli_character_set_name($mysqli);
Acesta nu este un înlocuitor pentru toate câmpurile vechiului obiect de informații despre setul de caractere. Dacă codul depinde de metadatele de collation, inspectează de ce are nevoie efectiv și interoghează serverul în mod corespunzător.
6. CSV: înlocuiește metodele CSV depreciate ale SplFileObject
Metodele specifice CSV pe SplFileObject sunt depreciate. Pentru cod nou și migrat, folosește funcțiile bazate pe stream fgetcsv() și fputcsv().
Înainte:
<?php
$file = new SplFileObject($path, 'r');
while (!$file->eof()) {
$row = $file->fgetcsv();
// Process row
}
După:
<?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);
}
Argumentul de escape gol dezactivează mecanismul de escape proprietar al PHP; testează această alegere față de formatul pe care îl exportă sistemul tău sursă. Verifică liniile goale, anteturile, delimiterii, liniile noi încorporate și codificarea. Acest exemplu ilustrează schimbarea API-ului, nu un parser CSV universal.
Pentru scriere, folosește fputcsv($handle, $fields, ',', '"', ''). Păstrează dialectul așteptat al fișierului original.
7. Identitatea obiectului: spl_object_hash() nu este un hash de conținut
Înainte:
<?php
$key = spl_object_hash($object);
După:
<?php
$key = spl_object_id($object);
Înlocuitorul returnează un întreg, nu un string. Dacă cheile sunt serializate, stocate într-o bază de date sau expuse printr-un API, revizuiește mai întâi consumatorii. Niciuna dintre funcții nu produce un identificator persistent între cereri, iar ID-urile pot fi reutilizate după ce obiectele sunt distruse. Pentru o mapare cu chei după identitatea obiectelor vii, ia în considerare SplObjectStorage sau WeakMap, în funcție de cerințele privind durata de viață.
8. Un return în finally poate ascunde eșecuri
Înainte — depreciat și înșelător:
<?php
function loadSettings(): array
{
try {
return readSettings();
} finally {
return []; // Overrides the result and hides exceptions
}
}
După — păstrează curățarea fără a suprascrie rezultatul:

<?php
function loadSettings(): array
{
try {
return readSettings();
} finally {
releaseTemporaryResources();
}
}
Dacă codul original returna intenționat o valoare de rezervă, mută acea decizie într-un bloc catch cu gestionare explicită. Nu înghiți în tăcere o excepție care ar trebui să ajungă la apelant.
9. Sortarea sensibilă la localizare și alte schimbări mai puțin evidente
strcoll() și indicatorul de sortare SORT_LOCALE_STRING sunt depreciate. Alternativa recomandată intl este Collator:
<?php
$collator = new Collator('fr_FR');
$names = ['Émile', 'Alice', 'Zoé'];
$collator->sort($names);
Verifică dacă intl este instalat. Sortarea sensibilă la localizare este o regulă de business: testează ordinea așteptată, în loc să presupui că ICU și o localizare la nivel de proces se vor comporta întotdeauna identic.
Alte elemente de migrare merită atenție explicită:
ArrayIterator: metodele de sortare, indicatorii și serializare precumasort(),ksort(),setFlags()șiserialize()sunt depreciate. Sortează array-ul subiacent sau foloseșteArrayObjectatunci când API-ul său este adecvat; nu presupune că un iterator și un container sunt interschimbabile.- Manipulatoare de sesiune personalizate: implementează atât
create_sid(), cât șivalidateId(), așa cum cer interfețele/comportamentul actualizat. PHP 8.6 activează valori implicite de sesiune mai stricte; testează autentificarea, rotirea sesiunii și persistența. __debugInfo(): folosește un tip de returarraynon-nullable; returnareanullera deja depreciată.define(): elimină al treilea argumentcase_insensitive, chiar și atunci când estefalse.http_build_query()șiarray_walk(): transmiterea de obiecte acolo unde se așteaptă array-uri este depreciată. Convertifică intenționat folosindget_object_vars()sau construiește explicit array-ul dorit.metaphone(): nu există un înlocuitor echivalent integrat în PHP. Alege și testează un algoritm fonetic întreținut, adecvat limbii.- Identificatori rezervați: nume precum
let,is,readonly(funcție) șinamespace(constantă de clasă) au noi restricții de depreciere. Redenumește declarațiile afectate cu grijă. - Reflection: revizuiește obiectele invalide pasate la
ReflectionProperty::setValue()și argumentele de tip obiect furnizate la invocarea metodelor statice.
Consultă ghidul complet de migrare pentru cazuri limită care nu sunt acoperite în această selecție practică.
10. Găsește apelurile depreciate într-un proiect existent
Începe cu un inventar read-only. Pe Linux sau 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
Înlocuiește ./src cu directorul real. Această căutare text poate potrivi comentarii sau string-uri și va rata apelurile dinamice, aliasurile cu spații de nume și alte API-uri depreciate. Este un punct de plecare, nu un analizator static complet.
Pentru o opțiune cross-platform, funcția Find in Files a unui editor poate căuta aceleași nume. Nu edita direct fișierele vendor sau nucleul CMS: actualizează pachetul upstream sau trimite un patch întreținătorului său.
O secvență de migrare reproductibilă
- Înregistrează versiunea PHP curentă și extensiile activate.
- Fă backup la fișiere și baza de date; pregătește o copie de staging.
- Rulează proiectul sub PHP 8.6 cu logarea deprecărilor activată.
- Inventariază avertismentele după fișier și linie, apoi grupează după API.
- Corectează codul first-party cu modificări țintite; actualizează separat dependințele third-party.
- Rerulează testele unit/integrare și traseele importante ale utilizatorilor.
- Verifică formularele, autentificarea, sesiunile, e-mailul, plățile, joburile programate, importul/exportul CSV și accesul la baza de date.
- Implementează cu un plan de rollback; monitorizează logurile de erori după lansare.
Joomla și WordPress: faptul că PHP 8.6 a fost lansat nu înseamnă că fiecare versiune de CMS, extensie sau plugin îl suportă. Confirmă compatibilitatea cu versiunile exacte în uz și testează mai întâi un mediu de staging. Nu folosi actualizarea ca motiv pentru a peticit direct codul de bază sau codul vendor.
11. Ce este de fapt nou în PHP 8.6?
Dincolo de deprecări, lansarea adaugă mai multe funcționalități de limbaj și runtime:
| Funcționalitate | Utilizare practică |
|---|---|
| Aplicare parțială de funcții | Pre-completează argumentele și obține un apelabil pentru cele rămase |
clamp() |
Constrânge o valoare între un minim și un maxim |
\Time\Duration |
Reprezintă timpul scurs, nu o dată calendaristică |
SortDirection |
Exprimă direcția crescătoare/descrescătoare printr-un enum standard |
Io\Poll |
Suportă polling pe stream în bibliotecile de event-loop și I/O |
| Valori implicite pentru proprietăți readonly | Simplifică anumite declarații de clasă imutabile |
Un exemplu mic și imediat util este clamp():
<?php
// Before PHP 8.6
$percentage = min(100, max(0, $input));
// PHP 8.6
$percentage = clamp($input, 0, 100);
Codul este mai ușor de citit, dar prioritatea migrării ar trebui să rămână testarea compatibilității. Celelalte funcționalități nu sunt necesare doar pentru a menține funcționarea unei aplicații existente. Consultă anunțul oficial al lansării.
12. Înainte de a schimba versiunea PHP din producție
Tratează PHP 8.6 ca pe o actualizare controlată, nu ca pe un buton de apăsat pe un server de producție ocupat. O listă de verificare rezonabilă pentru lansare este: CMS și dependențe suportate; extensii disponibile; niciun val neașteptat de deprecări; teste trecute; comportament verificat al bazei de date și al sesiunilor; backup-uri testate; și o procedură de rollback.
Concluzie: PHP 8.6 aduce funcționalități utile, dar deprecările sale sunt adesea locul unde începe munca de întreținere. Corectează mai întâi aliasurile simple, apoi testează migrările comportamentale — în special regex, CSV, sesiuni și operațiuni sensibile la localizare — față de date reale.