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
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_numericentitypentru drumul invers;htmlspecialchars/htmlentitiespentru 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
<?php
echo mb_convert_encoding('Brașov', 'HTML-ENTITIES', 'UTF-8');<?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
<?php
$dom = new DOMDocument();
$dom->loadHTML(mb_convert_encoding('<p>Preț</p>', 'HTML-ENTITIES', 'UTF-8'));<?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
<?php
echo mb_convert_encoding('Brașov', 'UTF-8', 'HTML-ENTITIES');<?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ă 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.
<?php
$adresa = 'Brașov, Piața Sfatului';
$entitati = mb_convert_encoding($adresa, 'HTML-ENTITIES', 'UTF-8');
echo $entitati . "\n";Brașov, Piața Sfatului
Indiciu
mb_encode_numericentity($text, [0x80, 0x10FFFF, 0, 0x1FFFFF], 'UTF-8').
Reparația
<?php
$adresa = 'Brașov, Piața Sfatului';
$entitati = mb_encode_numericentity($adresa, [0x80, 0x10FFFF, 0, 0x1FFFFF], 'UTF-8');
echo $entitati . "\n";De ce merge
Pseudo-codificarea HTML-ENTITIES a mbstring e învechită din PHP 8.2, deci apelul afișa mesajul Deprecated.
mb_encode_numericentity face explicit același lucru: harta [0x80, 0x10FFFF, 0, 0x1FFFFF] spune „toate caracterele de la 0x80 în sus devin entități numerice”. Literele ASCII rămân la fel, iar ș și ț devin ș și ț.
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 18Deprecated: 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
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'. Fatal error: Uncaught ValueError: mb_strlen(): Argument #2 ($encoding) must be a valid encoding, "utf8mb4" given in index.php:3 Ai dat unei funcții mb_* un nume de codare pe care mbstring nu-l cunoaște, cel mai des utf8mb4 (numele din MySQL) sau o greșeală de scriere. Pentru PHP scrie 'UTF-8', sau lasă argumentul deoparte: implicit e UTF-8. Deprecated: Constant FILTER_SANITIZE_STRING is deprecated since 8.1, use htmlspecialchars() instead in index.php on line 3 FILTER_SANITIZE_STRING (și aliasul FILTER_SANITIZE_STRIPPED) e învechit din PHP 8.1, pentru că nu proteja corect. Pentru afișare în HTML folosește htmlspecialchars(), pentru a scoate tagurile strip_tags(), iar pentru validare filter_var cu un filtru specific (FILTER_VALIDATE_EMAIL, FILTER_VALIDATE_INT). Î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.
