PHP count(): obtener la longitud de un array

count($arr) devuelve el número de elementos de un array: count(['red', 'green', 'blue']) es 3. Los arrays de PHP no tienen una propiedad length, así que count() es la forma de obtener la longitud o el tamaño de un 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

count() es rápido: PHP guarda el tamaño dentro del array, así que contar un millón de elementos cuesta lo mismo que contar tres.

Contar un array multidimensional

Por defecto, count() cuenta solo el nivel superior. Pasa COUNT_RECURSIVE (o 1) como segundo argumento para contar todos los elementos de todos los niveles. Los propios arrays anidados también se cuentan, y por eso el total suele ser mayor que el número de valores finales.

<?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";

Los dos atajos suponen exactamente dos niveles. Para un anidamiento más profundo en un array multidimensional, cuenta las hojas con array_walk_recursive(): $n = 0; array_walk_recursive($arr, function () use (&$n) { $n++; });.

count vs sizeof

sizeof() es un alias de count(): mismos argumentos, mismo resultado. Usa count(). Es lo que usan casi todo el código y la documentación de PHP, y sizeof sugiere un tamaño en bytes a cualquiera que conozca 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 los valores que cumplen una condición

count() no tiene un argumento de condición. Filtra primero y luego cuenta: array_filter() conserva los elementos que acepta tu callback. Para contar cuántas veces aparece cada valor, usa 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 de una cadena

count() es para arrays. Para una cadena, usa strlen() para los bytes o mb_strlen() para los caracteres; dan resultados distintos en cuanto el texto tiene tildes o japonés. La página de strlen explica la diferencia. Para contar palabras, divide primero.

<?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 las letras no ASCII como separadores, así que naïve cuenta como dos palabras. Dividir por los espacios es más predecible con texto real.

count() con null o con una cadena lanza un error

Desde PHP 8, count() solo acepta arrays y objetos que implementan Countable. Cualquier otra cosa lanza un TypeError, cuando PHP 7.2 a 7.4 devolvían 0 (para null) o 1 (para una cadena o un número) con un warning. La causa habitual es una variable que a veces es null, como una clave que falta o una función que no devolvió nada.

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

Usa un array vacío por defecto con ??, y el total es 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";

Comprobar si un array está vacío

Para preguntar "¿este array tiene algo?", compáralo con un array vacío o usa empty(). count($arr) === 0 también funciona, pero solo cuando $arr es seguro que es un 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 lanza un error, aunque $x no esté definida o sea null, lo que la convierte en la comprobación más segura para un valor que puede no ser un array. Sus otras reglas (una cadena vacía y "0" también están vacías) están en la página de empty.