Fatal error: Uncaught ValueError: range(): Argument #3 ($step) must be less than the range spanned by argument #1 ($start) and argument #2 ($end) in index.php:3
Pasul dat lui range() e mai mare decât distanța dintre start și sfârșit, de ex. range(1, 5, 10). PHP nu poate genera nici măcar două valori. Verifică ordinea argumentelor (range($start, $end, $pas)) și, dacă intervalul poate fi mic, tratează cazul separat.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
range($start, $end, $step) generează valorile de la $start la $end, din $step în $step. Din PHP 8.3, funcția verifică strict argumentele: dacă pasul e mai mare decât distanța dintre capete (range(1, 5, 10)), aruncă ValueError cu acest mesaj. Versiunile mai vechi spuneau must not exceed the specified range.
Alte mesaje înrudite, din aceeași verificare: Argument #3 ($step) cannot be 0 și Argument #3 ($step) must be greater than 0 for increasing ranges (pas negativ pentru un interval crescător).
Cauze frecvente: ai inversat argumentele (pasul a ajuns pe locul lui $end), ai pus ca pas o valoare calculată (numărul de produse pe pagină) care e mai mare decât intervalul, sau intervalul vine din date și uneori e foarte mic.
De ce apare: cauzele frecvente
1Argumente inversate
<?php
$pagini = range(1, 10, 25); // voiai 1..25 din 10 în 10?<?php
$pagini = range(1, 25, 10); // 1, 11, 21Ordinea e start, sfârșit, pas.
2Pas mai mare decât un interval calculat
<?php
$ani = range($anStart, $anFinal, 5);<?php
$ani = $anFinal - $anStart >= 5 ? range($anStart, $anFinal, 5) : [$anStart, $anFinal];Când intervalul poate fi mai mic decât pasul, tratezi cazul separat.
3Pas negativ pentru numărătoare inversă
<?php
$numaratoare = range(1, 10, -1);<?php
$numaratoare = range(10, 1);Pentru valori descrescătoare pui capetele invers; pasul rămâne pozitiv. Mesajul aici e must be greater than 0 for increasing ranges.
Repară eroarea, direct în pagină
Funcția pagini trebuie să întoarcă numerele paginilor pentru o listă de produse, dar programul se oprește cu ValueError: range(): Argument #3 ($step) must be less than the range spanned.... Calculează întâi câte pagini sunt și apoi generează-le, ca programul să afișeze Pagini: 1, 2, 3 (23 de produse, câte 10 pe pagină).
<?php
function pagini(int $totalProduse, int $pePagina): array
{
return range(1, $totalProduse / $pePagina, $pePagina);
}
echo 'Pagini: ' . implode(', ', pagini(23, 10)) . "\n";Pagini: 1, 2, 3
Indiciu
Numărul de pagini e ceil(23 / 10); range are nevoie doar de start și sfârșit.
Reparația
<?php
function pagini(int $totalProduse, int $pePagina): array
{
$nrPagini = (int) ceil($totalProduse / $pePagina);
return range(1, $nrPagini);
}
echo 'Pagini: ' . implode(', ', pagini(23, 10)) . "\n";De ce merge
Apelul era range(1, 2.3, 10): de la 1 la 2.3, din 10 în 10. Pasul de 10 e mai mare decât distanța de 1.3 dintre capete, iar PHP 8.3+ consideră asta un apel greșit și aruncă ValueError.
Pasul nu avea ce căuta acolo. Calculezi numărul de pagini cu ceil(23 / 10) = 3 și generezi range(1, 3), adică 1, 2, 3.
Alte forme ale mesajului
Fatal error: Uncaught ValueError: range(): Argument #3 ($step) must not exceed the specified range in index.php:3Fatal error: Uncaught ValueError: range(): Argument #3 ($step) cannot be 0 in index.php:3Fatal error: Uncaught ValueError: range(): Argument #3 ($step) must be greater than 0 for increasing ranges in index.php:3
Cum o eviți pe viitor
- Citește apelul cu voce tare: „de la start, până la sfârșit, din pas în pas”.
- Când capetele vin din date, pune o gardă: dacă intervalul e mai mic decât pasul, întoarce doar capetele.
- Pentru numerotarea paginilor, calculează întâi numărul de pagini (
ceil($total / $pePagina)), apoirange(1, $nrPagini). - Pentru intervale foarte mari, un generator sau o buclă
forconsumă mai puțină memorie decâtrange.
Întrebări frecvente
De ce codul mergea pe PHP 8.2?
Până la 8.3, unele combinații ciudate erau acceptate în tăcere sau dădeau doar Warning. PHP 8.3 a făcut verificările stricte și consecvente, deci codul cu argumente greșite aruncă acum ValueError.
range(1, 5, 10) n-ar putea întoarce doar [1]?
Logic ar putea, dar PHP a ales să considere asta o greșeală de apel, pentru că aproape mereu indică argumente inversate. Dacă vrei comportamentul acela, tratează explicit cazul.
Erori înrudite
Fatal error: Uncaught ValueError: array_chunk(): Argument #2 ($length) must be greater than 0 in index.php:5 Ai cerut lui array_chunk() să împartă tabloul în bucăți de 0 elemente (sau mai puțin), de obicei pentru că numărul de elemente pe pagină vine din URL sau din setări și e 0, gol sau negativ. Validează valoarea și folosește un minim: max(1, (int) $pePagina). Fatal error: Uncaught ValueError: str_repeat(): Argument #2 ($times) must be greater than or equal to 0 in index.php:4 Numărul de repetări dat lui str_repeat() a ieșit negativ, de obicei la alinierea unui text: str_repeat(' ', 20 - strlen($nume)) cu un nume mai lung de 20 de caractere. Limitează-l cu max(0, ...) sau folosește str_pad(), care nu dă eroare. Fatal error: Uncaught ValueError: random_int(): Argument #1 ($min) must be less than or equal to argument #2 ($max) in index.php:4 Ai dat lui random_int() minimul mai mare decât maximul, de obicei pentru că ai inversat argumentele sau pentru că limita de sus vine dintr-un calcul care poate ieși mai mică (count($lista) - 1 pe o listă goală). Ordinea e random_int($min, $max). Î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.
