International PHP Conference Berlin 2025

    count

    (PHP 4, PHP 5, PHP 7, PHP 8)

    count — Zählt alle Elemente eines Arrays oder eines Countable-Objekts

    Beschreibung

    count(Countable|array $value, int $mode = COUNT_NORMAL): int

    Zählt alle Elemente eines Arrays, wenn es mit einem Array verwendet wird. Bei Verwendung mit einem Objekt, das die Schnittstelle Countable nutzt, gibt es den Rückgabewert der Methode Countable::count() zurück.

    Parameter-Liste

    value

    Ein Array oder ein Countable-Objekt.

    mode

    Wenn der optionale Parameter mode auf COUNT_RECURSIVE (oder 1) gesetzt ist, wird count() rekursiv durch das Array zählen. Dies kann besonders nützlich sein, um alle Elemente eines mehrdimensionalen Arrays zu zählen.

    Achtung

    count() kann Rekursion erkennen, um eine Endlosschleife zu vermeiden, erzeugt aber jedes Mal, wenn es das tut, ein E_WARNING (für den Fall, dass das Array sich selbst mehr als einmal enthält) und gibt eine höhere Anzahl zurück, als erwartet werden kann.

    Rückgabewerte

    Gibt die Anzahl von Elementen in value zurück. Vor PHP 8.0.0 wurde 1 zurückgegeben, wenn der Parameter weder ein Array noch ein Objekt mit implementierter Countable-Schnittstelle war, es sei denn, value war null, dann wurde 0 zurückgegeben.

    Changelog

    Version Beschreibung
    8.0.0 count() löst nun einen TypeError aus, wenn ungültige zählbare Typen an den Parameter value übergeben werden.
    7.2.0 count() erzeugt nun eine Warnung für ungültige zählbare Typen, die an den Parameter value übergeben wurden.

    Beispiele

    Beispiel #1 count()-Beispiel

    <?php
    $a    [0] = 1;
    $a[1] = 3;
    $a[2] = 5;
    var_dump(count($a));

    $b[0] = 7;
    $b[5] = 9;
    $b[10] = 11;
    var_dump(count($b));
    ?>

    Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

    int(3)
int(3)

    Beispiel #2 count()-Beispiel für ein nicht zählbares Array (schlechtes Beispiel - nicht verwenden)

    <?php
    $b    [0] = 7;
    $b[5] = 9;
    $b[10] = 11;
    var_dump(count($b));

    var_dump(count(null));

    var_dump(count(false));
    ?>

    Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

    int(3)
int(0)
int(1)

    Das oben gezeigte Beispiel erzeugt mit PHP 7.2 folgende Ausgabe:

    int(3)

Warning: count(): Parameter must be an array or an object that implements Countable in … on line 12
int(0)

Warning: count(): Parameter must be an array or an object that implements Countable in … on line 14
int(1)

    Das oben gezeigte Beispiel erzeugt mit PHP 8 folgende Ausgabe:

    int(3)

Fatal error: Uncaught TypeError: count(): Argument #1 ($var) must be of type Countable .. on line 12

    Beispiel #3 Rekursives count()-Beispiel

    <?php
    $food     = array('Obst' => array('Orange', 'Banane', 'Apfel'),
    'Gemüse' => array('Karotte', 'Kohl', 'Erbse'));

    // rekursiv zählen
    var_dump(count($food, COUNT_RECURSIVE));

    // normales zählen
    var_dump(count($food));

    ?>

    Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

    int(8)
int(2)

    Beispiel #4 Countable-Objekt

    <?php
    class CountOfMethods implements Countable
    {
    private function     someMethod()
    {
    }

    public function     count(): int
    {
    return     count(get_class_methods($this));
    }
    }

    $obj = new CountOfMethods();
    var_dump(count($obj));
    ?>

    Das oben gezeigte Beispiel erzeugt folgende Ausgabe:

    int(2)

    Siehe auch

    • is_array() - Prüft, ob die Variable ein Array ist
    • isset() - Prüft, ob eine Variable deklariert ist und sich von null unterscheidet
    • empty() - Prüft, ob eine Variable leer ist
    • strlen() - Ermitteln der String-Länge
    • is_countable() - Verify that the contents of a variable is a countable value
    • Arrays

    Found A Problem?

    Learn How To Improve This Page • Submit a Pull Request • Report a Bug
    ＋add a note

    User Contributed Notes 6 notes

    up
    143
    onlyranga at gmail dot com
    10 years ago
    [Editor's note: array at from dot pl had pointed out that count() is a cheap operation; however, there's still the function call overhead.]

    If you want to run through large arrays don't use count() function in the loops , its a over head in performance, copy the count() value into a variable and use that value in loops for a better performance.

    Eg:

    // Bad approach

    for($i=0;$i<count($some_arr);$i++)
    {
    // calculations
    }

    // Good approach

    $arr_length = count($some_arr);
    for($i=0;$i<$arr_length;$i++)
    {
    // calculations
    }
    up
    3
    lucasfsmartins at gmail dot com
    5 years ago
    If you are on PHP 7.2+, you need to be aware of "Changelog" and use something like this:

    <?php
    $countFruits     = is_array($countFruits) || $countFruits instanceof Countable ? count($countFruits) : 0;
    ?>

    You can organize your code to ensure that the variable is an array, or you can extend the Countable so that you don't have to do this check.
    up
    13
    danny at dannymendel dot com
    17 years ago
    I actually find the following function more useful when it comes to multidimension arrays when you do not want all levels of the array tree.

    // $limit is set to the number of recursions
    <?php
    function count_recursive ($array, $limit) {
    $count = 0;
    foreach (    $array as $id => $_array) {
    if (    is_array ($_array) && $limit > 0) {
    $count += count_recursive ($_array, $limit - 1);
    } else {
    $count += 1;
    }
    }
    return     $count;
    }
    ?>
    up
    2
    Anonymous
    5 years ago
    For a Non Countable Objects

    $count = count($data);
    print "Count: $count\n";

    Warning: count(): Parameter must be an array or an object that implements Countable in example.php on line 159

    #Quick fix is to just cast the non-countable object as an array..

    $count = count((array) $data);
    print "Count: $count\n";

    Count: 250
    up
    3
    pied-pierre
    9 years ago
    A function of one line to find the number of elements that are not arrays, recursively :

    function count_elt($array, &$count=0){
    foreach($array as $v) if(is_array($v)) count_elt($v,$count); else ++$count;
    return $count;
    }
    up
    8
    alexandr at vladykin dot pp dot ru
    18 years ago
    My function returns the number of elements in array for multidimensional arrays subject to depth of array. (Almost COUNT_RECURSIVE, but you can point on which depth you want to plunge).

    <?php
    function getArrCount ($arr, $depth=1) {
    if (!    is_array($arr) || !$depth) return 0;

    $res=count($arr);

    foreach (    $arr as $in_ar)
    $res+=getArrCount($in_ar, $depth-1);

    return     $res;
    }
    ?>
    ＋add a note
    To Top