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

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

Pe scurt

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

Greșit
PHP
<?php
$pagini = range(1, 10, 25); // voiai 1..25 din 10 în 10?
Corect
PHP
<?php
$pagini = range(1, 25, 10); // 1, 11, 21

Ordinea e start, sfârșit, pas.

2Pas mai mare decât un interval calculat

Greșit
PHP
<?php
$ani = range($anStart, $anFinal, 5);
Corect
PHP
<?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ă

Greșit
PHP
<?php
$numaratoare = range(1, 10, -1);
Corect
PHP
<?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ă tu

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ă).

Codul care dă eroarea
PHP
<?php
function pagini(int $totalProduse, int $pePagina): array
{
    return range(1, $totalProduse / $pePagina, $pePagina);
}

echo 'Pagini: ' . implode(', ', pagini(23, 10)) . "\n";
După reparație, programul afișează
Pagini: 1, 2, 3
Indiciu

Numărul de pagini e ceil(23 / 10); range are nevoie doar de start și sfârșit.

Alte forme ale mesajului

  • Fatal error: Uncaught ValueError: range(): Argument #3 ($step) must not exceed the specified range in index.php:3
  • Fatal error: Uncaught ValueError: range(): Argument #3 ($step) cannot be 0 in index.php:3
  • Fatal 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)), apoi range(1, $nrPagini).
  • Pentru intervale foarte mari, un generator sau o buclă for consumă mai puțină memorie decât range.

Î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

← 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.