Strony internetowe i programowanie

PHP 8.6: Nowe funkcje, przestarzałe funkcje i praktyczny przewodnik migracyjny

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

Zaktualizuj do PHP 8.6 z przykładami przed i po dla przestarzałych funkcji PHP, MySQLi, mbstring, CSV, sesji oraz praktyczną listą kontrolną migracji.

PHP 8.6.0 został wydany 19 listopada 2026 r. Główne funkcje są interesujące, ale dla programistów utrzymujących prawdziwe strony internetowe palące pytanie jest często inne: które linie istniejącego kodu zaczną emitować komunikaty o przestarzałości, i jak powinny zostać przepisane?

Ten przewodnik stawia pracę migracyjną na pierwszym miejscu. Każdy przykład identyfikuje przestarzałe API, pokazuje zamiennik i wskazuje, gdzie mechaniczne szukanie i zamiana mogą być niebezpieczne. Komunikat o przestarzałości nie jest tożsame z natychmiastowym błędem krytycznym: ostrzega, że kod wymaga uwagi, często przed usunięciem API w przyszłej wersji major.

Ścieżka migracji PHP 8.6: inwentaryzacja, środowisko testowe, logi, poprawki i testy regresyjne

1. Sprawdź środowisko uruchomieniowe przed wprowadzeniem zmian na produkcji

Uruchom te polecenia w tym samym środowisku PHP, które obsługuje aplikację (CLI i PHP sieci Web mogą używać różnych plików binarnych i ustawień):

php -v
php -m
php --ini

Sprawdź rozszerzenia używane przez projekt, zwłaszcza mbstring, mysqli i intl. Zweryfikuj, czy framework, CMS, rozszerzenia i środowisko hostingowe wyraźnie obsługują PHP 8.6; nie wnioskuj o zgodności wyłącznie dlatego, że strona się uruchamia.

W środowisku testowym rejestruj wszystkie błędy, trzymając komunikaty diagnostyczne z dala od publicznego HTML:

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

Te ustawienia środowiska uruchomieniowego są przydatne do kontrolowanego testu. Zalecana jest konfiguracja rejestrowania na poziomie serwera dla środowisk długotrwałych; upewnij się, że dziennik błędów jest zapisywalny i prywatny. Komunikat Deprecated jest możliwy do podjęcia działań nawet wtedy, gdy strona nadal się renderuje.

2. Szybka referencia: przestarzałe API i co zamiast tego użyć

Przestarzałe w PHP 8.6 Zalecane podejście Uwaga dotycząca migracji
is_integer(), is_long() is_int() Bezpośrednie aliasy
is_double() is_float() Bezpośredni alias
doubleval() floatval() Bezpośredni alias
spl_object_hash() spl_object_id() Typ zwracany zmienia się z string na int
mb_ereg(), mb_eregi() preg_match() Dostosuj składnię wzorca i flagi Unicode
mb_ereg_replace() preg_replace() Sprawdź escaparowanie, semantykę zastępowania i błędy
mysqli_stmt_init() mysqli_prepare() Przygotuj się natychmiast
mysqli_get_charset() mysqli_character_set_name() Tylko jeśli nazwa zestawu znaków jest potrzebna
SplFileObject::fgetcsv() fgetcsv() na strumieniu Sprawdź ponownie pozycję strumienia i ustawienia CSV
SplFileObject::fputcsv() fputcsv() na strumieniu Przekaż delimiter, otoczenie i escape jawnie
strcoll() Collator::compare() Wymaga intl; wybierz locale
SORT_LOCALE_STRING Collator::sort() / asort() Zachowanie zależne od locale może się zmienić
spl_classes() ReflectionExtension::getClassNames() Zbadaj odpowiednie rozszerzenie
Trzeci argument define() Pominąć argument Stary tryb niezależny od wielkości liter został usunięty
return w finally Zwróć poza finally Unikaj tłumienia wyjątków
Obiekt przekazany do array_walk() Najpierw get_object_vars() Edycje przez odwołanie mogą już nie mutować obiektu
metaphone() Utrzymywana implementacja fonetyczna Brak gotowego zamiennika w rdzeniu

Niektóre API nie mają dokładnego zamiennika. Prawidłowa migracja może wymagać zmiany projektu zamiast zmiany nazwy funkcji. Zobacz oficjalną listę przestarzałości PHP 8.6.

3. Proste aliasy: bezpieczne, szybkie poprawki

Przed — przestarzałe:

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

Aliasy mają takie same semantyki. Nie zakładaj, że is_float(40) jest prawdą: liczba całkowita pozostaje liczbą całkowitą. To zachowanie było już obecne przed migracją.

W przypadku kwoty w formie ciągu znaków, floatval() jest konwersją, nie bezpieczną pieniężnie reprezentacją dziesiętną. Zachowaj istniejącą strategię obsługi pieniędzy w projekcie zamiast zmieniać ją w ramach niepowiązanego upgrade'u PHP.

4. Migracja wyrażeń regularnych mbstring

