常用函数-get_term_by()

常用函数-get_term_by()

说明

通过Term字段和数据从数据库中获取所有Term资料。

警告：'name' $field中包括$value。必需时需要手动删除。

默认$field为'id'，因此字段值也可能为空，不推荐使用空值。

$value不存在时，返回的值为假。$taxonomy存在且$field和$value组合存在时，Term被返回。

用法

<?php get_term_by( $field, $value, $taxonomy, $output, $filter ) ?>

参数

$field

（字符串）（必需） 'slug', 'name', 或 'id'

默认值：None

$value

（字符串 | 整数）（必需）搜索term值

默认值：None

$taxonomy

（字符串）（必需）分类法名称

默认值：None

$output

（字符串）（可选）常量OBJECT, ARRAY_A, 或ARRAY_N

默认值：OBJECT

$filter

（字符串）（可选）默认值为raw，否则将不应用WordPress定义的过滤器。

默认值：'raw'

返回的值

（混合）

从数据库中返回erm行（Term Row）。若$taxonomy不存在或未发现$term时，返回false。

示例

注释

• 警告：'name' $field中包括$value。必需时需要手动删除。
• 参见 sanitize_term_field()，$context参数列出'get_term_by' $filter参数的有效值。
• 用法：返回前根据$filter环境清除term。
• 使用全局变量： (对象) $wpdb

修改记录

自2.3.0版本后

源文件

get_term_by()位于 wp-includes/taxonomy.php中。

相关资源

分类：中文手册