Fatal error: Uncaught ValueError: strpos(): Argument #3 ($offset) must be contained in argument #1 ($haystack) in index.php:4
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
<?php
$poz = strpos($linie, ':', 20);<?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ă
<?php
$poz = 0;
while (($poz = strpos($text, 'a', $poz + 2)) !== false) {
$n++;
}<?php
$n = substr_count($text, 'a');Pentru numărare, substr_count face totul fără offset-uri manuale.
3Offset negativ prea mare
<?php
$poz = strpos('abc', 'a', -5);<?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ă 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.
<?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";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.
Reparația
<?php
function mesaj(string $linie): string
{
$start = strlen($linie) > 20 ? 20 : 0;
$poz = strpos($linie, ':', $start);
return trim(substr($linie, $poz + 1));
}
echo mesaj('2026-11-01 10:15:00 EROARE: disc plin') . "\n";
echo mesaj('INFO: pornit') . "\n";De ce merge
Linia INFO: pornit are 12 caractere, deci poziția 20 e în afara textului. Din PHP 8, strpos nu mai întoarce false cu un Warning, ci aruncă ValueError.
Cu $start = 0 pentru liniile scurte, căutarea începe de la început și găsește : de după INFO. Pentru linia lungă, offset-ul 20 sare peste : din oră și găsește pe cel de după EROARE.
Alte forme ale mesajului
Warning: strpos(): Offset not contained in string in index.php on line 4Fatal error: Uncaught ValueError: strrpos(): Argument #3 ($offset) must be contained in argument #1 ($haystack) in index.php:4Fatal error: Uncaught ValueError: mb_strpos(): Argument #3 ($offset) must be contained in argument #1 ($haystack) in index.php:4Fatal 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,sscanfsaupreg_match. - Când ai nevoie doar să știi dacă un text conține ceva,
str_containsnu are offset deloc. - Pentru texte cu diacritice folosește
mb_strposșimb_strlen, ca pozițiile să fie în caractere, nu în octeți. - Compară rezultatul lui
strposcu!== 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
Warning: Uninitialized string offset 5 in index.php on line 4 Citești caracterul de la o poziție care nu există în text, de obicei cu o buclă care merge până la <= strlen($text) în loc de < strlen($text). Pozițiile încep de la 0, deci ultima este strlen($text) - 1. Fatal error: Uncaught ValueError: explode(): Argument #1 ($separator) cannot be empty in index.php:3 Ai apelat explode() cu separatorul '' (text gol), de obicei ca să împarți un cuvânt în litere. explode nu poate tăia „între” caractere. Folosește str_split($text) sau, pentru diacritice, mb_str_split($text). Deprecated: htmlspecialchars(): Passing null to parameter #1 ($string) of type string is deprecated in index.php on line 4 Dai null unei funcții PHP care așteaptă text (htmlspecialchars, trim, strlen, str_replace...). De obicei valoarea vine dintr-o cheie lipsă sau dintr-o coloană goală din baza de date. Dă o valoare implicită: htmlspecialchars($x ?? ''). Î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.