Rodzina mb_ereg* jest przestarzała, ponieważ jej silnik regex Oniguruma nie jest już utrzymywany. PHP zaleca PCRE w wielu przypadkach użycia, ale dialekty wzorców nie są identyczne.

Przed:

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

Po (tylko cyfry ASCII):

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

Tutaj modyfikator D sprawia, że $ pasuje tylko na końcu podmiotu. Dla tekstu Unicode użyj odpowiedniego wzorca UTF-8 i modyfikatora u:

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

Przed — zamiana:

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

Po — zamiana:

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

Oba wzorce mogą się różnić w przypadku niektórych białych znaków Unicode. Przy prawdziwej migracji przetestuj znaki z akcentami, znaki nowej linii, nieprawidłowy UTF-8, grupy przechwytywania i odwołania wsteczne względem rzeczywistych danych projektu. Nie wykonuj masowej zamiany każdego wywołania mb_ereg bez przeglądania wyrażenia.

5. MySQLi: przygotuj zapytanie w jednym kroku

Przed — przestarzałe:

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

Przy obiektowo-zorientowanym API użyj $mysqli->prepare($sql) zamiast $mysqli->stmt_init(), a następnie prepare(). Zachowaj istniejącą obsługę błędów i zamykaj zapytania odpowiednio.

Osobne API mysqli_get_charset() jest również przestarzałe. Jeśli potrzebujesz tylko bieżącej nazwy zestawu znaków:

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

To nie jest zamiennikiem wszystkich pól starego obiektu informacji o zestawie znaków. Jeśli kod zależy od metadanych collation, zbadaj, czego w rzeczywistości potrzebuje, i zapytuj serwer odpowiednio.

6. CSV: zastąp przestarzałe metody CSV SplFileObject

Metody specyficzne dla CSV w SplFileObject są przestarzałe. Dla nowego i zmigrowanego kodu użyj funkcji opartej na strumieniach fgetcsv() i fputcsv().

Przed:

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

Pusty argument escape wyłącza własny mechanizm escapowania PHP; przetestuj ten wybór względem formatu eksportowanego przez system źródłowy. Sprawdź puste linie, nagłówki, separatory, osadzone znaki nowej linii i kodowanie. Ten przykład ilustruje zmianę API, a nie uniwersalny parser CSV.

Do zapisu użyj fputcsv($handle, $fields, ',', '"', ''). Zachowaj oczekiwany dialect oryginalnego pliku.

7. Tożsamość obiektu: spl_object_hash() nie jest haszem zawartości

Przed:

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

Po:

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

Zamiennik zwraca liczbę całkowitą, a nie ciąg znaków. Jeśli klucze są serializowane, przechowywane w bazie danych lub udostępniane przez API, najpierw przejrzyj konsumentów. Żadna z funkcji nie tworzy trwałego identyfikatora między żądaniami, a identyfikatory mogą być ponownie używane po zniszczeniu obiektów. Dla mapy indeksowanej przez żywą tożsamość obiektu, rozważ SplObjectStorage lub WeakMap, w zależności od wymagań dotyczących czasu życia.

8. Return w finally może ukrywać błędy

Przed — przestarzałe i mylące:

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

Po — zachowaj czyszczenie bez nadpisywania wyniku:

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

Jeśli oryginalny kod celowo zwracał rozwiązanie zastępcze, przenieś tę decyzję do bloku catch z jawną obsługą. Nie połykaj cicho wyjątku, który powinien dotrzeć do wywołującego.

9. Sortowanie zależne od locale i inne mniej oczywiste zmiany

strcoll() i flaga sortowania SORT_LOCALE_STRING są przestarzałe. Zalecaną alternatywą intl jest Collator:

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

Sprawdź, czy intl jest zainstalowane. Sortowanie z uwzględnieniem locale to reguła biznesowa: przetestuj oczekiwaną kolejność zamiast zakładać, że ICU i locale globalne procesu zawsze będą zachowywać się identycznie.

Inne elementy migracji zasługują na wyraźną uwagę:

  • ArrayIterator: sortowanie, flagi i metody serializacji, takie jak asort(), ksort(), setFlags() i serialize() są przestarzałe. Posortuj bazową tablicę lub użyj ArrayObject, gdy jego API jest odpowiednie; nie zakładaj, że iterator i kontener są wymienne.
  • Niestandardowe obsługi sesji: zaimplementuj zarówno create_sid(), jak i validateId() zgodnie z wymaganiami zaktualizowanych interfejsów/zachowań. PHP 8.6 włącza bardziej rygorystyczne ustawienia domyślne sesji; przetestuj logowanie, rotację sesji i trwałość.
  • __debugInfo(): użyj niezerowalnego typu zwracanego array; zwracanie null było już wcześniej przestarzałe.
  • define(): usuń trzeci argument case_insensitive, nawet jeśli jest false.
  • http_build_query() i array_walk(): przekazywanie obiektów tam, gdzie oczekiwane są tablice, jest przestarzałe. Konwertuj celowo używając get_object_vars() lub konstruuj żądaną tablicę jawnie.
  • metaphone(): nie istnieje odpowiednik wbudowanego zamiennika PHP. Wybierz i przetestuj utrzymywany, odpowiedni językowo algorytm fonetyczny.
  • Zastrzeżone identyfikatory: nazwy takie jak let, is, readonly (funkcja) i namespace (stała klasy) mają nowe ograniczenia przestarzałości. Zmień nazwę dotkniętych deklaracji ostrożnie.
  • Refleksja: przejrzyj nieprawidłowe obiekty przekazane do ReflectionProperty::setValue() oraz argumenty obiektów podawane podczas wywoływania metod statycznych.

