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.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Funcțiile mb_* (mb_strlen, mb_substr, mb_strtoupper, mb_convert_encoding...) primesc opțional numele codării textului. Numele trebuie să fie unul cunoscut de extensia mbstring (vezi mb_list_encodings()): UTF-8, ISO-8859-2, Windows-1250, ASCII... Pentru un nume necunoscut, PHP 8 aruncă ValueError și îți arată ce ai trimis.
Cea mai frecventă cauză e utf8mb4: e numele setului de caractere din MySQL, nu un nume de codare. Pentru PHP, UTF-8 e pur și simplu UTF-8 (acceptă și utf8, utf-8). Alte cauze: greșeli de scriere (UTF8-, UFT-8), nume de colare (utf8mb4_romanian_ci) sau un nume citit dintr-o configurare.
PHP 7 dădea doar Warning: mb_strlen(): Unknown encoding "utf8mb4" și întorcea false. Mesajul arată numărul argumentului: la mb_strlen e #2, la mb_substr e #4.
De ce apare: cauzele frecvente
1Numele din MySQL
<?php
echo mb_strlen($nume, 'utf8mb4');<?php
echo mb_strlen($nume, 'UTF-8');utf8mb4 ține de baza de date; în PHP folosești UTF-8.
2Greșeală de scriere
<?php
echo mb_strtoupper($titlu, 'UFT-8');<?php
echo mb_strtoupper($titlu);Implicit, funcțiile mb_* folosesc mb_internal_encoding(), care e UTF-8. Argumentul e necesar doar pentru alte codări.
3Conversie dintr-o codare veche
<?php
$text = mb_convert_encoding($vechi, 'UTF-8', 'win-1250');<?php
$text = mb_convert_encoding($vechi, 'UTF-8', 'Windows-1250');Pentru fișiere vechi românești, codările uzuale sunt Windows-1250 și ISO-8859-2, scrise exact așa.
Repară eroarea, direct în pagină
Funcția verificaNume verifică dacă un nume de utilizator are între 3 și 12 caractere, dar programul se oprește cu ValueError: mb_strlen(): Argument #2 ($encoding) must be a valid encoding, "utf8mb4" given. Repară apelul, ca programul să afișeze Ștefănuț: 8 caractere, valid.
<?php
function verificaNume(string $nume): string
{
$n = mb_strlen($nume, 'utf8mb4');
$ok = $n >= 3 && $n <= 12 ? 'valid' : 'invalid';
return "$nume: $n caractere, $ok";
}
echo verificaNume('Ștefănuț') . "\n";Ștefănuț: 8 caractere, valid
Indiciu
utf8mb4 e numele din MySQL; în PHP codarea se numește UTF-8.
Reparația
<?php
function verificaNume(string $nume): string
{
$n = mb_strlen($nume, 'UTF-8');
$ok = $n >= 3 && $n <= 12 ? 'valid' : 'invalid';
return "$nume: $n caractere, $ok";
}
echo verificaNume('Ștefănuț') . "\n";De ce merge
mbstring nu are nicio codare numită utf8mb4; numele acesta există doar în MySQL. Din PHP 8, un nume de codare necunoscut aruncă ValueError.
Cu 'UTF-8', mb_strlen numără caracterele corect: 8, deși cuvântul ocupă 11 octeți (Ș, ă și ț au câte 2). Cu strlen ai fi primit 11.
Alte forme ale mesajului
Fatal error: Uncaught ValueError: mb_substr(): Argument #4 ($encoding) must be a valid encoding, "utf8mb4" given in index.php:3Fatal error: Uncaught ValueError: mb_strtoupper(): Argument #2 ($encoding) must be a valid encoding, "UFT-8" given in index.php:3Fatal error: Uncaught ValueError: mb_convert_encoding(): Argument #3 ($from_encoding) contains invalid encoding "win-1250" in index.php:3Warning: mb_strlen(): Unknown encoding "utf8mb4" in index.php on line 3
Cum o eviți pe viitor
- Ține minte:
utf8mb4în MySQL,UTF-8în PHP și HTML. - Lasă argumentul de codare deoparte când lucrezi în UTF-8; ai o sursă de greșeli mai puțin.
- Dacă codarea vine din configurare, verific-o o dată la pornire cu
in_array($enc, mb_list_encodings(), true). - Pentru conexiunea PDO la MySQL,
charset=utf8mb4se pune în DSN, nu în funcțiilemb_*.
Întrebări frecvente
Care e diferența dintre utf8 și utf8mb4 în MySQL?
În MySQL, utf8 (alias utf8mb3) stochează doar caractere de până la 3 octeți, iar utf8mb4 e UTF-8 complet (inclusiv emoji). În PHP nu există distincția: UTF-8 e mereu complet.
De ce am nevoie de mb_strlen și nu de strlen?
strlen numără octeți, iar în UTF-8 literele cu diacritice ocupă 2 octeți: strlen('ță') e 4. mb_strlen('ță') e 2, adică numărul real de caractere.
Erori înrudite
Fatal error: Uncaught TypeError: strlen(): Argument #1 ($string) must be of type string, array given in index.php:4 Dai unei funcții de text (strlen, trim, strtolower, str_contains...) un tablou în loc de un text. De obicei valoarea vine dintr-un câmp cu mai multe opțiuni sau dintr-un explode. Aplică funcția pe fiecare element sau alege elementul de care ai nevoie. 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 JsonException: Syntax error in index.php:4 Textul dat lui json_decode (cu JSON_THROW_ON_ERROR) nu e JSON valid: ghilimele simple, chei fără ghilimele, virgulă după ultimul element sau text gol. Corectează JSON-ul sau prinde JsonException și tratează datele invalide. Î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.
