分析 `WP_Post_Type` 类的源码，解释它如何通过 “ 全局变量存储文章类型信息。 - 智猿学院-前后端，数据库，人工智能，云计算等领域前沿技术讲座

各位观众老爷们，大家好！今天咱们来聊聊 WordPress 里一个非常重要的角色：WP_Post_Type 类，以及它背后的全局变量 $wp_post_types。这玩意儿，你可能天天用，但未必真正了解它的底裤，哦不，底细。今天咱们就来扒一扒，看看它到底是怎么玩转文章类型信息的。

一、开场白：文章类型，WordPress 的骨架

在 WordPress 的世界里，内容才是王道，而内容要以什么形式展现，就得靠文章类型（Post Types）来定义。默认情况下，你有“文章（post）”和“页面（page）”两种，但 WordPress 的强大之处在于，你可以自定义文章类型，比如“产品”、“新闻”、“活动”等等。

想一下，如果没有文章类型，所有的内容都挤在一个桶里，那得多混乱？所以，文章类型就像是 WordPress 的骨架，支撑着各种各样的内容。

二、WP_Post_Type 类：文章类型的灵魂

WP_Post_Type 类是定义和管理文章类型的核心。它包含了文章类型的所有信息，例如：

name (string): 文章类型的名称，必须是小写字母和下划线的组合（例如：my_custom_post_type）。这是文章类型的唯一标识符。
args (array): 一个包含各种参数的数组，用于配置文章类型的行为和显示方式。
label (string): 用于在管理界面中显示的单数标签（例如：“产品”）。
labels (array): 一个包含各种标签的数组，用于在管理界面中显示不同的文本（例如：“添加新产品”、“编辑产品”等）。
description (string): 文章类型的描述，用于在管理界面中显示。
public (bool): 是否公开，决定了文章类型是否可以通过前端访问。
hierarchical (bool): 是否具有层级关系，像页面一样。
supports (array): 支持的功能，例如“标题”、“正文”、“特色图像”等。
taxonomies (array): 与文章类型关联的分类法（例如：“分类目录”、“标签”）。
rewrite (array|bool): 重写规则，用于自定义文章类型的 URL 结构。

等等等等，参数多到你眼花缭乱。

三、$wp_post_types 全局变量：文章类型的家

$wp_post_types 是一个全局数组，它存储了所有已注册的文章类型的信息。这个数组的键是文章类型的名称（name），值是对应的 WP_Post_Type 对象。

简单来说，$wp_post_types 就像是一个大仓库，每个文章类型都在里面占有一个格子，格子里面放着关于这个文章类型的各种信息。

四、代码实战：注册文章类型并查看 $wp_post_types

咱们来看一段代码，演示如何注册一个自定义文章类型，并查看 $wp_post_types 变量的内容：

<?php
/**
 * 注册自定义文章类型
 */
function register_my_custom_post_type() {
  $args = array(
    'label'  => null,
    'labels' => array(
        'name'               => '书籍',
        'singular_name'      => '书籍',
        'menu_name'          => '书籍管理',
        'name_admin_bar'     => '书籍',
        'add_new'            => '添加书籍',
        'add_new_item'       => '添加新书籍',
        'new_item'           => '新书籍',
        'edit_item'          => '编辑书籍',
        'view_item'          => '查看书籍',
        'all_items'          => '所有书籍',
        'search_items'       => '搜索书籍',
        'parent_item_colon'  => '父级书籍：',
        'not_found'          => '没有找到书籍。',
        'not_found_in_trash' => '回收站中没有找到书籍。',
    ),
    'description'         => '用于展示书籍信息的文章类型。',
    'public'              => true,
    'publicly_queryable'  => true,
    'show_ui'             => true,
    'show_in_menu'        => true,
    'query_var'           => true,
    'rewrite'             => array( 'slug' => 'book' ),
    'capability_type'     => 'post',
    'hierarchical'        => false,
    'menu_position'       => null,
    'supports'            => array( 'title', 'editor', 'author', 'thumbnail', 'excerpt', 'comments' ),
    'has_archive'         => true,
    'exclude_from_search' => false,
    'show_in_rest'        => true, // 允许在 Gutenberg 编辑器中使用
  );

  register_post_type( 'book', $args );
}
add_action( 'init', 'register_my_custom_post_type' );

/**
 * 查看 $wp_post_types 变量的内容
 */
function debug_wp_post_types() {
  global $wp_post_types;
  echo '<pre>';
  print_r( $wp_post_types );
  echo '</pre>';
}
add_action( 'wp_footer', 'debug_wp_post_types' ); // 在页面底部输出
?>

这段代码做了两件事：

register_my_custom_post_type() 函数： 使用 register_post_type() 函数注册了一个名为 book 的自定义文章类型。 $args 数组包含了 book 文章类型的各种配置信息。
debug_wp_post_types() 函数： 使用 global $wp_post_types; 声明 $wp_post_types 为全局变量，然后使用 print_r() 函数将 $wp_post_types 数组的内容输出到页面底部。

