Web și dezvoltare

PHP 8.6: Funcții noi, funcții depreciate și un ghid practic de migrare

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

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.

Cale de migrare PHP 8.6: inventar, staging, loguri, corecții și teste de regresie

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

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:

Technical workflow illustration
<?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 precum asort(), ksort(), setFlags() și serialize() sunt depreciate. Sortează array-ul subiacent sau folosește ArrayObject atunci 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 și validateId(), 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 retur array non-nullable; returnarea null era deja depreciată.
  • define(): elimină al treilea argument case_insensitive, chiar și atunci când este false.
  • http_build_query() și array_walk(): transmiterea de obiecte acolo unde se așteaptă array-uri este depreciată. Convertifică intenționat folosind get_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) și namespace (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.

Un flux de lucru sigur pentru migrarea PHP 8.6 cu staging, revizuirea logurilor și testare de regresie

O secvență de migrare reproductibilă

  1. Înregistrează versiunea PHP curentă și extensiile activate.
  2. Fă backup la fișiere și baza de date; pregătește o copie de staging.
  3. Rulează proiectul sub PHP 8.6 cu logarea deprecărilor activată.
  4. Inventariază avertismentele după fișier și linie, apoi grupează după API.
  5. Corectează codul first-party cu modificări țintite; actualizează separat dependințele third-party.
  6. Rerulează testele unit/integrare și traseele importante ale utilizatorilor.
  7. Verifică formularele, autentificarea, sesiunile, e-mailul, plățile, joburile programate, importul/exportul CSV și accesul la baza de date.
  8. 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.

Surse oficiale