Deprecated: Function utf8_encode() is deprecated since 8.2, visit the php.net documentation for various alternatives in index.php on line 3
utf8_encode() și utf8_decode() sunt învechite din PHP 8.2: convertesc doar din și în ISO-8859-1 (Latin-1), deși numele sugerează altceva. Folosește mb_convert_encoding($text, 'UTF-8', 'ISO-8859-1') sau, pentru diacritice românești, sursa corectă: 'Windows-1250' ori 'ISO-8859-2'.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Numele utf8_encode() e înșelător: funcția nu „repară” orice text, ci convertește doar din ISO-8859-1 (Latin-1) în UTF-8. Latin-1 nu conține ș, ț, ă, î, â în forma românească, așa că un text vechi în Windows-1250 sau ISO-8859-2 iese stricat. Mulți au folosit funcția pe texte care erau deja UTF-8, obținând caractere dublu codificate (î în loc de î). De aceea, din PHP 8.2 ambele funcții sunt Deprecated și vor fi scoase.
Înlocuitorul e mb_convert_encoding($text, 'UTF-8', $codificareSursa) (extensia mbstring) sau iconv(). Partea importantă e să știi codificarea reală a textului:
- fișiere CSV exportate din Excel vechi în română: de obicei
Windows-1250; - texte Latin-1 (vest-europene):
ISO-8859-1; - dacă textul e deja UTF-8 (
mb_check_encoding($t, 'UTF-8')întoarcetrue), nu-l converti.
De ce apare: cauzele frecvente
1Conversie din Latin-1
<?php
$text = "Caf\xE9";
echo utf8_encode($text);<?php
$text = "Caf\xE9";
echo mb_convert_encoding($text, 'UTF-8', 'ISO-8859-1');Conversia e aceeași, dar sursa e scrisă explicit.
2CSV românesc din Excel vechi
<?php
$linie = file_get_contents('export.csv');
$linie = utf8_encode($linie);<?php
$linie = file_get_contents('export.csv');
if (!mb_check_encoding($linie, 'UTF-8')) {
$linie = mb_convert_encoding($linie, 'UTF-8', 'Windows-1250');
}Literele românești sunt în Windows-1250, nu în Latin-1. Convertești doar dacă textul nu e deja UTF-8.
3utf8_decode pentru un sistem vechi
<?php
$pentruImprimanta = utf8_decode('Total: 100 lei');<?php
$pentruImprimanta = mb_convert_encoding('Total: 100 lei', 'ISO-8859-1', 'UTF-8');Și conversia inversă se face cu mb_convert_encoding, cu argumentele în ordinea țintă, sursă.
Repară eroarea, direct în pagină
Un sistem vechi trimite numele produselor în Latin-1 (ISO-8859-1), iar funcția curata le convertește cu utf8_encode(), afișând Deprecated: Function utf8_encode() is deprecated since 8.2. Înlocuiește conversia cu mb_convert_encoding, ca programul să afișeze Café și Crème brûlée, fără mesaje Deprecated.
<?php
function curata(string $latin1): string
{
return utf8_encode($latin1);
}
foreach (["Caf\xE9", "Cr\xE8me br\xFBl\xE9e"] as $nume) {
echo curata($nume) . "\n";
}Café Crème brûlée
Indiciu
mb_convert_encoding($text, 'UTF-8', 'ISO-8859-1') face aceeași conversie.
Reparația
<?php
function curata(string $latin1): string
{
return mb_convert_encoding($latin1, 'UTF-8', 'ISO-8859-1');
}
foreach (["Caf\xE9", "Cr\xE8me br\xFBl\xE9e"] as $nume) {
echo curata($nume) . "\n";
}De ce merge
Textele de intrare au literele accentuate codificate pe un singur octet, ca în Latin-1 (\xE9 = é). utf8_encode făcea conversia corect, dar e Deprecated din PHP 8.2 pentru că numele lui ascunde faptul că acceptă doar Latin-1.
mb_convert_encoding($text, 'UTF-8', 'ISO-8859-1') face exact aceeași conversie, cu sursa scrisă explicit. Dacă datele ar fi venit în Windows-1250 (cu ș și ț), ai fi schimbat doar al treilea argument.
Alte forme ale mesajului
Deprecated: Function utf8_decode() is deprecated since 8.2, visit the php.net documentation for various alternatives in index.php on line 3Deprecated: Function utf8_encode() is deprecated in index.php on line 3
Cum o eviți pe viitor
- Lucrează intern doar cu UTF-8 (fișiere sursă, baza de date cu
utf8mb4, headerulContent-Type: text/html; charset=utf-8). - Convertește doar la marginea aplicației (import de fișiere vechi, export spre sisteme vechi) și scrie mereu codificarea sursă explicit.
- Verifică înainte cu
mb_check_encoding(), ca să nu convertești de două ori.
Întrebări frecvente
De ce după utf8_encode văd î în loc de î?
Textul era deja UTF-8, iar utf8_encode l-a mai codificat o dată, tratând fiecare octet ca pe o literă Latin-1. Nu converti textele care sunt deja UTF-8.
Ce fac dacă nu am extensia mbstring?
Folosește iconv('ISO-8859-1', 'UTF-8', $text) sau UConverter::transcode() din intl. Pe aproape toate serverele mbstring e însă instalată.
Erori înrudite
Deprecated: Function strftime() is deprecated since 8.1, use IntlDateFormatter::format() instead in index.php on line 3 strftime() (formatarea datelor după limba sistemului, cu setlocale) e învechită din PHP 8.1 și va dispărea. Folosește IntlDateFormatter (extensia intl) pentru nume de luni și zile în română sau DateTimeImmutable::format() cu propriile denumiri pentru formate simple. Deprecated: htmlspecialchars(): Passing null to parameter #1 ($string) of type string is deprecated in index.php on line 4 Dai null unei funcții PHP care așteaptă text (htmlspecialchars, trim, strlen, str_replace...). De obicei valoarea vine dintr-o cheie lipsă sau dintr-o coloană goală din baza de date. Dă o valoare implicită: htmlspecialchars($x ?? ''). Warning: preg_match(): Compilation failed: range out of order in character class at offset 8 in index.php on line 3 Într-o clasă de caractere [...] ai un interval invers, de exemplu [z-a], sau o cratimă pusă între două caractere, ca în [a-z_-.], pe care PCRE o citește ca interval „de la _ la .”. Pune cratima la începutul sau la sfârșitul clasei ([a-z_.-]) sau scrie-o \-. Învață PHP de la zero, cu exerciții la fiecare lecție
Curs PHP: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
