PHP is_countable怎么用-php教程-PHP中文网

php 7.3+ 应用 is_countable() 判断变量是否可计数，再调用 count()，避免 warning；它比 is_array() 或 is_object() 更精准，能正确识别数组及实现 countable 接口的对象。

php is_countable怎么用

count() 报 Warning 时必须先用 is_countable

直接对不确定类型的变量调用 count()，在 PHP 7.2 及更早版本里会触发 Warning: count(): Parameter must be an array or an object that implements Countable。PHP 7.3+ 引入 is_countable() 就是为解决这个——它不抛警告、不执行计数逻辑、只做类型判断。

典型场景：处理来自 API 返回、ORM 关系、模板变量或用户输入的值，比如 $items 可能是 array、Collection、null、false 或字符串。

is_countable(null) → false
is_countable(false) → false
is_countable('hello') → false
is_countable([1,2]) → true
is_countable(new ArrayIterator([1])) → true

别用 is_array() 或 is_object() 替代 is_countable

is_array($v) 只覆盖数组，漏掉 Countable 对象（如 Laravel 的 Collection、Symfony 的 ArrayIterator）；is_object($v) 则太宽泛——绝大多数对象并不实现 Countable，直接 count($v) 仍会报错。

错误写法示例：

if (is_object($data)) {
    $len = count($data); // ❌ 即使是 object，也不一定可数
}

正确做法始终是：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

if (is_countable($data)) {
    $len = count($data); // ✅ 安全
} else {
    $len = 0;
}

低版本 PHP（

如果你还在维护 PHP 7.2 或更低环境，不能直接用 is_countable()，但可以安全补上定义：

if (!function_exists('is_countable')) {
    function is_countable($var): bool {
        return is_array($var) || $var instanceof Countable;
    }
}

注意两点：

不要加 is_object($var) 前置判断——因为 instanceof Countable 本身已隐含对象检查，且对非对象返回 false，加了反而多一次判断
别用 method_exists($var, 'count')——很多对象有 count() 方法但没实现 Countable 接口，PHP 不认，count() 调用仍失败

和 is_iterable 的区别别搞混

is_iterable() 判断能否用于 foreach，范围比 is_countable() 大得多：Traversable 对象（如 Generator）、数组都算，但 Generator 不能 count()；反过来，某些 Countable 对象（如空 ArrayObject）可能不可迭代（若未启用迭代器）。

所以：