Web e sviluppo

PHP 8.6: Nuove Funzionalità, Funzioni Deprecate e una Guida Pratica alla Migrazione

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

Aggiorna a PHP 8.6 con esempi prima e dopo per le funzioni PHP deprecate, MySQLi, mbstring, CSV, sessioni e una checklist pratica di migrazione.

PHP 8.6.0 è stato rilasciato il 19 novembre 2026. Le caratteristiche principali sono interessanti, ma per gli sviluppatori che mantengono siti web reali la domanda urgente è spesso diversa: quali righe di codice esistente inizieranno a emettere avvisi di deprecazione e come dovrebbero essere riscritte?

Questa guida mette il lavoro di migrazione al primo posto. Ogni esempio identifica un'API deprecata, mostra una sostituzione ed evidenzia dove una ricerca-e-sostituzione meccanica sarebbe pericolosa. Un avviso di deprecazione non è la stessa cosa di un errore fatale immediato: avverte che il codice necessita attenzione, spesso prima che una futura versione maggiore rimuova l'API.

Percorso di migrazione PHP 8.6: inventario, staging, log, correzioni e test di regressione

1. Controlla il tuo runtime prima di toccare la produzione

Esegui questi comandi nello stesso ambiente PHP che serve l'applicazione (CLI e PHP web possono usare binari e impostazioni diversi):

php -v
php -m
php --ini

Controlla le estensioni usate dal progetto, in particolare mbstring, mysqli e intl. Verifica che il framework, CMS, estensioni e ambiente di hosting supportino esplicitamente PHP 8.6; non dedurre la compatibilità solo perché un sito si avvia.

In un ambiente di staging, registra tutti gli errori mantenendo i messaggi diagnostici fuori dall'HTML pubblico:

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

Queste impostazioni di runtime sono utili per un test controllato. Preferisci configurare il logging a livello di server per ambienti a lungo termine; assicurati che il log degli errori sia scrivibile e privato. Un messaggio Deprecated è attuabile anche quando la pagina viene ancora renderizzata.

2. Riferimento rapido: API deprecate e cosa usare al loro posto

Deprecato in PHP 8.6 Approccio consigliato Avvertenza sulla migrazione
is_integer(), is_long() is_int() Alias diretti
is_double() is_float() Alias diretto
doubleval() floatval() Alias diretto
spl_object_hash() spl_object_id() Il tipo di ritorno cambia da string a int
mb_ereg(), mb_eregi() preg_match() Adatta la sintassi del pattern e i flag Unicode
mb_ereg_replace() preg_replace() Controlla escaping, semantica di sostituzione ed errori
mysqli_stmt_init() mysqli_prepare() Prepara immediatamente
mysqli_get_charset() mysqli_character_set_name() Solo se serve il nome del charset
SplFileObject::fgetcsv() fgetcsv() su uno stream Rivedi la posizione dello stream e le impostazioni CSV
SplFileObject::fputcsv() fputcsv() su uno stream Passa delimitatore, enclosure ed escape esplicitamente
strcoll() Collator::compare() Richiede intl; scegli una locale
SORT_LOCALE_STRING Collator::sort() / asort() Il comportamento della locale può cambiare
spl_classes() ReflectionExtension::getClassNames() Ispeziona l'estensione appropriata
Terzo argomento di define() Ometti l'argomento La vecchia modalità case-insensitive è sparita
return in finally Return fuori da finally Evita di sopprimere le eccezioni
Oggetto passato a array_walk() get_object_vars() per primo Le modifiche by-reference potrebbero non mutare più l'oggetto
metaphone() Un'implementazione fonetica mantenuta Nessuna sostituzione drop-in nel core

Alcune API non hanno una sostituzione esatta. La migrazione corretta potrebbe richiedere di cambiare il design piuttosto che rinominare una funzione. Vedi la lista ufficiale delle deprecazioni PHP 8.6.

3. Alias semplici: correzioni sicure e veloci

Prima — deprecato:

<?php
if (is_integer($quantity) && is_double($price)) {
    $total = doubleval($price) * $quantity;
}

Dopo:

<?php
if (is_int($quantity) && is_float($price)) {
    $total = floatval($price) * $quantity;
}

Gli alias hanno la stessa semantica. Non assumere che is_float(40) sia vero: un intero rimane un intero. Quel comportamento era già presente prima della migrazione.

Per un importo in stringa, floatval() è una conversione, non una rappresentazione decimale sicura per il denaro. Mantieni la strategia di gestione del denaro esistente del progetto invece di cambiarla come parte di un aggiornamento PHP non correlato.

