PHP count(): длина массива и количество элементов

count($arr) возвращает число элементов массива: count(['red', 'green', 'blue']) равно 3. Свойства length у массивов PHP нет, поэтому длину или размер массива получают через count().

<?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() работает быстро: PHP хранит размер внутри массива, поэтому подсчёт миллиона элементов стоит столько же, сколько подсчёт трёх.

Подсчёт многомерного массива

По умолчанию count() считает только верхний уровень. Передайте вторым аргументом COUNT_RECURSIVE (или 1), чтобы посчитать все элементы на любой глубине. Сами вложенные массивы тоже считаются, поэтому итог часто больше числа конечных значений.

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

Оба приёма рассчитаны ровно на два уровня. Для более глубокой вложенности в многомерном массиве считайте конечные значения через array_walk_recursive(): $n = 0; array_walk_recursive($arr, function () use (&$n) { $n++; });.

count и sizeof

sizeof() это псевдоним count(): те же аргументы, тот же результат. Используйте count(). Его применяет почти весь PHP-код и документация, а sizeof наводит любого, кто знает C, на мысль о размере в байтах.

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

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

Подсчёт значений по условию

У count() нет аргумента с условием. Сначала отфильтруйте, потом посчитайте: array_filter() оставляет элементы, которые принимает ваш колбэк. Чтобы посчитать, сколько раз встречается каждое значение, используйте 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";

Подсчёт символов в строке

count() предназначена для массивов. Для строки используйте strlen() для байтов или mb_strlen() для символов; они расходятся, как только в тексте появляются диакритика или японские символы. Разница описана на странице про strlen. Чтобы посчитать слова, сначала разбейте строку.

<?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() считает не-ASCII буквы разделителями, поэтому naïve засчитывается как два слова. Разбиение по пробелам для реального текста предсказуемее.

count() для null или строки выбрасывает ошибку

Начиная с PHP 8 count() принимает только массивы и объекты, реализующие Countable. Всё остальное выбрасывает TypeError, тогда как PHP с 7.2 по 7.4 возвращал 0 (для null) или 1 (для строки или числа) с предупреждением. Обычная причина это переменная, которая иногда равна null, например отсутствующий ключ или функция, которая ничего не вернула.

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

Подставьте пустой массив через ??, и счёт будет 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";

Проверка, пуст ли массив

Чтобы спросить "есть ли в массиве хоть что-то", сравните с пустым массивом или используйте empty(). count($arr) === 0 тоже работает, но только когда $arr точно массив.

<?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) никогда не выбрасывает ошибку, даже если $x не определена или равна null, поэтому это более безопасная проверка для значения, которое может оказаться не массивом. Остальные её правила (пустая строка и "0" тоже пусты) на странице про empty.