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

Fatal error: Uncaught ValueError: random_int(): Argument #1 ($min) must be less than or equal to argument #2 ($max) in index.php:4

Pe scurt

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

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

Ce înseamnă

random_int($min, $max) întoarce un număr întreg aleator, sigur criptografic, cu $min și $max incluse. Intervalul trebuie să fie valid: $min <= $max. Altfel, PHP aruncă ValueError cu acest mesaj (în PHP 7 era Error: Minimum value must be less than or equal to the maximum value).

Cauze frecvente: argumente inversate (random_int(999999, 100000)), o limită calculată care uneori iese negativă (indexul ultimului element dintr-un tablou gol: count([]) - 1 = -1) sau capete citite din configurare în ordine greșită.

random_int(5, 5) e valid și întoarce mereu 5. Doar intervalul inversat e interzis. La mt_rand($min, $max) mesajul e asemănător: mt_rand(): Argument #2 ($max) must be greater than or equal to argument #1 ($min).

De ce apare: cauzele frecvente

1Argumente inversate

Greșit
PHP
<?php
$cod = random_int(999999, 100000);
Corect
PHP
<?php
$cod = random_int(100000, 999999);

Întâi limita de jos, apoi cea de sus.

2Index aleator dintr-o listă goală

Greșit
PHP
<?php
$i = random_int(0, count($intrebari) - 1);
Corect
PHP
<?php
if ($intrebari === []) {
    throw new RuntimeException('Nu există întrebări');
}
$i = random_int(0, count($intrebari) - 1);

Pe o listă goală, maximul devine -1, mai mic decât 0.

3Limite din configurare

Greșit
PHP
<?php
$asteptare = random_int($config['max_ms'], $config['min_ms']);
Corect
PHP
<?php
[$a, $b] = [$config['min_ms'], $config['max_ms']];
$asteptare = random_int(min($a, $b), max($a, $b));

Când nu controlezi ordinea valorilor, min/max garantează un interval valid.

Repară tu

Repară eroarea, direct în pagină

Funcția codConfirmare generează un cod de confirmare de 6 cifre, dar programul se oprește cu ValueError: random_int(): Argument #1 ($min) must be less than or equal to argument #2 ($max). Repară apelul, ca programul să afișeze Cod generat: 6 cifre.

Codul care dă eroarea
PHP
<?php
function codConfirmare(): string
{
    return (string) random_int(999999, 100000);
}

$cod = codConfirmare();
echo 'Cod generat: ' . strlen($cod) . " cifre\n";
După reparație, programul afișează
Cod generat: 6 cifre
Indiciu

Ordinea argumentelor e întâi minimul, apoi maximul.

Alte forme ale mesajului

  • Fatal error: Uncaught Error: Minimum value must be less than or equal to the maximum value in index.php:4
  • Fatal error: Uncaught ValueError: mt_rand(): Argument #2 ($max) must be greater than or equal to argument #1 ($min) in index.php:4
  • Fatal error: Uncaught ValueError: Random\Randomizer::getInt(): Argument #2 ($max) must be greater than or equal to argument #1 ($min) in index.php:5

Cum o eviți pe viitor

  • Scrie mereu random_int($min, $max) cu variabile cu nume clare, nu cu numere fără context.
  • Când maximul vine din count(...) - 1, tratează întâi lista goală.
  • Pentru un element aleator dintr-un tablou, $lista[array_rand($lista)] e mai simplu decât un index calculat.
  • Pentru teste deterministe, folosește Random\Randomizer cu un generator inițializat cu o sămânță (new Random\Engine\Mt19937(42)).

Întrebări frecvente

random_int sau rand?

random_int e sigur criptografic, potrivit pentru coduri, tokenuri, parole temporare. rand/mt_rand sunt mai rapide, dar previzibile; folosește-le doar unde nu contează securitatea.

Maximul e inclus?

Da, ambele capete sunt incluse: random_int(1, 6) poate da 1, 2, 3, 4, 5 sau 6.

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.