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

Warning: preg_replace(): Compilation failed: reference to non-existent subpattern at offset 10 in index.php on line 3

Pe scurt

În tipar ai o referință înapoi (\2, \k<nume>) la un grup care nu există: ai un singur grup, dar ai scris \2. Numără parantezele de captură și folosește numărul corect (\1) sau numele corect al grupului.

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

Ce înseamnă

O referință înapoi în tipar (\1, \2, \k<nume>) înseamnă „același text pe care l-a prins grupul 1 / 2 / cu numele dat”. Grupurile se numerotează de la stânga la dreapta, după fiecare ( care nu e (?:.

Dacă tiparul are un singur grup și scrii \2, sau numele din \k<cuvant> nu există, compilarea eșuează: Compilation failed: reference to non-existent subpattern at offset N. Funcția (preg_match, preg_replace) întoarce false sau null, iar textul rămâne neschimbat ori se pierde.

Atenție: în înlocuire (al doilea argument al lui preg_replace), un $3 inexistent nu dă eroare, ci se înlocuiește cu text gol. Eroarea apare doar când referința greșită e în tipar.

De ce apare: cauzele frecvente

1Număr de grup greșit

Greșit
PHP
<?php
echo preg_replace('/\b(\w+) \2\b/u', '$1', 'fost fost');
Corect
PHP
<?php
echo preg_replace('/\b(\w+) \1\b/u', '$1', 'fost fost');

Tiparul are un singur grup, deci referința corectă e \1.

2Grupul numerotat s-a schimbat după ce ai pus (?:...)

Greșit
PHP
<?php
preg_match('/(?:ab)+(c)\2/', 'ababcc', $m);
Corect
PHP
<?php
preg_match('/(?:ab)+(c)\1/', 'ababcc', $m);

(?:...) nu creează grup, deci (c) e grupul 1.

3Nume de grup scris diferit

Greșit
PHP
<?php
preg_match('/(?<an>\d{4})-\k<anul>/', '2026-2026', $m);
Corect
PHP
<?php
preg_match('/(?<an>\d{4})-\k<an>/', '2026-2026', $m);

Numele din \k<...> trebuie să fie identic cu cel din (?<...>).

Repară tu

Repară eroarea, direct în pagină

Codul vrea să elimine cuvintele dublate dintr-un mesaj, dar preg_replace afișează Compilation failed: reference to non-existent subpattern. Repară tiparul, ca programul să afișeze Comanda a fost livrată azi.

Codul care dă eroarea
PHP
<?php
$text = 'Comanda a fost fost livrată livrată azi.';
$curat = preg_replace('/\b(\w+) \2\b/u', '$1', $text);
echo $curat . "\n";
După reparație, programul afișează
Comanda a fost livrată azi.
Indiciu

Tiparul are un singur grup de captură.

Alte forme ale mesajului

  • Warning: preg_match(): Compilation failed: reference to non-existent subpattern at offset 5 in index.php on line 3
  • Warning: preg_match(): Compilation failed: two named subpatterns have the same name (PCRE2_DUPNAMES not set) at offset 14 in index.php on line 3

Cum o eviți pe viitor

  • Numără parantezele de captură înainte să scrii \1, \2.
  • Pentru tipare mai lungi, folosește grupuri cu nume ((?<cuvant>...) și \k<cuvant>), care nu depind de ordine.
  • Verifică rezultatul: preg_replace întoarce null la eroare; preg_last_error_msg() îți spune ce s-a întâmplat.
  • Nu da același nume la două grupuri (varianta cu „same name”).

Întrebări frecvente

De ce $3 în înlocuire nu dă eroare?

În textul de înlocuire, PHP tratează un grup inexistent ca text gol. Doar în tipar (partea dintre delimitatori) referința greșită oprește compilarea.

Ce înseamnă varianta „two named subpatterns have the same name”?

Ai două grupuri cu același nume, de exemplu (?<an>..) de două ori. Redenumește unul sau adaugă modificatorul J, care permite nume duplicate.

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.