4. Migrazione delle espressioni regolari mbstring

La famiglia mb_ereg* è deprecata perché il suo motore regex Oniguruma sottostante non è più mantenuto. PHP raccomanda PCRE per molti casi d'uso, ma i dialetti dei pattern non sono identici.

Prima:

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

Dopo (solo cifre ASCII):

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

Qui il modificatore D fa sì che $ corrisponda solo alla fine del soggetto. Per testo Unicode, usa un pattern UTF-8 appropriato e il modificatore u:

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

Prima — sostituzione:

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

Dopo — sostituzione:

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

I due pattern possono differire su alcuni caratteri di spazio bianco Unicode. Per migrazioni reali, testa caratteri accentati, newline, UTF-8 non valido, gruppi di cattura e backreference contro i dati reali del progetto. Non sostituire in massa ogni chiamata a mb_ereg senza rivedere l'espressione.

5. MySQLi: prepara uno statement in un solo passo

Prima — deprecato:

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

Dopo:

<?php
$stmt = mysqli_prepare($mysqli, 'SELECT name FROM users WHERE id = ?');
mysqli_stmt_bind_param($stmt, 'i', $userId);
mysqli_stmt_execute($stmt);

Con l'API object-oriented, usa $mysqli->prepare($sql) invece di $mysqli->stmt_init() seguito da prepare(). Mantieni la tua gestione degli errori esistente e chiudi gli statement appropriatamente.

L'API separata mysqli_get_charset() è anche deprecata. Se ti serve solo il nome del charset corrente:

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

Questa non è una sostituzione per tutti i campi del vecchio oggetto informazioni charset. Se il codice dipende dai metadati di collation, ispeziona cosa serve effettivamente e interroga il server in modo appropriato.

6. CSV: sostituisci i metodi CSV deprecati di SplFileObject

I metodi specifici per CSV su SplFileObject sono deprecati. Per codice nuovo e migrato, usa le funzioni fgetcsv() e fputcsv() basate su stream.

Prima:

<?php
$file = new SplFileObject($path, 'r');
while (!$file->eof()) {
    $row = $file->fgetcsv();
    // Process row
}

Dopo:

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

L'argomento escape vuoto disabilita il meccanismo di escape proprietario di PHP; testa questa scelta contro il formato che il tuo sistema sorgente esporta. Controlla righe vuote, intestazioni, delimitatori, newline incorporati ed encoding. Questo esempio illustra il cambio di API, non un parser CSV universale.

Per la scrittura, usa fputcsv($handle, $fields, ',', '"', ''). Preserva il dialetto previsto del file originale.

7. Identità degli oggetti: spl_object_hash() non è un hash del contenuto

Prima:

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

Dopo:

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

La sostituzione restituisce un intero, non una stringa. Se le chiavi sono serializzate, memorizzate in un database o esposte tramite un'API, rivedi prima i consumatori. Nessuna delle due funzioni produce un identificatore persistente tra le richieste, e gli ID possono essere riutilizzati dopo che gli oggetti vengono distrutti. Per una mappa chiave per identità di oggetto vivo, considera SplObjectStorage o WeakMap, a seconda dei requisiti di lifetime.

8. Un return in finally può nascondere i fallimenti

Prima — deprecato e fuorviante:

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

Dopo — preserva la pulizia senza sovrascrivere il risultato:

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

Se il codice originale restituiva intenzionalmente un fallback, sposta quella decisione in un blocco catch con gestione esplicita. Non ingoiare silenziosamente un'eccezione che dovrebbe raggiungere il chiamante.

9. Ordinamento locale-sensibile e altri cambiamenti meno ovvi

strcoll() e il flag di ordinamento SORT_LOCALE_STRING sono deprecati. L'alternativa intl consigliata è Collator:

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

Verifica che intl sia installato. L'ordinamento locale-aware è una regola di business: testa il tuo ordinamento atteso invece di assumere che ICU e una locale globale di processo si comportino sempre identicamente.

