PHP 8.6: Uudet ominaisuudet, hylätyt toiminnot ja käytännön siirtymisopas
Päivitä PHP 8.6:aan. Sisältää ennen ja jälkeen -esimerkkejä hylätyistä PHP-toiminnoista, MySQLi:stä, mbstringistä, CSV:stä, sessioista ja käytännön siirtymistarkistuslistan.
PHP 8.6.0 julkaistiin 19. marraskuuta 2026. Uutisarvoiset ominaisuudet ovat mielenkiintoisia, mutta kehittäjille, jotka ylläpitävät oikeita verkkosivustoja, tärkein kysymys on usein toinen: mitkä olemassa olevan koodin rivit alkavat lähettää vanhentuneisuusvaroituksia, ja miten ne tulisi kirjoittaa uudelleen?
Tämä opas asettaa siirtotyön etusijalle. Jokainen esimerkki tunnistaa vanhentuneen rajapinnan, näyttää korvaavan lähestymistavan ja korostaa, missä mekaaninen etsi-ja-korvaa olisi vaarallinen. Vanhentuneisuusvaroitus ei ole sama asia kuin välitön kamalinen virhe: se varoittaa, että koodi tarvitsee huomiota, usein ennen kuin tuleva pääversio poistaa rajapinnan.
1. Tarkista suoritusaika ennen tuotannon koskemista
Suorita nämä komennot samassa PHP-ympäristössä, joka palvelee sovellusta (CLI- ja web-PHP voivat käyttää eri binäärejä ja asetuksia):
php -v
php -m
php --ini
Tarkista projektin käyttämät laajennukset, erityisesti mbstring, mysqli ja intl. Varmista, että kehys, CMS, laajennukset ja isäntäympäristö tukevat nimenomaan PHP 8.6:sta; älä päättele yhteensopivuutta pelkästä siitä, että sivusto käynnistyy.
Valmisteluympäristössä kirjaa kaikki virheet pitäen diagnostiikkaviestit pois julkisesta HTML:stä:
<?php
error_reporting(E_ALL);
ini_set('log_errors', '1');
ini_set('display_errors', '0');
Nämä suoritusaika-asetukset ovat hyödyllisiä hallitulle testaukselle. Suosi lokituksen määrittämistä palvelintasolla pitkäaikaisissa ympäristöissä; varmista, että virheloki on kirjoitettava ja yksityinen. Deprecated-viesti on toimivaton jopa silloin, kun sivu edelleen renderöityy.
2. Pikaviite: vanhentuneet rajapinnat ja mitä käyttää sen sijaan
| Vanhentunut PHP 8.6:ssa | Suositeltu lähestymistapa | Siirron varoitus |
|---|---|---|
is_integer(), is_long() |
is_int() |
Suorat aliasit |
is_double() |
is_float() |
Suora alias |
doubleval() |
floatval() |
Suora alias |
spl_object_hash() |
spl_object_id() |
Palautustyyppi muuttuu merkkijonosta kokonaisluvuksi |
mb_ereg(), mb_eregi() |
preg_match() |
Säädä kaava-syntaksi ja Unicode-liput |
mb_ereg_replace() |
preg_replace() |
Tarkista poistomerkinnät, korvaamissemantiikka ja virheet |
mysqli_stmt_init() |
mysqli_prepare() |
Valmistele heti |
mysqli_get_charset() |
mysqli_character_set_name() |
Vain jos merkkijonon nimi tarvitaan |
SplFileObject::fgetcsv() |
fgetcsv() virralla |
Tarkista virran sijainti ja CSV-asetukset |
SplFileObject::fputcsv() |
fputcsv() virralla |
Anna erotin, sulku- ja poistomerkki eksplisiittisesti |
strcoll() |
Collator::compare() |
Vaatii intl; valitse locale |
SORT_LOCALE_STRING |
Collator::sort() / asort() |
Locale-käyttäytyminen voi muuttua |
spl_classes() |
ReflectionExtension::getClassNames() |
Tarkista sopiva laajennus |
define():n kolmas argumentti |
Jätä argumentti pois | Vanha kirjainkokoa ei huomioiva tila on poistettu |
return finally:ssa |
Palauta finally:n ulkopuolella |
Vältä poikkeusten piilottamista |
Olio välitetty array_walk():lle |
get_object_vars() ensin |
Viittausmuokkaukset eivät enää välttämättä muuta oliota |
metaphone() |
Ylläpidetty fonetinen toteutus | Ei ole valmista core-korvaavaa |
Joillakin rajapinnoilla ei ole tarkkaa korvaavaa. Oikea siirto voi vaatia suunnittelun muuttamista sen sijaan, että pelkkä funktio uudelleen nimetään. Katso virallinen PHP 8.6 vanhentuneet -luettelo.
3. Yksinkertaiset aliasit: turvallisia, nopeita korjauksia
Ennen — vanhentunut:
<?php
if (is_integer($quantity) && is_double($price)) {
$total = doubleval($price) * $quantity;
}
Jälkeen:
<?php
if (is_int($quantity) && is_float($price)) {
$total = floatval($price) * $quantity;
}
Aliasilla on sama semantiikka. Älä oletta, että is_float(40) on totta: kokonaisluku on edelleen kokonaisluku. Se käyttäytyminen oli jo olemassa ennen siirtoa.
Merkkijonomuotoiselle summalle floatval() on muunnos, ei raha-asioiden kannalta turvallinen desimaaliesitys. Pidä projektin olemassa oleva rahankäsittelystrategia sen sijaan, että muuttaisit sitä osana ei-liittyvää PHP-päivitystä.
4. Mbstring-säännöllisten lausekkeiden siirtäminen
mb_ereg*-perhe on vanhentunut, koska sen alla oleva Oniguruma-regex-moottori ei enää ylläpidetä. PHP suosittelee PCRE:tä moniin käyttötarkoituksiin, mutta kaava-dialektit eivät ole identtisiä.
Ennen:
<?php
$isReference = mb_ereg('^[0-9]+$', $reference) !== false;
Jälkeen (vain ASCII-numerot):
<?php
$isReference = preg_match('/^[0-9]+$/D', $reference) === 1;
Tässä D-modifikaattori tekee $:stä vastaavan vain aiheen lopussa. Unicode-tekstissä käytä sopivaa UTF-8-kaavaa ja u-modifikaattoria:
<?php
$isName = preg_match('/^\p{L}+(?:[ -]\p{L}+)*$/uD', $name) === 1;
Ennen — korvaus:
<?php
$clean = mb_ereg_replace('[[:space:]]+', ' ', $text);

