当count()函数接收到非数组或不可计数对象（如null、字符串、整数）时会触发警告，通过将参数强制转换为数组可安全处理各种返回值。
当`count()`函数接收到非数组或不可计数对象（如`null`、字符串、整数）时会触发警告，通过将参数强制转换为数组可安全处理各种返回值。
在WordPress开发中，get_post_meta() 函数常用于获取自定义字段值，但其返回结果具有不确定性：当元数据不存在时返回 false；当设置为 $single = true（默认）且值为空时可能返回空字符串 '' 或 null；若存储的是序列化数组但反序列化失败，还可能返回原始字符串或 false。而 PHP 7.2+ 对 count() 函数增加了严格类型检查——仅接受数组或实现了 Countable 接口的对象，否则抛出 Warning: count(): Parameter must be an array or an object that implements Countable。
上述代码中，$rating_criteria = get_post_meta($post_id, 'user_review' . 'rating_criteria', true) 的返回值未经校验即直接传入 count($rating_criteria)，一旦 $rating_criteria 为 null、false 或字符串，就会触发该警告。
✅ 推荐解决方案：使用 (array) 强制类型转换
这是最简洁、安全且符合 PHP 最佳实践的方式。无论原始值是 null、false、字符串、数字还是数组，(array)$var 都会将其转换为一个数组：
- null → []（空数组，count() 返回 0）
- false → [false]（单元素数组，count() 返回 1 —— 但业务上通常需进一步判断有效性）
- 字符串 'abc' → ['abc']
- 已有数组 → 保持不变
因此，只需将原代码中这一行：
$rating_criteria_count = count($rating_criteria);
修改为：
立即学习“PHP免费学习笔记（深入）”；
$rating_criteria_count = count((array) $rating_criteria);
同时，为保障逻辑健壮性，建议同步优化后续的空值判断逻辑。原代码使用 if ($rating_criteria) 判断数组非空，但该条件在 $rating_criteria = false 或 '' 时为 false，而在 $rating_criteria = '0' 或 0 时也为 false（PHP 类型转换陷阱）。更准确的做法是显式检查是否为非空数组：
// 替换原 if($rating_criteria) {...}
if (is_array($rating_criteria) && !empty($rating_criteria)) {
foreach ($rating_criteria as $criteria) {
if (isset($criteria['score']) && is_numeric($criteria['score'])) {
$score_array[] = (float) $criteria['score'];
}
}
}此外，注意以下关键细节：
- ✅ 始终对 get_post_meta() 的返回值做防御性处理，尤其在 $single = true 模式下；
- ⚠️ 避免依赖松散比较（如 if ($rating_criteria)），优先使用 is_array() + !empty() 组合；
- ? 若元数据本应为数组却返回字符串，需检查数据存储方式（是否被意外覆盖为字符串？是否未正确 update_post_meta() 数组值？）；
- ?️ 在生产环境开启 error_reporting(E_ALL & ~E_NOTICE & ~E_WARNING) 并不解决根本问题，仅掩盖风险——务必修复代码逻辑。
最终修正后的核心片段如下：
function larus_user_review_print_review_badge($post_id, $echo = true) {
$rating_type = 'number';
$rating_criteria = get_post_meta($post_id, 'user_review' . 'rating_criteria', true);
$rating_criteria_count = count((array) $rating_criteria); // ✅ 安全计数
$output = '';
$score_array = [];
// ✅ 更严谨的数组有效性判断
if (is_array($rating_criteria) && !empty($rating_criteria)) {
foreach ($rating_criteria as $criteria) {
if (isset($criteria['score']) && is_numeric($criteria['score'])) {
$score_array[] = (float) $criteria['score'];
}
}
}
$final_score = !empty($score_array)
? number_format(array_sum($score_array) / $rating_criteria_count, 1, '.', '') + 0
: 0;
$final_bar = !empty($score_array)
? (array_sum($score_array) / $rating_criteria_count) * 10
: 0;
if (!empty($score_array)) {
$output = '<div class="jl_review_wrapper">
<div class="jl_rating_front" data-percent="' . esc_attr($final_bar) . '">
<span class="jl_rating_value">' . larus_user_review_calculate_score($final_score, $rating_type, true) . '</span>
</div>
</div>';
}
if ($echo === true) {
echo $output;
} else {
return $output;
}
}此方案兼顾安全性、可读性与向后兼容性，是 WordPress 主题/插件开发中处理元数据数组的经典范式。
