PHP count(): tamanho de um array

count($arr) retorna o número de elementos de um array: count(['red', 'green', 'blue']) é 3. Arrays PHP não têm a propriedade length, então count() é como você obtém o tamanho de um array.

<?php
$fruits = ['apple', 'banana', 'cherry'];
echo count($fruits), "\n";

$fruits[] = 'date';
echo count($fruits), "\n";

echo count([]), "\n";                          // empty array
echo count(['a' => 1, 'b' => 2]), "\n";        // keys of any kind

O count() é rápido: o PHP guarda o tamanho dentro do array, então contar um milhão de elementos custa o mesmo que contar três.

Contar um array multidimensional

Por padrão, count() conta só o nível superior. Passe COUNT_RECURSIVE (ou 1) como segundo argumento para contar todos os elementos em todas as profundidades. Os próprios arrays aninhados também são contados, e é por isso que o total costuma ser maior que o número de valores nas folhas.

<?php
$teams = [
    'red'  => ['Ada', 'Linus'],
    'blue' => ['Grace', 'Margaret', 'Alan'],
];

echo count($teams), "\n";                    // 2 teams
echo count($teams, COUNT_RECURSIVE), "\n";   // 2 teams + 5 names

// Only the leaf values
echo count($teams, COUNT_RECURSIVE) - count($teams), "\n";
echo array_sum(array_map('count', $teams)), "\n";

Os dois atalhos supõem exatamente dois níveis. Para aninhamentos mais profundos num array multidimensional, conte as folhas com array_walk_recursive(): $n = 0; array_walk_recursive($arr, function () use (&$n) { $n++; });.

count ou sizeof

sizeof() é um alias de count(): mesmos argumentos, mesmo resultado. Use count(). É o que quase todo código e documentação PHP usa, e sizeof sugere um tamanho em bytes para quem conhece C.

<?php
$items = [1, 2, 3, 4];

echo count($items), "\n";
echo sizeof($items), "\n";
echo sizeof($items) === count($items) ? "same\n" : "different\n";

Contar valores que atendem a uma condição

count() não tem argumento de condição. Filtre primeiro e depois conte: array_filter() mantém os elementos que o seu callback aceita. Para contar quantas vezes cada valor aparece, use array_count_values().

<?php
$scores = [45, 82, 67, 91, 38, 74];

$passed = count(array_filter($scores, fn($s) => $s >= 50));
echo "$passed of ", count($scores), " passed\n";

$answers = ['yes', 'no', 'yes', 'maybe', 'yes'];
$tally = array_count_values($answers);
print_r($tally);
echo $tally['yes'], "\n";

Contar caracteres numa string

count() é para arrays. Para uma string, use strlen() para bytes ou mb_strlen() para caracteres; eles diferem assim que o texto tem acentos ou japonês. A página sobre strlen explica a diferença. Para contar palavras, divida a string antes.

<?php
$text = 'naïve café au lait';

echo strlen($text), "\n";             // bytes: ï and é take two each
echo mb_strlen($text), "\n";          // characters
echo str_word_count($text), "\n";     // words (ASCII letters only)
echo count(explode(' ', $text)), "\n"; // pieces split on spaces

str_word_count() trata letras fora do ASCII como separadores, então naïve conta como duas palavras. Dividir pelos espaços é mais previsível para texto real.

count() em null ou numa string lança erro

Desde o PHP 8, count() só aceita arrays e objetos que implementam Countable. Qualquer outra coisa lança um TypeError, enquanto do PHP 7.2 ao 7.4 ele retornava 0 (para null) ou 1 (para uma string ou um número) com um aviso. A causa comum é uma variável que às vezes é null, como uma chave ausente ou uma função que não retornou nada.

<?php
// This throws a TypeError on purpose
$tags = null;
echo count($tags);

Use um array vazio como padrão com ??, e a contagem fica 0:

<?php
$post = ['title' => 'Hello'];        // no 'tags' key

echo count($post['tags'] ?? []), "\n";

$tags = null;
echo count($tags ?? []), "\n";

echo is_countable($tags) ? count($tags) : 0, "\n";

Verificar se um array está vazio

Para perguntar "este array tem alguma coisa", compare com um array vazio ou use empty(). count($arr) === 0 também funciona, mas só quando $arr é com certeza um array.

<?php
$cart = [];

if ($cart === []) {
    echo "Your cart is empty\n";
}

var_dump(empty($cart));
var_dump(count($cart) > 0);

$cart[] = 'book';
var_dump(empty($cart));

empty($x) nunca lança erro, mesmo quando $x está indefinido ou é null, o que o torna a verificação mais segura para um valor que pode não ser um array. As outras regras dele (uma string vazia e "0" também são vazias) estão na página sobre empty.