WordPress 主题中调用 count() 时因 get_the_terms() 返回 false 或 WP_Error 导致警告，需在使用前校验变量是否为有效数组。
wordpress 主题中调用 `count()` 时因 `get_the_terms()` 返回 `false` 或 `wp_error` 导致警告，需在使用前校验变量是否为有效数组。
该错误（Warning: count(): Parameter must be an array or an object that implements Countable）源于 PHP 7.2+ 对 count() 函数的严格类型要求：其参数必须是数组、实现了 Countable 接口的对象，不能是 null、false、字符串或整数。在 WordPress 中，get_the_terms($post_id, $taxonomy) 在以下情况会返回非数组值：
- 当前文章未分配任何分类（返回
false）； - 文章 ID 无效或不存在（返回
false）； - 分类法（如
'category'）名称拼写错误或未注册（返回WP_Error对象）； - 数据库查询失败（罕见，但可能返回
WP_Error）。
原代码直接对 $terms 调用 count($terms) 和 foreach($terms as ...)，一旦 $terms 为 false 或 WP_Error，即触发两个警告：count() 参数不可计数，以及 foreach() 接收了非法参数。
✅ 正确做法是始终校验 $terms 是否为有效数组。推荐使用 is_array() 进行类型判断（注意：WP_Error 对象不是数组，false 也不是），再执行后续逻辑：
<?php
$terms = get_the_terms($post->ID, 'category');
if (is_array($terms)) {
$total = count($terms);
$i = 0;
foreach ($terms as $term) {
if ($term->slug !== 'featured-post') {
$i++;
$term_link = get_term_link($term, 'category');
if (is_wp_error($term_link)) {
continue;
}
echo '<p class="category"><span><a href="' . esc_url($term_link) . '">' . esc_html($term->name) . '</a></span></p>';
if ($i !== $total) {
echo ' ';
}
}
}
} else {
// 可选：记录调试信息或输出默认提示
// error_log('No valid terms found for post ID ' . $post->ID);
}
?>? 关键优化说明：
立即学习“PHP免费学习笔记（深入）”；
- ✅ 使用
is_array($terms)精准拦截false/WP_Error，避免运行时警告； - ✅ 增加
esc_url()和esc_html()对输出内容进行转义，提升安全性（防止 XSS）； - ✅ 补充
else分支便于调试或降级处理（如显示“暂无分类”）； - ⚠️ 注意：
get_the_terms()返回的数组元素是WP_Term对象，可安全访问->slug和->name；
? 额外建议：
- 若仅需排除特定分类（如
"featured-post"），也可改用wp_get_post_categories()+get_categories()组合，语义更清晰； - 在开发环境开启
WP_DEBUG_LOG，便于捕获类似底层异常； - 升级至 PHP 8+ 后，该错误将升级为
TypeError（更严格），因此防御性校验是长期最佳实践。
遵循以上结构，即可彻底消除 count() 和 foreach() 的警告，同时提升代码健壮性与安全性。
