...
Eroare PHP · Funcții și argumente

Fatal error: Uncaught ValueError: strpos(): Argument #3 ($offset) must be contained in argument #1 ($haystack) in index.php:4

Pe scurt

Ai cerut lui strpos() să caute începând de la o poziție aflată după sfârșitul textului (sau prea în stânga, cu offset negativ). Offset-ul trebuie să fie între -strlen($text) și strlen($text). Verifică lungimea textului înainte sau folosește str_contains / substr.

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

Ce înseamnă

Al treilea argument al lui strpos($text, $cauta, $offset) spune de unde începe căutarea. Poziția trebuie să fie în text: de la 0 la strlen($text) (inclusiv, caz în care rezultatul e false) sau negativă, numărând de la final, până la -strlen($text). În afara acestor limite, PHP 8 aruncă ValueError (PHP 7 afișa Warning: strpos(): Offset not contained in string și întorcea false).

Același mesaj îl dau stripos, strrpos, strripos, mb_strpos și, cu alt nume de argument, substr_count.

Cauze frecvente: un offset fix (de ex. „după data din log, de la poziția 20”) aplicat pe un rând mai scurt, un offset calculat într-o buclă care trece de final sau o poziție calculată în octeți folosită pe un text cu diacritice (unde strlen și mb_strlen diferă).

De ce apare: cauzele frecvente

1Offset fix pe text mai scurt

Greșit
PHP
<?php
$poz = strpos($linie, ':', 20);
Corect
PHP
<?php
$poz = strlen($linie) > 20 ? strpos($linie, ':', 20) : false;

Cauți de la poziția 20 doar dacă textul e destul de lung.

2Offset calculat într-o buclă

Greșit
PHP
<?php
$poz = 0;
while (($poz = strpos($text, 'a', $poz + 2)) !== false) {
    $n++;
}
Corect
PHP
<?php
$n = substr_count($text, 'a');

Pentru numărare, substr_count face totul fără offset-uri manuale.

3Offset negativ prea mare

Greșit
PHP
<?php
$poz = strpos('abc', 'a', -5);
Corect
PHP
<?php
$poz = strpos('abc', 'a', max(-5, -strlen('abc')));

Un offset negativ numără de la final și nu poate depăși lungimea textului.

Repară tu

Repară eroarea, direct în pagină

Funcția mesaj extrage textul de după : dintr-o linie de log care începe cu data și ora (19 caractere). Pentru o linie fără dată, programul se oprește cu ValueError: strpos(): Argument #3 ($offset) must be contained in argument #1 ($haystack). Repară funcția (caută : de la început dacă linia e mai scurtă de 20 de caractere), ca programul să afișeze disc plin și pornit.

Codul care dă eroarea
PHP
<?php
function mesaj(string $linie): string
{
    $poz = strpos($linie, ':', 20);
    return trim(substr($linie, $poz + 1));
}

echo mesaj('2026-11-01 10:15:00 EROARE: disc plin') . "\n";
echo mesaj('INFO: pornit') . "\n";
După reparație, programul afișează
disc plin
pornit
Indiciu

Folosește offset-ul 20 doar când strlen($linie) e mai mare decât 20; altfel caută de la 0.

Alte forme ale mesajului

  • Warning: strpos(): Offset not contained in string in index.php on line 4
  • Fatal error: Uncaught ValueError: strrpos(): Argument #3 ($offset) must be contained in argument #1 ($haystack) in index.php:4
  • Fatal error: Uncaught ValueError: mb_strpos(): Argument #3 ($offset) must be contained in argument #1 ($haystack) in index.php:4
  • Fatal error: Uncaught ValueError: substr_count(): Argument #3 ($offset) must be contained in argument #1 ($haystack) in index.php:4

Cum o eviți pe viitor

  • Evită offset-urile fixe pe date care pot avea lungimi diferite; parsează cu explode, sscanf sau preg_match.
  • Când ai nevoie doar să știi dacă un text conține ceva, str_contains nu are offset deloc.
  • Pentru texte cu diacritice folosește mb_strpos și mb_strlen, ca pozițiile să fie în caractere, nu în octeți.
  • Compară rezultatul lui strpos cu !== false, nu cu != 0: poziția 0 e un rezultat valid.

Întrebări frecvente

De ce strpos($text, 'x', strlen($text)) nu dă eroare?

Poziția egală cu lungimea textului e chiar sfârșitul lui: e considerată validă și căutarea întoarce false. Doar pozițiile mai mari dau ValueError.

Cum aflu ce linie din fișier a provocat eroarea?

Pune apelul într-un try { ... } catch (ValueError $e) și afișează linia procesată în catch. Mai bine, verifică lungimea înainte, ca să nu ajungi la excepție.

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.