get_category_by_slug('slug')可直接获取分类对象,但仅适用于category分类法;自定义分类法须用get_term_by('slug', 'xxx', 'taxonomy'),并检查is_wp_error()和缓存一致性。

PHP中用get_category_by_slug()获取栏目所属分类
WordPress环境下,栏目(即分类目录)本身是category类型的一种,所谓“栏目所属分类”实际是误解——分类没有父级分类(category可以有父类,但“栏目”不是独立对象)。更常见需求是:已知一个文章的栏目(如 slug 为 news),想拿到它的分类对象(含 ID、名称、父级 ID 等)。
直接用 get_category_by_slug('news') 即可返回 WP_Term 对象,包含 $term->term_id、$term->parent、$term->name 等字段。
- 该函数只适用于分类法(taxonomy)为
category的情况;若用在自定义分类法(如product_type),得换get_term_by('slug', 'xxx', 'product_type') - 返回值为
false表示未找到,务必先判断:if (!$cat = get_category_by_slug('news')) { return; } - 注意:它不支持多语言 slug(如 WPML 环境下不同语言对应不同 slug),此时需先获取当前语言上下文再查
从文章反查所属栏目(wp_get_post_categories() 和 get_the_category() 区别)
如果已知一篇文章 ID(比如 $post_id = 123),想获取它归属的栏目列表,两个常用函数行为不同:
-
wp_get_post_categories(123)返回纯数字数组,如[5, 8],仅含分类 ID,轻量、快,适合做 in 操作或批量查询 -
get_the_category(123)返回WP_Term对象数组,含完整字段(name、slug、count等),但默认只取第一个分类(即使文章属多个栏目),且会触发额外过滤钩子(如get_the_category),性能略低 - 要取全部栏目对象,得显式传参:
get_the_category(123, ['pad_counts' => false]),否则可能因缓存/计数逻辑出错
自定义分类法下如何安全取栏目信息(get_term_by() 的关键参数)
当使用自定义分类法(比如注册了 book_genre),不能用 get_category_by_slug(),必须用通用接口 get_term_by():
立即学习“PHP免费学习笔记(深入)”;
$term = get_term_by('slug', 'fiction', 'book_genre');
if ($term && !is_wp_error($term)) {
echo $term->name;
}
- 第一个参数是查找依据,可选
'slug'、'name'、'term_id';用slug最稳妥,因为name可能含空格或特殊字符 - 第二个参数是值,注意前后空格和大小写敏感(
'Fiction'≠'fiction') - 第三个参数必须是注册过的 taxonomy 名称,拼错或未激活会导致返回
false,且无提示 - 务必检查
is_wp_error($term),某些插件钩子可能让它返回错误对象而非false
避免缓存导致栏目信息过期(wp_cache_delete() 场景)
在后台更新栏目(如改名、调父子关系)后,前端可能仍显示旧数据——这是因为 WordPress 默认缓存了 get_term_by() 和 get_category_by_slug() 的结果。手动刷新不一定生效。
- 开发时可临时加
wp_cache_delete($term_id, 'category')或wp_cache_delete($term_id, 'book_genre')强制清除 - 线上环境不建议随意删缓存,更稳妥的是在保存栏目时用
clean_term_cache($term_id, $taxonomy),它会自动清理相关键(包括按 slug 的缓存) - 注意:如果用了对象缓存(Redis/Memcached),
wp_cache_delete()未必起作用,得看具体缓存后端配置
栏目归类逻辑看着简单,但 slug 冲突、多级父子、缓存穿透、自定义分类法命名不一致——这几个点漏掉一个,就容易返回空或错数据。










