Web a vývoj

PHP 8.6: Nové funkce, zastaralé funkce a praktický migrační průvodce

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

Aktualizujte na PHP 8.6 s příklady před a po pro zastaralé PHP funkce, MySQLi, mbstring, CSV, relace a praktický kontrolní seznam migrace.

PHP 8.6.0 byl vydán 19. listopadu 2026. Hlavní funkce jsou zajímavé, ale pro vývojáře udržující skutečné weby je často pilná otázka jiná: které řádky existujícího kódu začnou vyhazovat upozornění na zastarání a jak by měly být přepsány?

Tato příručka dává migrační práci na první místo. Každý příklad identifikuje zastaralé API, ukazuje náhradu a zdůrazňuje, kde by mechanické vyhledávání a nahrazování bylo nebezpečné. Upozornění na zastarání není totéž jako okamžitá fatální chyba: varuje, že kód potřebuje pozornost, často dříve, než budoucí hlavní verze API odstraní.

PHP 8.6 migrační cesta: inventarizace, staging, logy, opravy a regresní testy

1. Zkontrolujte své běhové prostředí před dotčením produkce

Spusťte tyto příkazy ve stejném PHP prostředí, které obsluhuje aplikaci (CLI a webové PHP mohou používat různé binární soubory a nastavení):

php -v
php -m
php --ini

Zkontrolujte rozšíření používaná projektem, zejména mbstring, mysqli a intl. Ověřte, že framework, CMS, rozšíření a hostingové prostředí explicitně podporují PHP 8.6; neodvozujte kompatibilitu pouze z toho, že se web spustí.

Ve stagingovém prostředí logujte všechny chyby při zachování diagnostických zpráv mimo veřejný HTML:

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

Tato nastavení běhu jsou užitečná pro kontrolovaný test. Pro dlouhodobá prostředí preferujte konfiguraci logování na úrovni serveru; ujistěte se, že chybový log je zapisovatelný a soukromý. Zpráva Deprecated je akční i když se stránka stále vykresluje.

2. Rychlá reference: zastaralá API a co použít místo nich

Zastaralé v PHP 8.6 Doporučený přístup Migrační upozornění
is_integer(), is_long() is_int() Přímé aliasy
is_double() is_float() Přímý alias
doubleval() floatval() Přímý alias
spl_object_hash() spl_object_id() Návratový typ se mění z string na int
mb_ereg(), mb_eregi() preg_match() Přizpůsobte syntaxi vzoru a Unicode příznaky
mb_ereg_replace() preg_replace() Zkontrolujte escapování, sémantiku nahrazení a chyby
mysqli_stmt_init() mysqli_prepare() Připravte se okamžitě
mysqli_get_charset() mysqli_character_set_name() Jen pokud je potřeba název znakové sady
SplFileObject::fgetcsv() fgetcsv() na streamu Zrevidujte pozici streamu a CSV nastavení
SplFileObject::fputcsv() fputcsv() na streamu Předávejte oddělovač, ohraničení a escape explicitně
strcoll() Collator::compare() Vyžaduje intl; zvolte locale
SORT_LOCALE_STRING Collator::sort() / asort() Chování locale se může změnit
spl_classes() ReflectionExtension::getClassNames() Prozkoumejte příslušné rozšíření
Třetí argument define() Vynechte argument Starý case-insensitive režim je pryč
return v finally Return mimo finally Vyhněte se potlačování výjimek
Objekt předaný array_walk() get_object_vars() nejprve Úpravy by reference už nemusí mutovat objekt
metaphone() Udržovaná fonetická implementace Neexistuje přímá náhrada v jádru

Některá API nemají přesnou náhradu. Správná migrace může vyžadovat změnu designu spíše než přejmenování funkce. Viz oficiální seznam zastaralostí PHP 8.6.

3. Jednoduché aliasy: bezpečné, rychlé opravy

Před — zastaralé:

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

Po:

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

Aliasové mají stejnou sémantiku. Nepředpokládejte, že is_float(40) je true: integer zůstane integer. To chování už bylo přítomno před migrací.

Pro řetězcovou částku je floatval() konverze, nikoliv money-safe desítková reprezentace. Zachovejte stávající strategii pro práci s penězi projektu spíše než ji měnit jako součást nesouvisejícího PHP upgradu.

