...
Eroare PHP · Mesaje Deprecated la upgrade de versiune

Deprecated: Function utf8_encode() is deprecated since 8.2, visit the php.net documentation for various alternatives in index.php on line 3

Pe scurt

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') întoarce true), nu-l converti.

De ce apare: cauzele frecvente

1Conversie din Latin-1

Greșit
PHP
<?php
$text = "Caf\xE9";
echo utf8_encode($text);
Corect
PHP
<?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

Greșit
PHP
<?php
$linie = file_get_contents('export.csv');
$linie = utf8_encode($linie);
Corect
PHP
<?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

Greșit
PHP
<?php
$pentruImprimanta = utf8_decode('Total: 100 lei');
Corect
PHP
<?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ă tu

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.

Codul care dă eroarea
PHP
<?php
function curata(string $latin1): string
{
    return utf8_encode($latin1);
}

foreach (["Caf\xE9", "Cr\xE8me br\xFBl\xE9e"] as $nume) {
    echo curata($nume) . "\n";
}
După reparație, programul afișează
Café
Crème brûlée
Indiciu

mb_convert_encoding($text, 'UTF-8', 'ISO-8859-1') face aceeași conversie.

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 3
  • Deprecated: 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, headerul Content-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

← Toate erorile PHP

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Î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.