...
Eroare PHP · Excepții, JSON și expresii regulate

Warning: preg_match(): Compilation failed: range out of order in character class at offset 8 in index.php on line 3

Pe scurt

Într-o clasă de caractere [...] ai un interval invers, de exemplu [z-a], sau o cratimă pusă între două caractere, ca în [a-z_-.], pe care PCRE o citește ca interval „de la _ la .”. Pune cratima la începutul sau la sfârșitul clasei ([a-z_.-]) sau scrie-o \-.

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

Ce înseamnă

Într-o clasă de caractere, - între două caractere înseamnă interval: [a-z] = toate literele de la a la z, după ordinea din tabelul de caractere. Intervalul trebuie să meargă de la caracterul mai mic la cel mai mare. [z-a] e invers, deci invalid.

Mult mai des, intervalul invers e involuntar: în [a-z0-9_-.] voiai să permiți _, - și ., dar PCRE citește _-. ca interval de la _ (cod 95) la . (cod 46), care e invers. Mesajul arată poziția (offset) caracterului de după interval.

Când cratima e lângă o clasă ca \w sau \d ([\w-.]), mesajul e invalid range in character class, cu aceeași cauză. preg_match afișează warning-ul și întoarce false, iar codul tratează de obicei false ca „nu se potrivește”.

De ce apare: cauzele frecvente

1Cratimă între alte caractere

Greșit
PHP
<?php
preg_match('/^[a-z0-9_-.]+$/', 'ana.pop');
Corect
PHP
<?php
preg_match('/^[a-z0-9_.-]+$/', 'ana.pop');

Pusă la finalul (sau începutul) clasei, cratima nu mai poate forma un interval și e căutată literal.

2Cratimă lângă \w

Greșit
PHP
<?php
preg_match('/^[\w-.]+@/', 'ana-pop@exemplu.ro');
Corect
PHP
<?php
preg_match('/^[\w.\-]+@/', 'ana-pop@exemplu.ro');

\- e cratima literală, oriunde ar fi în clasă.

3Interval scris invers

Greșit
PHP
<?php
preg_match('/^[9-0]{4}$/', '2026');
Corect
PHP
<?php
preg_match('/^[0-9]{4}$/', '2026');

Intervalele se scriu de la mic la mare.

Repară tu

Repară eroarea, direct în pagină

Funcția utilizatorValid verifică numele de utilizator (litere mici, cifre, punct, cratimă și underscore), dar afișează Warning: preg_match(): Compilation failed: range out of order in character class și respinge orice nume. Repară clasa de caractere, ca programul să afișeze ana.pop: valid, mihai-2: valid și Ion Pop: invalid.

Codul care dă eroarea
PHP
<?php
function utilizatorValid(string $u): bool
{
    return preg_match('/^[a-z0-9_-.]+$/', $u) === 1;
}

foreach (['ana.pop', 'mihai-2', 'Ion Pop'] as $u) {
    echo $u . ': ' . (utilizatorValid($u) ? 'valid' : 'invalid') . "\n";
}
După reparație, programul afișează
ana.pop: valid
mihai-2: valid
Ion Pop: invalid
Indiciu

Mută cratima la finalul clasei: [a-z0-9_.-].

Alte forme ale mesajului

  • Warning: preg_match(): Compilation failed: invalid range in character class at offset 5 in index.php on line 3
  • Warning: preg_replace(): Compilation failed: range out of order in character class at offset 8 in index.php on line 3
  • Warning: preg_match(): Compilation failed: range out of order in character class at offset 3 in index.php on line 3

Cum o eviți pe viitor

  • Pune cratima literală mereu la finalul clasei ([a-z0-9._-]) sau scrie-o \-.
  • Testează expresia pe regex101 (modul PCRE2) cu câteva exemple valide și invalide.
  • Verifică rezultatul: if (preg_match(...) === false) { throw new RuntimeException(preg_last_error_msg()); }.
  • Pentru validări uzuale (email, URL), preferă filter_var() în locul unei expresii regulate scrise de mână.

Întrebări frecvente

De ce [a-z-] merge, dar [a-z-.] nu?

În [a-z-], cratima e ultima, deci nu are ce interval să formeze și e literală. În [a-z-.], după intervalul a-z vine -.; PCRE2 o tratează ca interval invalid. Mută cratima la final: [a-z.-].

Intervalele merg și pentru litere cu diacritice?

Doar cu modificatorul u și tot după codurile Unicode, unde ă, â, î, ș, ț nu sunt între a și z. Adaugă-le explicit: /^[a-zăâîșț]+$/iu.

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.