...
Eroare PHP · Variabile, constante și tablouri

Fatal error: Uncaught ValueError: array_rand(): Argument #1 ($array) cannot be empty in index.php:4

Pe scurt

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

Greșit
PHP
<?php
$inStoc = array_filter($produse, fn($p) => $p['stoc'] > 0);
$cheie = array_rand($inStoc);
Corect
PHP
<?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ă

Greșit
PHP
<?php
$castigatori = array_rand($participanti, 3);
Corect
PHP
<?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

Greșit
PHP
<?php
$culori = ['roșu', 'verde'];
echo array_rand($culori);
Corect
PHP
<?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ă tu

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.

Codul care dă eroarea
PHP
<?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";
După reparație, programul afișează
Recomandăm: Cană
Niciun produs disponibil
Indiciu

Verifică dacă $inStoc e gol înainte să apelezi array_rand.

Alte forme ale mesajului

  • Fatal error: Uncaught ValueError: array_rand(): Argument #1 ($array) must not be empty in index.php:4
  • Fatal error: Uncaught ValueError: array_rand(): Argument #2 ($num) must be between 1 and the number of elements in argument #1 ($array) in index.php:4
  • Warning: array_rand(): Array is empty in index.php on line 4

Cum o eviți pe viitor

  • Înainte de array_rand, random_int, max, min sau reset, î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, shuffle pe o copie plus array_slice e 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

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