...
Eroare PHP · Tipuri, operatori și conversii

Fatal error: Uncaught ValueError: mb_strlen(): Argument #2 ($encoding) must be a valid encoding, "utf8mb4" given in index.php:3

Pe scurt

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

Greșit
PHP
<?php
echo mb_strlen($nume, 'utf8mb4');
Corect
PHP
<?php
echo mb_strlen($nume, 'UTF-8');

utf8mb4 ține de baza de date; în PHP folosești UTF-8.

2Greșeală de scriere

Greșit
PHP
<?php
echo mb_strtoupper($titlu, 'UFT-8');
Corect
PHP
<?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

Greșit
PHP
<?php
$text = mb_convert_encoding($vechi, 'UTF-8', 'win-1250');
Corect
PHP
<?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ă tu

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.

Codul care dă eroarea
PHP
<?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";
După reparație, programul afișează
Ștefănuț: 8 caractere, valid
Indiciu

utf8mb4 e numele din MySQL; în PHP codarea se numește UTF-8.

Alte forme ale mesajului

  • Fatal error: Uncaught ValueError: mb_substr(): Argument #4 ($encoding) must be a valid encoding, "utf8mb4" given in index.php:3
  • Fatal error: Uncaught ValueError: mb_strtoupper(): Argument #2 ($encoding) must be a valid encoding, "UFT-8" given in index.php:3
  • Fatal error: Uncaught ValueError: mb_convert_encoding(): Argument #3 ($from_encoding) contains invalid encoding "win-1250" in index.php:3
  • Warning: 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=utf8mb4 se pune în DSN, nu în funcțiile mb_*.

Î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

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