4. Migrace mbstring regulárních výrazů

Rodina mb_ereg* je zastaralá, protože jejím podkladovým regex enginem Oniguruma se už neudržuje. PHP doporučuje PCRE pro mnohé případy použití, ale dialekty vzorů nejsou identické.

Před:

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

Po (pouze ASCII číslice):

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

Zde modifikátor D dělá, aby $ odpovídal pouze na konci subjektu. Pro Unicode text použijte vhodný UTF-8 vzor a modifikátor u:

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

Před — nahrazení:

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

Po — nahrazení:

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

Oba vzory se mohou lišit u některých Unicode bílých znaků. Pro skutečné migrace testujte akcentované znaky, nové řádky, neplatné UTF-8, zachycující skupiny a backreference proti skutečným projektovým datům. Nemasově nahrazujte každé volání mb_ereg bez revize výrazu.

5. MySQLi: připravte statement v jednom kroku

Před — zastaralé:

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

Po:

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

S objektově orientovaným API použijte $mysqli->prepare($sql) místo $mysqli->stmt_init() následovaného prepare(). Zachovejte své stávající error handling a správně uzavírejte statementy.

Separátní mysqli_get_charset() API je také zastaralé. Pokud potřebujete jen aktuální název charsetu:

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

To není náhrada pro všechna pole starého objektu s informacemi o charsetu. Pokud kód závisí na metadatech kolace, prozkoumejte, co vlastně potřebuje, a dotazte se serveru odpovídajícím způsobem.

6. CSV: nahraďte zastaralé metody SplFileObject pro CSV

CSV-specifické metody na SplFileObject jsou zastaralé. Pro nový a migrovaný kód používejte streamové funkce fgetcsv() a fputcsv().

Před:

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

Po:

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

Prázdný escape argument zakáže PHP proprietární escape mechanismus; otestujte tuto volbu proti formátu, který váš zdrojový systém exportuje. Zkontrolujte prázdné řádky, hlavičky, oddělovače, vnořené nové řádky a kódování. Tento příklad ilustruje změnu API, ne univerzální CSV parser.

Pro zápis používejte fputcsv($handle, $fields, ',', '"', ''). Zachovejte očekávaný dialekt původního souboru.

7. Identita objektů: spl_object_hash() není content hash

Před:

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

Po:

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

Náhrada vrací integer, nikoliv string. Pokud jsou klíče serializovány, uloženy v databázi nebo vystaveny přes API, nejprve zkontrolujte spotřebitele. Žádná z funkcí nevytváří trvalý identifikátor napříč požadavky a ID mohou být znovu použita po zničení objektů. Pro mapu klíčovanou živou identitou objektu zvažte SplObjectStorage nebo WeakMap v závislosti na požadavcích na životnost.

8. Return v finally může skrývat selhání

Před — zastaralé a matoucí:

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

Po — zachovejte cleanup bez přepisování výsledku:

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

Pokud původní kód záměrně vracel fallback, přesuňte toto rozhodnutí do bloku catch s explicitním zpracováním. Netichou potlačujte výjimku, která by měla dosáhnout volajícího.

9. Locale-sensitive řazení a další méně očividné změny

strcoll() a příznak řazení SORT_LOCALE_STRING jsou zastaralé. Doporučenou intl alternativou je Collator:

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

Zkontrolujte, že je nainstalováno intl. Locale-aware řazení je obchodní pravidlo: testujte svůj očekávaný pořadí spíše než předpokládáte, že ICU a process-global locale se vždy chovají identicky.

