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

Deprecated: mb_convert_encoding(): Handling HTML entities via mbstring is deprecated; use htmlspecialchars, htmlentities, or mb_encode_numericentity/mb_decode_numericentity instead in index.php on line 3

Pe scurt

Ai folosit mb_convert_encoding($text, 'HTML-ENTITIES', 'UTF-8'), un truc vechi pentru a transforma diacriticele în entități (de exemplu înainte de DOMDocument::loadHTML). Din PHP 8.2 e învechit. Folosește mb_encode_numericentity() sau, la DOM, un meta charset UTF-8.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

Codificarea HTML-ENTITIES a extensiei mbstring transforma caracterele non-ASCII în entități HTML: ș devenea ș. Era folosită mai ales într-un truc pentru DOMDocument::loadHTML, care citește implicit textul ca ISO-8859-1 și strică diacriticele: loadHTML(mb_convert_encoding($html, 'HTML-ENTITIES', 'UTF-8')).

Din PHP 8.2, folosirea lui HTML-ENTITIES (sau HTML) cu funcțiile mbstring afișează acest Deprecated, iar mesajul îți dă alternativele:

  • mb_encode_numericentity($text, [0x80, 0x10FFFF, 0, 0x1FFFFF], 'UTF-8') pentru același rezultat (entități numerice);
  • mb_decode_numericentity pentru drumul invers;
  • htmlspecialchars / htmlentities pentru escaparea textului afișat în HTML.

La DOM, varianta curată e să adaugi <meta charset="UTF-8"> sau prefixul <?xml encoding="UTF-8"> înainte de loadHTML.

De ce apare: cauzele frecvente

1Diacritice transformate în entități

Greșit
PHP
<?php
echo mb_convert_encoding('Brașov', 'HTML-ENTITIES', 'UTF-8');
Corect
PHP
<?php
echo mb_encode_numericentity('Brașov', [0x80, 0x10FFFF, 0, 0x1FFFFF], 'UTF-8');

Harta [0x80, 0x10FFFF, 0, 0x1FFFFF] transformă în entități tot ce nu e ASCII, exact ca vechiul truc.

2Trucul pentru DOMDocument::loadHTML

Greșit
PHP
<?php
$dom = new DOMDocument();
$dom->loadHTML(mb_convert_encoding('<p>Preț</p>', 'HTML-ENTITIES', 'UTF-8'));
Corect
PHP
<?php
$dom = new DOMDocument();
$dom->loadHTML('<?xml encoding="UTF-8"><p>Preț</p>');

Prefixul spune parserului că textul e UTF-8, deci diacriticele rămân corecte fără entități.

3Decodare de entități cu mbstring

Greșit
PHP
<?php
echo mb_convert_encoding('Brașov', 'UTF-8', 'HTML-ENTITIES');
Corect
PHP
<?php
echo html_entity_decode('Brașov', ENT_QUOTES | ENT_HTML5, 'UTF-8');

html_entity_decode transformă entitățile înapoi în caractere UTF-8.

Repară tu

Repară eroarea, direct în pagină

Codul transformă diacriticele dintr-un nume de oraș în entități HTML cu mb_convert_encoding(..., 'HTML-ENTITIES', 'UTF-8') și afișează Deprecated: ... Handling HTML entities via mbstring is deprecated. Folosește mb_encode_numericentity cu harta [0x80, 0x10FFFF, 0, 0x1FFFFF], ca programul să afișeze Brașov, Piața Sfatului.

Codul care dă eroarea
PHP
<?php
$adresa = 'Brașov, Piața Sfatului';
$entitati = mb_convert_encoding($adresa, 'HTML-ENTITIES', 'UTF-8');
echo $entitati . "\n";
După reparație, programul afișează
Brașov, Piața Sfatului
Indiciu

mb_encode_numericentity($text, [0x80, 0x10FFFF, 0, 0x1FFFFF], 'UTF-8').

Alte forme ale mesajului

  • PHP Deprecated: mb_convert_encoding(): Handling HTML entities via mbstring is deprecated; use htmlspecialchars, htmlentities, or mb_encode_numericentity/mb_decode_numericentity instead in /var/www/html/parser.php on line 18
  • Deprecated: mb_convert_encoding(): Handling HTML entities via mbstring is deprecated; use htmlspecialchars, htmlentities, or mb_encode_numericentity/mb_decode_numericentity instead in index.php on line 7

Cum o eviți pe viitor

  • Caută în proiect 'HTML-ENTITIES' când treci la PHP 8.2+.
  • Pentru afișare în pagină ai nevoie doar de htmlspecialchars; diacriticele pot rămâne UTF-8 dacă pagina are <meta charset="UTF-8">.
  • La DOM, folosește prefixul de encoding sau, din PHP 8.4, Dom\HTMLDocument::createFromString, care înțelege UTF-8 corect.

Întrebări frecvente

Mai am nevoie de entități pentru diacritice?

De obicei nu. Dacă pagina și baza de date sunt UTF-8, diacriticele se afișează corect ca atare. Entitățile mai sunt utile doar în sisteme vechi care nu acceptă UTF-8.

Rezultatul lui mb_encode_numericentity e identic?

Pentru caractere ca ș, ț, ă, da: ș, ț, ă. Vechiul HTML-ENTITIES folosea uneori entități cu nume (de exemplu –); funcția nouă dă mereu entități numerice, pe care browserul le afișează la fel.

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.