Altri elementi di migrazione meritano attenzione esplicita:

  • ArrayIterator: ordinamento, flag e metodi di serializzazione come asort(), ksort(), setFlags() e serialize() sono deprecati. Ordina l'array sottostante o usa ArrayObject quando la sua API è appropriata; non assumere che un iteratore e un contenitore siano intercambiabili.
  • Handler di sessione personalizzati: implementa sia create_sid() che validateId() come richiesto dalle interfacce/comportamenti aggiornati. PHP 8.6 abilita default di sessione più severi; testa login, rotazione di sessione e persistenza.
  • __debugInfo(): usa un tipo di ritorno array non nullable; restituire null era già deprecato.
  • define(): rimuovi il terzo argomento case_insensitive, anche quando è false.
  • http_build_query() e array_walk(): passare oggetti dove sono attesi array è deprecato. Converti intenzionalmente usando get_object_vars() o costruisci l'array desiderato esplicitamente.
  • metaphone(): non esiste una sostituzione built-in PHP equivalente. Scegli e testa un algoritmo fonetico mantenuto e appropriato per la lingua.
  • Identificatori riservati: nomi come let, is, readonly (funzione) e namespace (costante di classe) hanno nuove restrizioni di deprecazione. Rinomina le dichiarazioni interessate con attenzione.
  • Reflection: rivedi oggetti non validi passati a ReflectionProperty::setValue() e argomenti oggetto forniti quando si invocano metodi statici.

Consulta la guida completa alla migrazione per i casi limite non coperti in questa selezione pratica.

10. Trova le chiamate deprecate in un progetto esistente

Inizia con un inventario di sola lettura. Su Linux o 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

Sostituisci ./src con la directory effettiva. Questa ricerca testuale può corrispondere a commenti o stringhe, e mancherà chiamate dinamiche, alias con namespace e altre API deprecate. È un punto di partenza, non un analizzatore statico completo.

Per un'opzione cross-platform, la funzione "Trova nei file" di un editor può cercare gli stessi nomi. Non modificare direttamente i file vendor o core del CMS: aggiorna il pacchetto upstream o invia una patch al suo maintainer.

Un flusso di lavoro sicuro per la migrazione PHP 8.6 con staging, revisione log e test di regressione

Una sequenza di migrazione riproducibile

  1. Registra la versione PHP corrente e le estensioni abilitate.
  2. Esegui backup di file e database; prepara una copia di staging.
  3. Esegui il progetto sotto PHP 8.6 con il logging delle deprecazioni abilitato.
  4. Inventaria gli avvisi per file e linea, poi raggruppa per API.
  5. Correggi prima il codice first-party con cambiamenti mirati; aggiorna le dipendenze third-party separatamente.
  6. Riesegui test unit/integration e percorsi utente importanti.
  7. Controlla form, login, sessioni, email, pagamenti, job schedulati, import/export CSV e accesso al database.
  8. Deploy con un piano di rollback; monitora i log degli errori dopo il rilascio.

Joomla e WordPress: il rilascio di PHP 8.6 non significa che ogni versione di CMS, estensione o plugin lo supporti. Conferma la compatibilità con le versioni esatte in uso e testa prima un ambiente di staging. Non usare l'aggiornamento come motivo per patchare direttamente codice core o vendor.

11. Cosa c'è di realmente nuovo in PHP 8.6?

Oltre alle deprecazioni, il rilascio aggiunge diverse funzionalità di linguaggio e runtime:

Funzionalità Uso pratico
Applicazione parziale di funzioni Pre-riempi argomenti e ottieni un callable per quelli rimanenti
clamp() Vincola un valore tra un minimo e un massimo
\Time\Duration Rappresenta tempo trascorso piuttosto che una data di calendario
SortDirection Esprimi direzione ascendente/discendente attraverso un enum standard
Io\Poll Supporta il polling di stream in librerie event-loop e I/O
Default per proprietà readonly Semplifica dichiarazioni di classi immutabili selezionate

Un esempio piccolo e immediatamente utile è clamp():

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

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

Il codice è più facile da leggere, ma la priorità della migrazione dovrebbe rimanere il testing di compatibilità. Le altre funzionalità non sono necessarie solo per mantenere un'applicazione esistente funzionante. Vedi l'annuncio ufficiale del rilascio.

12. Prima di cambiare la versione PHP di produzione

Tratta PHP 8.6 come un aggiornamento controllato, non come un pulsante da cliccare su un server di produzione occupato. Una checklist di rilascio sensata è: CMS e dipendenze supportati; estensioni disponibili; nessun inondazione inaspettata di deprecazioni; test che passano; comportamento di database e sessioni verificato; backup testati; e una procedura di rollback.

In sintesi: PHP 8.6 porta funzionalità utili, ma le sue deprecazioni sono spesso dove inizia il lavoro di manutenzione. Correggi prima gli alias semplici, poi testa le migrazioni comportamentali — soprattutto regex, CSV, sessioni e operazioni locale-sensibili — contro dati reali.

Fonti ufficiali