Skonsultuj się z pełnym przewodnikiem migracyjnym w przypadku przypadków brzegowych nieobjętych tym practicalnym wyborem.

10. Znajdź przestarzałe wywołania w istniejącym projekcie

Zacznij od inwentaryzacji tylko do odczytu. W systemie Linux lub 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

Zastąp ./src rzeczywistym katalogiem. To wyszukiwanie tekstowe może dopasować komentarze lub łańcuchy, a pominie wywołania dynamiczne, aliasy z przestrzenią nazw i inne przestarzałe API. Jest to punkt wyjścia, nie pełny analizator statyczny.

W przypadku opcji międzyplatformowej, funkcja Znajdź w plikach edytora może wyszukiwać te same nazwy. Nie edytuj bezpośrednio plików vendor ani rdzenia CMS: zaktualizuj pakiet źródłowy lub prześlij łatkę do jego maintainera.

Bezpieczny przepływ pracy migracji PHP 8.6 z środowiskiem testowym, przeglądem logów i testami regresyjnymi

Powtarzalna sekwencja migracji

  1. Zapisz bieżącą wersję PHP i włączone rozszerzenia.
  2. Zrób kopię zapasową plików i bazy danych; przygotuj kopię środowiska testowego.
  3. Uruchom projekt pod PHP 8.6 z włączonym rejestrowaniem przestarzałości.
  4. Sporządź inwentaryzację ostrzeżeń według pliku i linii, a następnie pogrupuj według API.
  5. Napraw kod własny wprowadzając ukierunkowane zmiany; zaktualizuj zależności zewnętrzne osobno.
  6. Ponownie uruchom testy jednostkowe/integracyjne i ważne ścieżki użytkownika.
  7. Sprawdź formularze, logowanie, sesje, e-mail, płatności, zadania harmonogramowane, import/eksport CSV oraz dostęp do bazy danych.
  8. Wdróż z planem wycofania; monitoruj dzienniki błędów po wydaniu.

Joomla i WordPress: wydanie PHP 8.6 nie oznacza, że każda wersja CMS, rozszerzenie lub wtyczka go obsługuje. Potwierdź zgodność z dokładnymi wersjami w użyciu i najpierw przetestuj środowisko testowe. Nie używaj uaktualnienia jako powodu do bezpośredniego łatania rdzenia lub kodu vendor.

11. Co jest naprawdę nowe w PHP 8.6?

Poza przestarzałościami, wydanie dodaje kilka funkcji językowych i środowiskowych:

Funkcja Praktyczne zastosowanie
Częściowe zastosowanie funkcji Wstępne wypełnienie argumentów i uzyskanie wywoływalnego dla pozostałych
clamp() Ograniczenie wartości między minimum a maksimum
\Time\Duration Reprezentacja upływającego czasu zamiast daty kalendarzowej
SortDirection Wyrażenie kierunku rosnącego/malejącego przez standardowy wyliczenie
Io\Poll Obsługa sondowania strumieni w bibliotece pętli zdarzeń i I/O
Wartości domyślne dla właściwości tylko do odczytu Uproszczenie wybranych deklaracji klas niezmiennych

Mały, od razu przydatny przykład to clamp():

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

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

Kod jest łatwiejszy w czytaniu, ale priorytetem migracji powinny nadal być testy zgodności. Pozostałe funkcje nie są konieczne, aby istniejąca aplikacja nadal działała. Zobacz oficjalne ogłoszenie wydania.

12. Przed przełączeniem wersji PHP w produkcji

Traktuj PHP 8.6 jako kontrolowaną aktualizację, a nie przycisk do kliknięcia na obciążonym serwerze produkcyjnym. Rozsądna lista kontrolna wydania obejmuje: obsługiwany CMS i zależności; dostępne rozszerzenia; brak nieoczekiwanej powodzi przestarzałości; testy przechodzą; zweryfikowane zachowanie bazy danych i sesji; przetestowane kopie zapasowe; oraz procedurę wycofania.

Podsumowując: PHP 8.6 przynosi przydatne funkcje, ale jego przestarzałości są często miejscem, gdzie zaczyna się praca konserwacyjna. Napraw najpierw proste aliasy, a następnie przetestuj migracje behawioralne—zwłaszcza regex, CSV, sesje i operacje zależne od locale—przeciwko rzeczywistym danym.

Źródła oficjalne