PHP count(): die Länge eines Arrays ermitteln

count($arr) liefert die Anzahl der Elemente eines Arrays: count(['red', 'green', 'blue']) ist 3. PHP-Arrays haben keine Eigenschaft length, also bekommst du die Länge oder Größe eines Arrays mit 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() ist schnell: PHP speichert die Größe im Array selbst, also kostet das Zählen von einer Million Elementen genauso viel wie das Zählen von dreien.

Ein mehrdimensionales Array zählen

Standardmäßig zählt count() nur die oberste Ebene. Übergib COUNT_RECURSIVE (oder 1) als zweites Argument, um jedes Element auf jeder Ebene zu zählen. Die verschachtelten Arrays selbst werden mitgezählt, deshalb ist die Summe oft größer als die Zahl der Blattwerte.

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

Beide Abkürzungen setzen genau zwei Ebenen voraus. Bei tieferer Verschachtelung in einem mehrdimensionalen Array zählst du die Blätter mit array_walk_recursive(): $n = 0; array_walk_recursive($arr, function () use (&$n) { $n++; });.

count vs sizeof

sizeof() ist ein Alias von count(): gleiche Argumente, gleiches Ergebnis. Verwende count(). Das verwenden fast alle PHP-Codebasen und Dokumentationen, und sizeof lässt jeden, der C kennt, an eine Größe in Bytes denken.

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

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

Werte zählen, die eine Bedingung erfüllen

count() hat kein Argument für eine Bedingung. Filtere zuerst und zähle dann: array_filter() behält die Elemente, die dein Callback akzeptiert. Um zu zählen, wie oft jeder Wert vorkommt, verwendest du 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";

Zeichen in einem String zählen

count() ist für Arrays. Für einen String verwendest du strlen() für Bytes oder mb_strlen() für Zeichen; sie unterscheiden sich, sobald der Text Umlaute, Akzente oder Japanisch enthält. Die Seite zu strlen behandelt den Unterschied. Um Wörter zu zählen, teilst du den String zuerst auf.

<?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() behandelt Nicht-ASCII-Buchstaben als Trennzeichen, also zählt naïve als zwei Wörter. An Leerzeichen zu teilen ist bei echtem Text vorhersehbarer.

count() auf null oder einen String wirft einen Fehler

Seit PHP 8 akzeptiert count() nur Arrays und Objekte, die Countable implementieren. Alles andere wirft einen TypeError, wo PHP 7.2 bis 7.4 mit einer Warnung 0 (bei null) oder 1 (bei einem String oder einer Zahl) zurückgab. Die übliche Ursache ist eine Variable, die manchmal null ist, etwa ein fehlender Schlüssel oder eine Funktion, die nichts zurückgegeben hat.

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

Setze mit ?? ein leeres Array als Standardwert, dann ist die Anzahl 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";

Prüfen, ob ein Array leer ist

Um zu fragen, „ob dieses Array überhaupt etwas enthält“, vergleichst du mit einem leeren Array oder verwendest empty(). count($arr) === 0 funktioniert auch, aber nur, wenn $arr sicher ein Array ist.

<?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) wirft nie einen Fehler, selbst wenn $x undefiniert oder null ist, und ist damit die sicherere Prüfung für einen Wert, der vielleicht kein Array ist. Seine anderen Regeln (ein leerer String und "0" sind ebenfalls leer) stehen auf der Seite zu empty.