当你激活这个代码片段后，刷新你的 WordPress 网站，你会在页面底部看到 $wp_post_types 数组的内容。你会发现，数组中包含了 post、page 等默认文章类型，以及你刚刚注册的 book 文章类型。

五、WP_Post_Type 的实例化过程

当我们调用 register_post_type() 函数时，WordPress 内部会发生以下事情：

参数验证： 首先，会对传入的参数进行验证，确保文章类型的名称和参数符合规范。
WP_Post_Type 实例化： 创建一个 WP_Post_Type 类的实例，并将文章类型的名称和参数传递给构造函数。
参数合并： 将传入的参数与默认参数进行合并，得到最终的配置信息。
存储到 $wp_post_types： 将 WP_Post_Type 实例存储到 $wp_post_types 全局数组中，以文章类型的名称作为键。

可以用一个表格来总结这个流程：

步骤	描述	涉及函数/操作
1. 参数验证	验证文章类型名称和参数的有效性。	内部验证逻辑
2. 实例化	创建 `WP_Post_Type` 类的新实例。	`new WP_Post_Type( $post_type, $args )`
3. 参数合并	将用户提供的参数与默认参数合并。	`WP_Post_Type` 类的构造函数内部逻辑
4. 存储到全局变量	将 `WP_Post_Type` 对象存储到 `$wp_post_types` 全局数组中。	`$wp_post_types[ $post_type ] = $post_type_object;`

六、WP_Post_Type 类的方法：操作文章类型

WP_Post_Type 类提供了一些方法，用于操作文章类型的信息，例如：

__get( $key )： 用于获取文章类型属性的值。例如，$post_type_object->label 可以获取文章类型的标签。
get_properties()： 获取文章类型的所有属性。
get_labels()： 获取文章类型的所有标签。
set_props( $args )： 设置文章类型的属性。

这些方法允许你以面向对象的方式访问和修改文章类型的信息。

七、$wp_post_types 的应用场景

$wp_post_types 全局变量在 WordPress 中被广泛使用，例如：

判断文章类型是否存在： 可以使用 isset( $wp_post_types[ 'my_custom_post_type' ] ) 来判断名为 my_custom_post_type 的文章类型是否存在。
获取文章类型的信息： 可以使用 $wp_post_types[ 'my_custom_post_type' ] 来获取 my_custom_post_type 文章类型的 WP_Post_Type 对象，然后通过该对象的方法来访问文章类型的信息。
修改文章类型的属性： 可以使用 $wp_post_types[ 'my_custom_post_type' ]->set_props() 方法来修改 my_custom_post_type 文章类型的属性。
在循环中处理不同的文章类型： 可以在循环中遍历 $wp_post_types 数组，然后根据文章类型的名称来执行不同的操作。

八、避免直接修改 $wp_post_types

虽然你可以直接修改 $wp_post_types 数组的内容，但是强烈建议不要这样做。直接修改全局变量可能会导致不可预测的问题，并且在 WordPress 更新时可能会被覆盖。

如果你需要修改文章类型的属性，应该使用 register_post_type() 函数重新注册文章类型，或者使用 add_filter( 'register_post_type_args', 'filter_post_type_args', 10, 2 ) 过滤器来修改文章类型的参数。

九、高级技巧：使用过滤器修改文章类型参数

register_post_type_args 过滤器允许你在文章类型注册之前修改其参数。这是一种更安全、更灵活的方式来定制文章类型。

<?php
/**
 * 使用过滤器修改文章类型参数
 */
function filter_post_type_args( $args, $post_type ) {
  if ( 'book' === $post_type ) {
    // 修改 'book' 文章类型的标签
    $args['labels']['name'] = '图书';
    $args['labels']['singular_name'] = '图书';
    $args['menu_icon'] = 'dashicons-book-alt'; // 添加菜单图标
  }

  return $args;
}
add_filter( 'register_post_type_args', 'filter_post_type_args', 10, 2 );
?>

这段代码演示了如何使用 register_post_type_args 过滤器来修改 book 文章类型的标签和添加菜单图标。

十、总结：WP_Post_Type 和 $wp_post_types 的重要性

WP_Post_Type 类和 $wp_post_types 全局变量是 WordPress 文章类型系统的核心。理解它们的工作原理，可以帮助你更好地定制和管理 WordPress 网站的内容。

WP_Post_Type 类定义了文章类型的结构和行为。
$wp_post_types 全局变量存储了所有已注册的文章类型的信息。
避免直接修改 $wp_post_types 数组，应该使用 register_post_type() 函数或 register_post_type_args 过滤器来修改文章类型的属性。

好了，今天的讲座就到这里。希望大家对 WP_Post_Type 类和 $wp_post_types 全局变量有了更深入的了解。记住，掌握了这些知识，你就可以像一位真正的 WordPress 大师一样，玩转文章类型，构建出更加强大和灵活的网站！

下次再见！

发表回复 取消回复

发表回复取消回复