PHP count() : obtenir la taille d'un tableau

count($arr) renvoie le nombre d'éléments d'un tableau : count(['red', 'green', 'blue']) vaut 3. Les tableaux PHP n'ont pas de propriété length, c'est donc avec count() que vous obtenez la longueur ou la taille d'un tableau.

<?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() est rapide : PHP stocke la taille dans le tableau, donc compter un million d'éléments coûte autant que d'en compter trois.

Compter un tableau multidimensionnel

Par défaut, count() ne compte que le premier niveau. Passez COUNT_RECURSIVE (ou 1) en second argument pour compter chaque élément à toutes les profondeurs. Les tableaux imbriqués eux-mêmes sont comptés aussi, c'est pourquoi le total dépasse souvent le nombre de valeurs 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";

Les deux raccourcis supposent exactement deux niveaux. Pour une imbrication plus profonde dans un tableau multidimensionnel, comptez les feuilles avec array_walk_recursive() : $n = 0; array_walk_recursive($arr, function () use (&$n) { $n++; });.

count ou sizeof

sizeof() est un alias de count() : mêmes arguments, même résultat. Utilisez count(). C'est ce qu'utilisent presque tout le code et toute la documentation PHP, et sizeof évoque une taille en octets pour qui connaît le C.

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

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

Compter les valeurs qui remplissent une condition

count() n'a pas d'argument de condition. Filtrez d'abord, puis comptez : array_filter() garde les éléments que votre callback accepte. Pour compter combien de fois chaque valeur apparaît, utilisez 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";

Compter les caractères d'une chaîne

count() sert aux tableaux. Pour une chaîne, utilisez strlen() pour les octets ou mb_strlen() pour les caractères ; ils diffèrent dès que le texte contient des accents ou du japonais. La page strlen explique la différence. Pour compter des mots, découpez d'abord.

<?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() traite les lettres non ASCII comme des séparateurs, donc naïve compte pour deux mots. Découper sur les espaces est plus prévisible pour du vrai texte.

count() sur null ou une chaîne lève une erreur

Depuis PHP 8, count() n'accepte que les tableaux et les objets qui implémentent Countable. Tout le reste lève une TypeError, là où PHP 7.2 à 7.4 renvoyaient 0 (pour null) ou 1 (pour une chaîne ou un nombre) avec un warning. La cause habituelle est une variable qui vaut parfois null, comme une clé manquante ou une fonction qui n'a rien renvoyé.

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

Donnez un tableau vide comme valeur par défaut avec ??, et le compte vaut 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";

Vérifier si un tableau est vide

Pour demander « ce tableau contient-il quelque chose », comparez avec un tableau vide ou utilisez empty(). count($arr) === 0 fonctionne aussi, mais seulement quand $arr est forcément un tableau.

<?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) ne lève jamais d'erreur, même quand $x n'est pas définie ou vaut null, ce qui en fait la vérification la plus sûre pour une valeur qui n'est peut-être pas un tableau. Ses autres règles (une chaîne vide et "0" sont aussi vides) sont sur la page empty.