array_all 怎样判断全部满足条件

我在把一组订单交给下一步处理时，常见的判断不是“有没有一条符合”，而是“每一条都通过校验了吗”。PHP 8.4 之后，这类全量判断可以直接写成 array_all()：回调对所有元素都返回 true，整体才是 true；只要遇到一个 false，结果立即是 false。

要点速览

• array_all(array $array, callable $callback): bool 从 PHP 8.4 起可用。
• 回调按值、键的顺序接收参数，键不用时可以省略。
• 空数组返回 true，遇到回调返回 false 后不会继续调用后面的元素。

先把版本和判断口径定清楚

array_all() 属于 PHP 8.4 新增的数组函数。它接收一个数组和一个可调用对象，返回值始终是布尔值，不会把第一个符合条件的元素返回出来。也就是说，它回答的是“全部是否通过”，而不是“哪一条通过”。

我会先把“满足条件”写成一句能被单独解释的规则，再放进回调。这样做的好处是，数组流转到检查函数时，输入、规则和结果三者不会混在一起。

array_all 的输入、回调和布尔结果

下面用订单状态做一个最小例子。这里的业务规则很窄：只有当每个订单的 status 都是 paid 时，才允许进入发货阶段。

 101, 'status' => 'paid'],
    ['id' => 102, 'status' => 'paid'],
];

// 每个订单都必须是已支付状态，整体结果才允许继续发货。
$allPaid = array_all(
    $orders,
    static function (array $order): bool {
        // 读取当前元素的业务字段，缺失时按不满足处理。
        return ($order['status'] ?? null) === 'paid';
    },
);

var_dump($allPaid); // bool(true)
?>

执行关系可以看成三段：$orders 是输入集合，回调负责判断单个订单，$allPaid 保存整个集合的结论。只要第二个订单改成 pending，整体结果就会变成 false，而不是返回那一条订单。

需要定位具体记录时，读取回调的第二个参数

关联数组中的键也会传给回调。对我来说，只有规则确实依赖键时才接收第二个参数，否则保持单参数更容易读。

 80,
    'memory' => 70,
    'disk' => 90,
];

// 键表示指标名称，值表示当前百分比；每项都低于 95 才算通过。
$safe = array_all(
    $limits,
    static function (int $value, string $key): bool {
        // 保留键参数，便于在调试器或日志中定位当前指标。
        return $value 

回调的参数顺序是 value、key。不要把它误写成键在前；也不要为了记录名称而在回调外重新遍历一次，这会让“检查全部元素”这条数据路径变得重复。

空数组和短路边界

array_all([], $callback) 的结果是 true。这符合“没有元素违反条件”的全称判断，但它可能和业务的“至少要有一条数据”不是一回事。如果业务要求非空，先单独判断数量，再调用 array_all()。

另一个容易忽略的点是短路：回调第一次返回 false 后，后面的元素不会再调用回调。这对有成本的检查很有价值，但也意味着不能把“必须执行的统计、日志或副作用”偷偷放进回调。回调最好只做判断，副作用放到明确的遍历逻辑里。

旧版本项目先处理兼容边界

如果项目运行在 PHP 8.3 或更早版本，直接调用 array_all() 会遇到函数不存在的问题。升级运行时之前，不能只把代码提交上去就结束；至少要把生产 PHP 版本、CLI 版本和测试环境的版本约束对齐。

如果暂时不能升级，旧项目可以保留原有的显式遍历实现，但要保持同样的语义：逐项检查、遇到不满足条件立即返回 false、全部通过后返回 true。迁移到 PHP 8.4 时，再把这段重复的控制流收敛到 array_all()，并重新检查空数组是否符合业务预期。

相关问题

array_all 和 array_any 有什么区别？

array_all() 要求全部元素通过；array_any() 只要求至少一个元素通过。选择哪个函数，取决于业务条件是“全部满足”还是“存在满足”。

空数组为什么会让 array_all 返回 true？

这是全称判断的逻辑结果：没有元素能证明条件被违反，所以结果为真。如果业务要求至少一条数据，必须额外加上非空判断。

回调里可以写日志或修改外部变量吗？

语法上可以，但不建议把副作用依赖在回调执行次数上，因为遇到第一个 false 后，后续回调不会再执行。需要完整处理每个元素时，应使用明确的遍历。