...
Eroare PHP · Tipuri, operatori și conversii

Fatal error: Uncaught TypeError: count(): Argument #1 ($value) must be of type Countable|array, null given in index.php:5

Pe scurt

Apelezi count() pe o valoare care nu e tablou, de obicei null (o cheie lipsă, o funcție care n-a întors nimic) sau un text. Asigură-te că dai un tablou: count($x ?? []), iar pentru texte folosește strlen().

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

Ce înseamnă

count() numără elementele unui tablou sau ale unui obiect care implementează Countable. În PHP 7.2 – 7.4 un argument greșit dădea doar Warning: count(): Parameter must be an array or an object that implements Countable și întorcea 1 (sau 0 pentru null); din PHP 8 este TypeError și scriptul se oprește.

Cauze frecvente: variabila e null pentru că o cheie lipsește (count($comanda['produse'])), o funcție a întors null sau false în loc de tablou, ori încerci să afli lungimea unui text cu count() în loc de strlen() sau mb_strlen().

Ultima parte a mesajului (null given, string given, int given) îți spune ce ai trimis; de acolo urmărești de unde vine valoarea.

De ce apare: cauzele frecvente

1Cheie lipsă

Greșit
PHP
<?php
$comanda = ['id' => 5];
echo count($comanda['produse']);
Corect
PHP
<?php
$comanda = ['id' => 5];
echo count($comanda['produse'] ?? []);

Cheia lipsă dă null. Cu ?? [] numeri un tablou gol și obții 0.

2Lungimea unui text

Greșit
PHP
<?php
$parola = 'secret123';
if (count($parola) < 8) {
    echo 'Prea scurtă';
}
Corect
PHP
<?php
$parola = 'secret123';
if (mb_strlen($parola) < 8) {
    echo 'Prea scurtă';
}

Pentru texte se folosește strlen (octeți) sau mb_strlen (caractere, corect și pentru diacritice).

3Funcție care întoarce null

Greșit
PHP
<?php
function cauta($t) { if ($t !== '') return ['a']; }
echo count(cauta(''));
Corect
PHP
<?php
function cauta(string $t): array {
    return $t !== '' ? ['a'] : [];
}
echo count(cauta(''));

O funcție care întoarce liste ar trebui să întoarcă [] când nu are rezultate, nu null.

Repară tu

Repară eroarea, direct în pagină

Programul afișează câte produse are fiecare client în coș. Clientul Dan nu are încă un coș (cheia lipsește), iar scriptul se oprește cu TypeError: count(): Argument #1 ($value) must be of type Countable|array, null given. Repară numărarea, ca programul să afișeze Ana: 3 produse, Dan: 0 produse și Ioana: 1 produse.

Codul care dă eroarea
PHP
<?php
$cosuri = [
    'Ana' => ['caiet', 'pix', 'rucsac'],
    'Ioana' => ['penar'],
];

foreach (['Ana', 'Dan', 'Ioana'] as $client) {
    $cos = $cosuri[$client] ?? null;
    echo "$client: " . count($cos) . " produse\n";
}
După reparație, programul afișează
Ana: 3 produse
Dan: 0 produse
Ioana: 1 produse
Indiciu

Dă lui count un tablou gol când clientul nu are coș.

Alte forme ale mesajului

  • Fatal error: Uncaught TypeError: count(): Argument #1 ($value) must be of type Countable|array, string given in index.php:5
  • Fatal error: Uncaught TypeError: count(): Argument #1 ($value) must be of type Countable|array, bool given in index.php:5
  • Warning: count(): Parameter must be an array or an object that implements Countable in index.php on line 5
  • Fatal error: Uncaught TypeError: sizeof(): Argument #1 ($value) must be of type Countable|array, null given in index.php:5

Cum o eviți pe viitor

  • Inițializează listele cu [], nu cu null.
  • Funcțiile care întorc liste să aibă tipul : array și să întoarcă [] când nu găsesc nimic.
  • Pentru date care pot lipsi, folosește count($x ?? []) sau verifică întâi cu is_array($x).
  • Pentru texte, mb_strlen(); pentru obiecte proprii numărabile, implementează Countable.

Întrebări frecvente

De ce codul vechi mergea și acum nu?

Până la PHP 7.2 count(null) întorcea 0 fără niciun mesaj. PHP 7.2 a adăugat un avertisment, iar PHP 8 l-a transformat în TypeError. Codul care se baza pe asta trebuie actualizat cu ?? [].

Pot număra elementele unui obiect?

Doar dacă clasa implementează interfața Countable (metoda count(): int). Altfel primești must be of type Countable|array, Produs given.

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.