Fatal error: Uncaught ValueError: array_rand(): Argument #1 ($array) cannot be empty in index.php:4
Ai cerut un element aleator dintr-un tablou gol. array_rand() nu are ce alege, așa că aruncă ValueError. Verifică înainte dacă tabloul are elemente (if ($lista !== [])) și tratează separat cazul gol.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
array_rand($tablou) întoarce o cheie aleatoare din tablou (sau mai multe, dacă dai al doilea argument). Pe un tablou gol nu există nicio cheie, iar din PHP 8.0 funcția aruncă ValueError în loc să întoarcă null cu un Warning, ca în PHP 7.
Mesajul spune exact ce argument e problema (Argument #1 ($array)). Tabloul e gol de obicei pentru că vine dintr-un filtru (array_filter care n-a păstrat nimic), dintr-o interogare fără rezultate sau dintr-un fișier gol. Linia din mesaj e apelul lui array_rand; ca să afli de ce e gol, urmărește de unde vine tabloul.
O variantă înrudită: array_rand($lista, 5) pe un tablou cu mai puțin de 5 elemente dă Argument #2 ($num) must be between 1 and the number of elements in argument #1 ($array).
De ce apare: cauzele frecvente
1Tablou golit de un filtru
<?php
$inStoc = array_filter($produse, fn($p) => $p['stoc'] > 0);
$cheie = array_rand($inStoc);<?php
$inStoc = array_filter($produse, fn($p) => $p['stoc'] > 0);
$cheie = $inStoc === [] ? null : array_rand($inStoc);Cazul gol se tratează explicit, înainte de apel.
2Mai multe elemente cerute decât există
<?php
$castigatori = array_rand($participanti, 3);<?php
$n = min(3, count($participanti));
$castigatori = $n > 0 ? (array) array_rand($participanti, $n) : [];Ceri cel mult câte elemente are tabloul. Cu $n = 1, array_rand întoarce o cheie, nu un tablou, de aceea (array).
3Ai vrut valoarea, nu cheia
<?php
$culori = ['roșu', 'verde'];
echo array_rand($culori);<?php
$culori = ['roșu', 'verde'];
echo $culori[array_rand($culori)];Nu e cauza erorii, dar e greșeala care vine des la pachet: array_rand întoarce cheia, iar valoarea o iei din tablou.
Repară eroarea, direct în pagină
Funcția recomandare alege un produs aleator dintre cele aflate în stoc. Când niciun produs nu e în stoc, programul se oprește cu ValueError: array_rand(): Argument #1 ($array) cannot be empty. Tratează cazul gol, ca funcția să întoarcă Niciun produs disponibil; programul trebuie să afișeze Recomandăm: Cană și apoi Niciun produs disponibil.
<?php
function recomandare(array $stocuri): string
{
$inStoc = array_filter($stocuri, fn($buc) => $buc > 0);
$nume = array_rand($inStoc);
return "Recomandăm: $nume";
}
echo recomandare(['Pix' => 0, 'Cană' => 4]) . "\n";
echo recomandare(['Pix' => 0, 'Cană' => 0]) . "\n";Recomandăm: Cană Niciun produs disponibil
Indiciu
Verifică dacă $inStoc e gol înainte să apelezi array_rand.
Reparația
<?php
function recomandare(array $stocuri): string
{
$inStoc = array_filter($stocuri, fn($buc) => $buc > 0);
if ($inStoc === []) {
return 'Niciun produs disponibil';
}
$nume = array_rand($inStoc);
return "Recomandăm: $nume";
}
echo recomandare(['Pix' => 0, 'Cană' => 4]) . "\n";
echo recomandare(['Pix' => 0, 'Cană' => 0]) . "\n";De ce merge
La al doilea apel, array_filter nu păstrează niciun produs, deci $inStoc e gol. array_rand nu poate alege o cheie dintr-un tablou gol și, din PHP 8, aruncă ValueError.
Verificarea $inStoc === [] tratează cazul înainte de apel. La primul apel rămâne doar cana, deci alegerea „aleatoare” e mereu aceeași și rezultatul e previzibil.
Alte forme ale mesajului
Fatal error: Uncaught ValueError: array_rand(): Argument #1 ($array) must not be empty in index.php:4Fatal error: Uncaught ValueError: array_rand(): Argument #2 ($num) must be between 1 and the number of elements in argument #1 ($array) in index.php:4Warning: array_rand(): Array is empty in index.php on line 4
Cum o eviți pe viitor
- Înainte de
array_rand,random_int,max,minsaureset, întreabă-te: ce fac dacă lista e goală? - Tratează cazul gol aproape de sursa datelor (după filtru sau interogare) și afișează un mesaj clar.
- Pentru amestecare sau tragere fără repetiție,
shufflepe o copie plusarray_slicee adesea mai simplu. - În teste, include întotdeauna și cazul cu tablou gol.
Întrebări frecvente
E sigur array_rand pentru coduri sau parole?
Nu. array_rand folosește generatorul obișnuit, nepotrivit pentru securitate. Pentru tokenuri și coduri folosește random_int sau random_bytes, ori clasa Random\Randomizer (PHP 8.2+).
De ce nu întoarce pur și simplu null?
Așa era în PHP 7, cu un Warning pe care mulți îl ignorau, iar null mergea mai departe ca o cheie validă. Din PHP 8, apelurile cu argumente invalide aruncă ValueError, ca greșeala să fie oprită pe loc.
Erori înrudite
Fatal error: Uncaught ValueError: max(): Argument #1 ($value) must contain at least one element in index.php:4 Ai apelat max() sau min() pe un tablou gol, de exemplu după un filtru care n-a găsit nimic. Din PHP 8 asta aruncă ValueError. Verifică înainte dacă tabloul are elemente și tratează separat cazul gol. 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). Warning: Undefined array key 3 in index.php on line 5 Ceri elementul cu indexul 3, dar tabloul are mai puține elemente (sau indexurile nu sunt consecutive). Indexurile pornesc de la 0, deci ultimul element e la count($tablou) - 1. Corectează limita buclei. Î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.
