详解 WordPress `register_taxonomy_for_object_type()` 函数源码：如何将分类法与文章类型关联。 - 智猿学院-前后端，数据库，人工智能，云计算等领域前沿技术讲座

嘿，各位技术控们，准备好接受一场关于 WordPress register_taxonomy_for_object_type() 函数的深度剖析了吗？今天咱们要像剥洋葱一样，一层层地揭开它的神秘面纱，看看它是如何把分类法（Taxonomy）和文章类型（Post Type）这两个看似独立的个体紧密联系在一起的。系好安全带，我们的技术之旅马上开始！

一、开场白：WordPress 的分类体系——“物以类聚”的艺术

想象一下，如果没有分类，你的博客会是什么样子？所有文章堆在一起，就像一堆乱麻，用户找起来简直是噩梦。 WordPress 的分类法，就像一个精明的图书管理员，把各种文章按照主题、标签等进行归类，让信息井井有条，方便用户查找。

在 WordPress 中，分类法是组织内容的强大工具。它不仅仅限于默认的“分类”和“标签”，你还可以自定义各种各样的分类法，比如“书籍类型”、“产品品牌”、“课程难度”等等，只要你能想到，就能实现。

而文章类型，则定义了内容的种类。默认的文章类型有“文章”（post）和“页面”（page），但你也可以创建自定义文章类型，比如“产品”、“评论”、“活动”等等，让你的网站内容更加丰富多样。

现在问题来了，我们有了分类法，也有了文章类型，如何让它们之间建立联系，让特定的分类法只能用于特定的文章类型呢？这就是 register_taxonomy_for_object_type() 函数的用武之地了。

二、 register_taxonomy_for_object_type()：牵线搭桥的红娘

register_taxonomy_for_object_type() 函数，就像一个经验丰富的红娘，专门负责把分类法和文章类型这两个“有缘人”牵到一起。它的作用非常简单直接：将一个已经注册的分类法与一个或多个文章类型关联起来。

1. 函数原型：

<?php
function register_taxonomy_for_object_type( string $taxonomy, string $object_type ): void;

$taxonomy (string): 要关联的分类法的名称（slug）。
$object_type (string): 要关联的文章类型的名称（slug）。

2. 参数详解：

$taxonomy：这个参数指定了你要使用的分类法。必须是已经通过 register_taxonomy() 函数注册过的分类法。如果你想把“书籍类型”这个分类法和“图书”这个文章类型关联起来，那么 $taxonomy 就应该是 ‘book_type’ (假设你注册分类法时使用的 slug 是 ‘book_type’)。
$object_type：这个参数指定了你要关联的文章类型。同样，这个文章类型也必须是已经注册过的，通常是通过 register_post_type() 函数注册的。如果我们要关联到“图书”这个文章类型，那么 $object_type 就应该是 ‘book’ (假设你注册文章类型时使用的 slug 是 ‘book’)。

3. 使用示例：

假设我们已经注册了名为 genre 的分类法和名为 movie 的文章类型。现在我们要把 genre 分类法应用到 movie 文章类型上，可以这样写：

<?php
add_action( 'init', 'my_register_taxonomy_for_object_type' );

function my_register_taxonomy_for_object_type() {
    register_taxonomy_for_object_type( 'genre', 'movie' );
}

这段代码的意思是：当 WordPress 初始化完成后（init 钩子），执行 my_register_taxonomy_for_object_type 函数。这个函数调用了 register_taxonomy_for_object_type，将 genre 分类法和 movie 文章类型关联起来。这样，当你编辑 movie 类型的文章时，就会看到 genre 分类法的选项了。

三、源码分析：register_taxonomy_for_object_type() 背后的秘密

虽然 register_taxonomy_for_object_type() 函数看起来很简单，但它的内部实现却涉及到 WordPress 的核心机制。让我们深入源码，看看它到底做了些什么。

位于 wp-includes/taxonomy.php 文件中。
源码：

