Category: Tutorials

The count() function in PHP is a powerful tool for working with arrays and countable objects. This tutorial will walk you through its usage, provide examples, and explain when and how to use its features effectively.

What Is the count() Function?

The count() function counts all elements in an array or an object that implements the Countable interface. This makes it invaluable for determining the size of data structures during runtime.

Syntax

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

Parameters

• value: The array or Countable object whose elements you want to count.
• mode (optional): Specifies how to count elements. The default is COUNT_NORMAL, which counts elements at the first level only. If set to COUNT_RECURSIVE, it counts all elements in multidimensional arrays.

Return Value

• Returns the number of elements in the array or countable object.
• Throws a TypeError in PHP 8+ if the value is not a valid countable type.

---

Basic Usage

Counting Elements in an Array

<?php
$fruits = ["apple", "banana", "cherry"];

// Count the number of elements in the array
echo count($fruits); // Output: 3
?>

---

Using COUNT_RECURSIVE

If you have a multidimensional array, you can use the COUNT_RECURSIVE mode to count all elements, including those in subarrays.

<?php
$inventory = [
    "fruits" => ["apple", "banana"],
    "vegetables" => ["carrot", "potato"],
    "dairy" => ["milk", "cheese"]
];

// Default mode (COUNT_NORMAL): Counts top-level elements only
echo count($inventory); // Output: 3

// Recursive mode: Counts all elements
echo count($inventory, COUNT_RECURSIVE); // Output: 8
?>

---

Caution: Recursive Arrays

The count() function detects recursion to avoid infinite loops, but it will emit a warning and return a count higher than expected if the array references itself.

<?php
$recursiveArray = [];
$recursiveArray["self"] = &$recursiveArray;

// Warning: Recursion detected
echo count($recursiveArray); // Output: 1 (with a warning)
?>

---

Working with Countable Objects

Objects that implement the Countable interface can also be used with count().

<?php
class MyCollection implements Countable {
    private $items;

    public function __construct($items) {
        $this->items = $items;
    }

    public function count(): int {
        return count($this->items);
    }
}

$collection = new MyCollection(["item1", "item2", "item3"]);

// Countable object
echo count($collection); // Output: 3
?>

---

Error Handling in PHP 8+

Starting from PHP 8.0, passing an invalid type to count() will throw a TypeError.

<?php
try {
    $result = count(123); // Invalid type
} catch (TypeError $e) {
    echo "Error: " . $e->getMessage();
}
?>

Output:

Error: count(): Argument #1 ($value) must be of type Countable|array, int given

---

Summary

The count() function is versatile and straightforward to use for counting elements in arrays and Countable objects. Here are the key takeaways:

1. Use count() for arrays and Countable objects.
2. Use COUNT_RECURSIVE to count elements in multidimensional arrays.
3. Handle potential recursion warnings and errors in complex data structures.
4. Be cautious of type errors in PHP 8+.

By understanding and applying these principles, you can harness the power of the count() function in your PHP projects. Happy coding!