Další migrační položky zaslouží explicitní pozornost:

  • ArrayIterator: řazení, příznaky a serializační metody jako asort(), ksort(), setFlags() a serialize() jsou zastaralé. Seřaďte podkladové pole nebo použijte ArrayObject, když je jeho API vhodné; nepředpokládejte, že iterátor a kontejner jsou zaměnitelné.
  • Vlastní session handlery: implementujte create_sid() i validateId() podle aktualizovaných rozhraní/chování. PHP 8.6 povoluje přísnější session defaulty; otestujte přihlášení, rotaci session a persistenci.
  • __debugInfo(): použijte non-nullable array návratový typ; vracezení null už bylo zastaralé.
  • define(): odeberte třetí case_insensitive argument, i když je false.
  • http_build_query() a array_walk(): předávání objektů, kde se očekávají pole, je zastaralé. Konvertujte záměrně pomocí get_object_vars() nebo konstruujte požadované pole explicitně.
  • metaphone(): neexistuje ekvivalentní vestavěná PHP náhrada. Vyberte a otestujte udržovaný, jazykem vhodný fonetický algoritmus.
  • Rezervované identifikátory: názvy jako let, is, readonly (funkce) a namespace (class constant) mají nová omezení pro zastarání. Přejmenujte ovlivněné deklarace opatrně.
  • Reflection: zkontrolujte neplatné objekty předané ReflectionProperty::setValue() a objektové argumenty dodávané při volání statických metod.

Podívejte se do plné migrační příručky pro hraniční případy nekryté v tomto praktickém výběru.

10. Najděte zastaralá volání v existujícím projektu

Začněte read-only inventarizací. Na Linuxu nebo 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

Nahraďte ./src skutečným adresářem. Tato textová hledání může odpovídat komentářům nebo řetězcům a bude chybět dynamická volání, namespaced aliasy a další zastaralá API. Je to výchozí bod, nikoliv kompletní statický analyzátor.

Pro multiplatformní variantu může Find in Files editoru hledat stejná jména. Neupravujte vendor nebo CMS core soubory přímo: aktualizujte upstream balíček nebo pošlete patch jeho maintainerovi.

Bezpečný PHP 8.6 migrační workflow se stagingem, revizí logů a regresním testováním

Reprodukovatelná migrační sekvence

  1. Zaznamenejte aktuální PHP verzi a povolená rozšíření.
  2. Zazálohujte soubory a databázi; připravte staging kopii.
  3. Spusťte projekt pod PHP 8.6 s povoleným logováním deprecation.
  4. Inventarizujte varování podle souboru a řádku, pak seskupte podle API.
  5. Opravte first-party kód cílenými změnami; aktualizujte third-party závislosti samostatně.
  6. Znovu spusťte unit/integration testy a důležité uživatelské cesty.
  7. Zkontrolujte formuláře, přihlášení, session, e-maily, platby, plánované úlohy, CSV import/export a databázový přístup.
  8. Nasazujte s rollback plánem; monitorujte error logy po releasu.

Joomla a WordPress: To, že PHP 8.6 byl vydán, neznamená, že každá CMS verze, rozšíření nebo plugin ho podporuje. Potvrďte kompatibilitu s přesnými verzemi v používání a nejprve otestujte stagingové prostředí. Nepoužívejte upgrade jako důvod k patchování core nebo vendor kódu přímo.

11. Co je vlastně nového v PHP 8.6?

Kromě zastaralostí přidává vydání několik jazykových a runtime funkcí:

Funkce Praktické použití
Partial function application Předvyplňte argumenty a získejte callable pro zbývající
clamp() Omezte hodnotu mezi minimum a maximum
\Time\Duration Reprezentujte uplynulý čas spíše než kalendářní datum
SortDirection Vyjádřete vzestupné/sestupné směřování standardním enumem
Io\Poll Podpořte stream polling v event-loop a I/O knihovnách
Defaults pro readonly properties Zjednodušte vybrané immutable class deklarace

Malý, okamžitě užitečný příklad je clamp():

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

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

Kód je čitelnější, ale migrační priorita by stále měla být kompatibilní testování. Ostatní funkce nejsou nutné jen pro to, aby existující aplikace fungovala. Viz oficiální release announcement.

12. Než přepnete produkční PHP verzi

Relujte k PHP 8.6 jako k kontrolovanému upgradu, ne jako k tlačítku, na které kliknete na zaneprázdněném produkčním serveru. Rozumný release checklist je: podporovaný CMS a závislosti; dostupná rozšíření; žádný neočekávaný deprecation flood; testy procházejí; ověřené databázové a session chování; testované zálohy; a rollback procedura.

Závěr: PHP 8.6 přináší užitečné funkce, ale jeho zastaralosti jsou často to, kde začíná údržbová práce. Opravte nejprve přímočaré aliasy, pak testujte behaviální migrace—zejména regex, CSV, session a locale-sensitive operace—proti skutečným datům.

Oficiální zdroje