<?php
function register_taxonomy_for_object_type( string $taxonomy, string $object_type ): void {
    global $wp_taxonomies;

    if ( ! isset( $wp_taxonomies[ $taxonomy ] ) ) {
        _doing_it_wrong(
            __FUNCTION__,
            sprintf(
                /* translators: %s: Taxonomy name. */
                __( 'Taxonomy %s does not exist.' ),
                '<code>' . esc_html( $taxonomy ) . '</code>'
            ),
            '4.4.0'
        );
        return;
    }

    if ( ! post_type_exists( $object_type ) ) {
        _doing_it_wrong(
            __FUNCTION__,
            sprintf(
                /* translators: %s: Post type name. */
                __( 'Post type %s does not exist.' ),
                '<code>' . esc_html( $object_type ) . '</code>'
            ),
            '4.4.0'
        );
        return;
    }

    $wp_taxonomies[ $taxonomy ]->object_type = array_unique( array_merge( $wp_taxonomies[ $taxonomy ]->object_type, (array) $object_type ) );
}

代码解读：
- global $wp_taxonomies;: 首先，函数声明了一个全局变量 $wp_taxonomies。这个变量是一个关联数组，存储了所有已注册的分类法的信息。每个分类法的名称（slug）作为数组的键，对应的值是一个 WP_Taxonomy 对象，包含了该分类法的各种属性，比如标签、描述、支持的文章类型等等。
- if ( ! isset( $wp_taxonomies[ $taxonomy ] ) ) { ... }: 这段代码检查指定的分类法是否存在。如果 $wp_taxonomies 数组中没有以 $taxonomy 为键的元素，说明该分类法尚未注册。函数会调用 _doing_it_wrong() 函数抛出一个错误提示，并直接返回，不再执行后续操作。 _doing_it_wrong() 是 WordPress 提供的一个用于报告错误使用的函数，它会显示错误信息，方便开发者调试。
- if ( ! post_type_exists( $object_type ) ) { ... }: 这段代码检查指定的文章类型是否存在。 post_type_exists() 是 WordPress 内置的函数，用于判断一个文章类型是否已经注册。如果文章类型不存在，函数同样会抛出一个错误提示并返回。
- $wp_taxonomies[ $taxonomy ]->object_type = array_unique( array_merge( $wp_taxonomies[ $taxonomy ]->object_type, (array) $object_type ) );: 这行代码是整个函数的关键所在。它完成了将分类法和文章类型关联的实际操作。
  - $wp_taxonomies[ $taxonomy ]->object_type: 这部分代码获取了 $taxonomy 分类法所支持的文章类型数组。每个 WP_Taxonomy 对象都有一个 object_type 属性，它是一个数组，存储了所有与该分类法关联的文章类型的名称（slug）。
  - (array) $object_type: 这部分代码将 $object_type 变量强制转换为数组。这样做是为了处理 $object_type 既可以是单个文章类型名称，也可以是文章类型名称数组的情况。
  - array_merge( $wp_taxonomies[ $taxonomy ]->object_type, (array) $object_type ): 这部分代码使用 array_merge() 函数将原有的文章类型数组和新的文章类型数组合并。 array_merge() 函数会将两个数组中的元素合并到一个新的数组中。
  - array_unique( ... ): 这部分代码使用 array_unique() 函数去除合并后的数组中的重复元素。这样做是为了避免同一个文章类型被多次添加到分类法的支持列表中。
  - 最后，将处理后的数组赋值回 $wp_taxonomies[ $taxonomy ]->object_type 属性，完成关联。

四、实用技巧：register_taxonomy_for_object_type() 的高级用法

关联多个文章类型：

如果你想将一个分类法关联到多个文章类型，可以将 $object_type 参数设置为一个数组：
```
<?php
add_action( 'init', 'my_register_taxonomy_for_object_type' );

function my_register_taxonomy_for_object_type() {
    register_taxonomy_for_object_type( 'genre', array( 'movie', 'book' ) );
}
```
这样，genre 分类法就会同时应用到 movie 和 book 这两个文章类型上。