Jälkeen — korvaus:
<?php
$clean = preg_replace('/\s+/u', ' ', $text);
if ($clean === null) {
throw new RuntimeException('Regular expression failed');
}
Kaksi kaavaa voivat poiketa toisistaan joissain Unicode-valkomerkeissä. Todellisissa siirroissa testaa aksenttikirjaimet, rivinvaihdot, virheelliset UTF-8, ryhmäkuvasimet ja takaviittaukset vastaa projektin todellisia dataa. Älä massakorvaa jokainen mb_ereg-kutsu ilman lausekkeen tarkistamista.
5. MySQLi: valmistele lause yhdellä vaiheella
Ennen — vanhentunut:
<?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);
Jälkeen:
<?php
$stmt = mysqli_prepare($mysqli, 'SELECT name FROM users WHERE id = ?');
mysqli_stmt_bind_param($stmt, 'i', $userId);
mysqli_stmt_execute($stmt);
Olion-orientoidulla API:lla käytä $mysqli->prepare($sql) $mysqli->stmt_init():n ja prepare():n sijaan. Pidä olemassa oleva virheenkäsittely ja sulje lauseet asianmukaisesti.
Erillinen mysqli_get_charset()-API on myös vanhentunut. Jos tarvitset vain nykyisen merkkijonon nimen:
<?php
$charsetName = mysqli_character_set_name($mysqli);
Tämä ei ole korvaava kaikki vanhan merkkijonotieto-objektin kentät. Jos koodi riippuu aakkosjärjestys-metadatoista, tutki mitä se todella tarvitsee ja kysely palvelimelta asianmukaisesti.
6. CSV: korvaa vanhentuneet SplFileObject CSV-metodit
CSV-kohtaiset metodit SplFileObject:lla on vanhentunut. Uuteen ja siirrettyyn koodiin, käytä virran-pohjaisia fgetcsv()- ja fputcsv()-funktioita.
Ennen:
<?php
$file = new SplFileObject($path, 'r');
while (!$file->eof()) {
$row = $file->fgetcsv();
// Process row
}
Jälkeen:
<?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);
}
Tyhjä poistomerkki-argumentti poistaa PHP:n omapuolisen poistomekanismin käytöstä; testaa tämä valinta lähdesysteemin viedyn muodon vasten. Tarkista tyhjät rivit, otsikot, erotimet, upotetut rivinvaihdot ja koodaus. Tämä esimerkki havainnollistaa API-muutosta, ei universaalia CSV-parseria.
Kirjoittamiseen käytä fputcsv($handle, $fields, ',', '"', ''). Säilytä alkuperäisen tiedoston odottama dialect.
7. Olion identiteetti: spl_object_hash() ei sisältö-hashi
Ennen:
<?php
$key = spl_object_hash($object);
Jälkeen:
<?php
$key = spl_object_id($object);
Korvaava palauttaa kokonaisluvun, ei merkkijonoa. Jos avaimia serialisoidaan, tallennetaan tietokantaan tai paljastetaan API:n kautta, tarkista kuluttajat ensin. Ei mikään funktio tuota pysyvää tunnistetta pyyntöjen välillä, ja ID:t voidaan käyttää uudelleen objektien tuhottua. Karttaan, joka on avaimeltansa elävän olion identiteetti, harkitse SplObjectStorage tai WeakMap, elinkaarivaatimuksista riippuen.
8. Finally-lohkon return voi piilottaa virheet
Ennen — vanhentunut ja harhaanjohtava:
<?php
function loadSettings(): array
{
try {
return readSettings();
} finally {
return []; // Overrides the result and hides exceptions
}
}
Jälkeen — säilytä siivous ilman tuloksen ylittämistä:

<?php
function loadSettings(): array
{
try {
return readSettings();
} finally {
releaseTemporaryResources();
}
}
Jos alkuperäinen koodi tarkoituksellisesti palautti varatoiminnon, siirrä se päätös catch-lohkoon eksplisiittisellä käsittelyllä. Älä hiljaa nielaise poikkeusta, joka tulisi saavuttaa kutsuja.
9. Locale-hassu järjestyks ja muut vähemmän ilmeiset muutokset
strcoll() ja SORT_LOCALE_STRING-järjestyslippu on vanhentunut. Suositeltu intl-vaihtoehto on Collator:
<?php
$collator = new Collator('fr_FR');
$names = ['Émile', 'Alice', 'Zoé'];
$collator->sort($names);
Tarkista, että intl on asennettu. Locale-tietoinen järjestyks on liiketoimintasääntö: testaa odottamasi järjestys sen sijaan, että olettaisit ICU:n ja prosessin globaalin lokalen käyttäytyvän aina identtisesti.
Muut siirtokohteet ansaitsevat eksplisiittistä huomiota:
ArrayIterator: järjestyks, liput ja serialisointimetodit kutenasort(),ksort(),setFlags()jaserialize()on vanhentunut. Järjestä alusta oleva taulukko tai käytäArrayObject, kun sen API on sopiva; älä oleteta iteraattorin ja säilön vaihdettaviksi.- Mukautetut istunto-käsittelijät: toteuta sekä
create_sid()ettävalidateId()päivitettyjen rajapintojen/käyttäytymisen vaatimana. PHP 8.6 ottaa käyttöön tiukemmat istunto-oletukset; testaa kirjautuminen, istunto-kierto ja pysyvyys. __debugInfo(): käytä ei-nullattavaaarray-palautustyyppiä;null-palauttaminen oli jo vanhentunut.define(): poista kolmascase_insensitive-argumentti, jopa kun se onfalse.http_build_query()jaarray_walk(): olioiden välittäminen taulukoiden odotettaessa on vanhentunut. Muunna tarkoituksellisestiget_object_vars():lla tai rakenta haluttu taulukko eksplisiittisesti.metaphone(): ei ole vastaavaa sisäänrakennettua PHP-korvaavaa. Valitse ja testaa ylläpidetty, kieleen sopiva fonetinen algoritmi.- Varatut tunnisteet: nimet kuten
let,is,readonly(funktio) janamespace(luokan vakio) saavat uusia vanhentumisrajoituksia. Nimeä kohdistetut määreet varovasti. - Reflection: tarkista virheelliset oliot välitetyt
ReflectionProperty::setValue():lle ja olio-argumentit annettuna staattisten metodien kutsumisessa.
Konsultoi täydellinen siirto-opas tapauksille, joita tämä käytännöllinen valinta ei kattavu.
10. Löydä vanhentuneet kutsut olemassa olevasta projektista
Aloita vain luku -inventaariolla. Linuxilla tai macOSilla:
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
Korvaa ./src todellisella hakemistolla. Tämä tekstihaku voi osua kommentteihin tai merkkijonoihin, ja se kadottaa dynaamiset kutsuja, nimiavaruudelliset aliasit ja muita vanhentuneita rajapintoja. Se on lähtökohta, ei täydellinen staattinen analyysaattori.
Ristiriidattomaan vaihtoehtoon editorin Find in Files voi hakea samilla nimillä. Älä muokkaa vendor- tai CMS-core-tiedostoja suoraan: päivitä upstream-paketti tai lähetä patch sen ylläpitäjälle.
Toistettava siirty-järjestys
- Kirjaa nykyinen PHP-versio ja käytössä olevat laajennukset.
- Varmuuskopioi tiedostot ja tietokanta; valmista valmiistelu-kopio.
- Suorita projekti PHP 8.6:lla vanhentuneisuuslokituksella käytössä.
- Inventoi varoitukset tiedosto- ja rivikohtaisesti, sitten ryhmittele rajapinnan mukaan.
- Korjaa omakohtainen koodi kohdennettuilla muutoksilla; päivitä kolmannen osapuolen riippuvuudet erikseen.
- Suorita yksikkö-/integraatiotestit ja tärkeimmät käyttäjäpolut uudelleen.
- Tarkista lomakkeet, kirjautuminen, istunnot, sähköposti, maksut, aikataulutetut työt, CSV-tuonti/vienti ja tietokantayhteys.
- Julkaise palautussuunnitelmalla; valvoka virhelokeja julkaisun jälkeen.
Joomla ja WordPress: PHP 8.6:n julkaiseminen ei tarkoita, että jokainen CMS-versio, laajennus tai lisäosa tukee sitä. Varmista yhteensopivuus käytössä olevien tarkkojen version kanssa ja testaa valmiisteluympäristössä ensin. Älä käytä päivitystä syynä patchata core- tai vendor-koodia suoraan.
11. Mitä on oikeasti uutta PHP 8.6:ssa?
Vanhentuneiden ohella julkaisu tuo useita kieli- ja suoritusaikaominaisuuksia:
| Ominaisuus | Käytännöllinen käyttö |
|---|---|
| Osittainen funktio-sovellus | Esitäytä argumentit ja saa callable jäljelle jääville |
clamp() |
Rajoita arvo minimiin ja maksimiin |
\Time\Duration |
Esitä kulunut aika snarvi kalenteripäivämäärän sijaan |
SortDirection |
Ilmaise nouseva/laskuva suunta standardi-enum:n kautta |
Io\Poll |
Tukaa virran-pollingia event-loop- ja I/O-kirjastoissa |
| Oletukset readonly-ominaisuuksille | Yksinkertaista valikoituja muuttumattomia luokkamääritelmiä |
Pieni, välittömästi hyödyllinen esimerkki on clamp():
<?php
// Before PHP 8.6
$percentage = min(100, max(0, $input));
// PHP 8.6
$percentage = clamp($input, 0, 100);
Koodi on helpompi lukea, mutta siirty-prioriteetti pitäisi yhä olla yhteensopivuustestaus. Muut ominaisuudet eivät ole välttämättömiä vain olemassa olevan sovelluksen toimittamiseksi. Katso virallinen julkaisu-ilmoitus.
12. Ennen tuotannon PHP-version vaihtamista
Käsittele PHP 8.6 kontrolloidulla päivityksellä, ei painikkeena kiireisellä tuotannon palvelimella. Järkevä julkaisu-checklist on: tuetut CMS ja riippuvuudet; käytettävissä olevat laajennukset; odottamaton vanhentuneisuus-vuoto; testit menivät läpi; varmistettu tietokanta- ja istunto-käyttäytyminen; testatut varmuuskopiot; ja palautusmenettely.
Lopputulos: PHP 8.6 tuo hyödyllisiä ominaisuuksia, mutta sen vanhentumiset ovat usein se paikka, mistä ylläpitotyö alkaa. Korjaa suorat aliasit ensin, sitten testaa käyttäytymismuutokset — erityisesti regex, CSV, istunnot ja locale-hassut toiminnot — oikeaa dataa vasten.