PHP 8.6: Nowe funkcje, przestarzałe funkcje i praktyczny przewodnik migracyjny
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.
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);

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:

<?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 jakasort(),ksort(),setFlags()iserialize()są przestarzałe. Posortuj bazową tablicę lub użyjArrayObject, gdy jego API jest odpowiednie; nie zakładaj, że iterator i kontener są wymienne.- Niestandardowe obsługi sesji: zaimplementuj zarówno
create_sid(), jak ivalidateId()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 zwracanegoarray; zwracanienullbyło już wcześniej przestarzałe.define(): usuń trzeci argumentcase_insensitive, nawet jeśli jestfalse.http_build_query()iarray_walk(): przekazywanie obiektów tam, gdzie oczekiwane są tablice, jest przestarzałe. Konwertuj celowo używającget_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) inamespace(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.
Powtarzalna sekwencja migracji
- Zapisz bieżącą wersję PHP i włączone rozszerzenia.
- Zrób kopię zapasową plików i bazy danych; przygotuj kopię środowiska testowego.
- Uruchom projekt pod PHP 8.6 z włączonym rejestrowaniem przestarzałości.
- Sporządź inwentaryzację ostrzeżeń według pliku i linii, a następnie pogrupuj według API.
- Napraw kod własny wprowadzając ukierunkowane zmiany; zaktualizuj zależności zewnętrzne osobno.
- Ponownie uruchom testy jednostkowe/integracyjne i ważne ścieżki użytkownika.
- Sprawdź formularze, logowanie, sesje, e-mail, płatności, zadania harmonogramowane, import/eksport CSV oraz dostęp do bazy danych.
- 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.