在注册分类法时直接关联：

你也可以在注册分类法时，通过 register_taxonomy() 函数的 object_type 参数直接指定要关联的文章类型：

<?php
add_action( 'init', 'my_register_taxonomy' );

function my_register_taxonomy() {
    $args = array(
        'label'        => __( '类型', 'textdomain' ),
        'rewrite'      => array( 'slug' => 'genre' ),
        'hierarchical' => true,
        'object_type'  => array( 'movie', 'book' ), // 直接指定关联的文章类型
    );
    register_taxonomy( 'genre', array( 'movie', 'book' ), $args );
}

这种方式更加简洁，可以将分类法的注册和关联放在一起完成。需要注意的是，如果你使用了这种方式，就不需要再单独调用 register_taxonomy_for_object_type() 函数了。

动态关联文章类型：

有时候，你可能需要在运行时动态地决定要关联的文章类型。比如，根据用户的角色或网站的配置，选择性地关联某些文章类型。这时，你可以使用 register_taxonomy_for_object_type() 函数，并在合适的时机调用它：

<?php
add_action( 'init', 'my_register_taxonomy' );

function my_register_taxonomy() {
    $args = array(
        'label'        => __( '类型', 'textdomain' ),
        'rewrite'      => array( 'slug' => 'genre' ),
        'hierarchical' => true,
    );
    register_taxonomy( 'genre', '', $args ); // 注意：这里没有指定 object_type
}

add_action( 'wp_loaded', 'my_dynamic_taxonomy_association' );

function my_dynamic_taxonomy_association() {
    // 根据条件判断是否关联到 'movie' 文章类型
    if ( current_user_can( 'edit_movies' ) ) {
        register_taxonomy_for_object_type( 'genre', 'movie' );
    }

    // 根据条件判断是否关联到 'book' 文章类型
    if ( get_option( 'enable_book_taxonomy' ) ) {
        register_taxonomy_for_object_type( 'genre', 'book' );
    }
}

在这个例子中，我们首先使用 register_taxonomy() 函数注册了 genre 分类法，但是没有指定 object_type。然后，我们在 wp_loaded 钩子上注册了一个函数 my_dynamic_taxonomy_association。这个函数会根据用户的权限和网站的配置，动态地决定是否将 genre 分类法关联到 movie 和 book 这两个文章类型。

五、注意事项：避免踩坑的秘诀

确保分类法和文章类型都已注册： 在使用 register_taxonomy_for_object_type() 函数之前，一定要确保你要关联的分类法和文章类型都已经通过 register_taxonomy() 和 register_post_type() 函数注册过了。否则，函数会报错，你的代码将无法正常工作。
在合适的钩子上调用： register_taxonomy_for_object_type() 函数应该在 init 钩子上调用，以确保分类法和文章类型都已经注册完成。
避免重复关联： 虽然 register_taxonomy_for_object_type() 函数内部会去除重复的关联，但最好还是避免多次调用，以免造成不必要的性能损耗。
使用正确的 slug： $taxonomy 和 $object_type 参数都应该使用分类法和文章类型的 slug，而不是它们的标签或其他名称。

六、总结：掌握分类的艺术，打造井井有条的 WordPress 网站

register_taxonomy_for_object_type() 函数是 WordPress 中一个非常重要的函数，它可以让你灵活地控制分类法和文章类型的关联，从而更好地组织和管理你的网站内容。通过深入理解它的原理和用法，你可以轻松地创建出各种各样的自定义分类体系，让你的 WordPress 网站更加专业、易用。

希望今天的讲座能帮助你更好地理解 register_taxonomy_for_object_type() 函数。记住，技术学习永无止境，保持好奇心，不断探索，你一定能成为 WordPress 领域的专家！咱们下期再见！

发表回复 取消回复

发表回复取消回复