首页    >    中文手册    >   常用函数-get_term_by()

常用函数-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中。

相关资源

分类:中文手册

* 版权声明:作者WordPress啦! 转载请注明出处。