PHP 8.6: Nuove Funzionalità, Funzioni Deprecate e una Guida Pratica alla Migrazione
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.
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);

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:

<?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 comeasort(),ksort(),setFlags()eserialize()sono deprecati. Ordina l'array sottostante o usaArrayObjectquando la sua API è appropriata; non assumere che un iteratore e un contenitore siano intercambiabili.- Handler di sessione personalizzati: implementa sia
create_sid()chevalidateId()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 ritornoarraynon nullable; restituirenullera già deprecato.define(): rimuovi il terzo argomentocase_insensitive, anche quando èfalse.http_build_query()earray_walk(): passare oggetti dove sono attesi array è deprecato. Converti intenzionalmente usandoget_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) enamespace(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.
Una sequenza di migrazione riproducibile
- Registra la versione PHP corrente e le estensioni abilitate.
- Esegui backup di file e database; prepara una copia di staging.
- Esegui il progetto sotto PHP 8.6 con il logging delle deprecazioni abilitato.
- Inventaria gli avvisi per file e linea, poi raggruppa per API.
- Correggi prima il codice first-party con cambiamenti mirati; aggiorna le dipendenze third-party separatamente.
- Riesegui test unit/integration e percorsi utente importanti.
- Controlla form, login, sessioni, email, pagamenti, job schedulati, import/export CSV e accesso al database.
- 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.