Verkkosivut ja kehitys

PHP 8.6: Uudet ominaisuudet, hylätyt toiminnot ja käytännön siirtymisopas

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

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.

PHP 8.6 siirtopolku: inventaario, valmiistelu, lokit, korjaukset ja regressiotestit

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

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ä:

Technical workflow illustration
<?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 kuten asort(), ksort(), setFlags() ja serialize() 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-nullattavaa array-palautustyyppiä; null-palauttaminen oli jo vanhentunut.
  • define(): poista kolmas case_insensitive-argumentti, jopa kun se on false.
  • http_build_query() ja array_walk(): olioiden välittäminen taulukoiden odotettaessa on vanhentunut. Muunna tarkoituksellisesti get_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) ja namespace (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.

Turvallinen PHP 8.6 siirty-työnkulku valmiistellulla, lokien tarkastuksella ja regressiotestauksella

Toistettava siirty-järjestys

  1. Kirjaa nykyinen PHP-versio ja käytössä olevat laajennukset.
  2. Varmuuskopioi tiedostot ja tietokanta; valmista valmiistelu-kopio.
  3. Suorita projekti PHP 8.6:lla vanhentuneisuuslokituksella käytössä.
  4. Inventoi varoitukset tiedosto- ja rivikohtaisesti, sitten ryhmittele rajapinnan mukaan.
  5. Korjaa omakohtainen koodi kohdennettuilla muutoksilla; päivitä kolmannen osapuolen riippuvuudet erikseen.
  6. Suorita yksikkö-/integraatiotestit ja tärkeimmät käyttäjäpolut uudelleen.
  7. Tarkista lomakkeet, kirjautuminen, istunnot, sähköposti, maksut, aikataulutetut työt, CSV-tuonti/vienti ja tietokantayhteys.
  8. 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.

Viralliset lähteet