get_term_by()

WordPress根据分类法字段获取分类法对象函数

WordPress函数get_term_by根据分类法的字段返回该分类法对象，包括分类、标签和自定义分类法。

get_term_by( string $field, string|int $value, string $taxonomy = '', string $output = OBJECT, string $filter = 'raw' )

函数参数

$field

字符串

字段名称，例如：name、slug、id或ID

$value

字符串

字段的值

$taxonomy

字符串

分类法的名称，例如：category、post_tag

$output

字符串，默认值：OBJECT

返回的数据类型，默认返回对象，可选值：

OBJECT：默认值，以对象的形式返回数据；
ARRAY_A：以关联数组的形式返回数据；
ARRAY_N：以数字数组的形式返回数据。

$filter

字符串，默认值：raw

对数据使用函数sanitize_term进行字段过滤

函数返回值

WP_Term Object
(
    [term_id] => 1
    [name] => 开发
    [slug] => develop
    [term_group] => 0
    [term_taxonomy_id] => 1
    [taxonomy] => category
    [description] => 描述
    [parent] => 0
    [count] => 220
    [filter] => raw
)

函数使用示例

$category = get_term_by('name', 'develop', 'category');
echo '<li><a href="' . get_category_link($category->term_id) . '">' . $category->name . '</a></li>';

扩展阅读

get_term_by()函数位于：wp-includes/taxonomy.php