各位观众老爷们，大家好！今天咱们来聊聊 WordPress 里一个非常重要，但又容易被忽略的小家伙：get_post_meta()。 别看它名字平平无奇，但它可是 WordPress 幕后默默奉献的英雄，负责从数据库里捞取文章的元数据，让你的文章变得更加灵活多变。
今天这场“源码探秘之旅”的目标就是：把 get_post_meta() 扒个精光，看看它到底是怎么从数据库里把数据“变”出来的。准备好了吗？ Let’s go!
一、啥是元数据？ 为啥需要它？
在深入源码之前，咱们先来捋一捋什么是元数据。 简单来说，元数据就是描述数据的数据。对于 WordPress 的文章来说，除了标题、内容、作者这些基本信息，我们还可以添加一些额外的信息，比如：
- 自定义价格： 给商品文章设置一个价格。
- 阅读时长： 估计一篇文章的阅读时间。
- SEO 关键词： 为文章设置关键词，方便搜索引擎抓取。
- 作者评分： 作者给自己的文章打分。
这些额外的信息，就是文章的元数据。
有了元数据，文章就不仅仅是文本的堆砌，而是可以承载更多的信息，实现更加复杂的功能。 比如，你可以用元数据来实现：
- 电商网站的商品展示： 商品的价格、库存、型号等信息都可以用元数据来存储。
- 电影网站的影片信息： 影片的导演、演员、评分等信息都可以用元数据来存储。
- 新闻网站的专题报道： 专题报道的关键词、相关文章等信息都可以用元数据来存储。
看到了吧，元数据的作用可大了去了！
二、get_post_meta()：元数据搬运工
get_post_meta() 函数，就是负责把这些元数据从数据库里搬运出来的。 它的基本用法是这样的：
<?php
$post_id = get_the_ID(); // 获取文章 ID
$key = 'my_custom_field'; // 元数据的键名
$single = true; // 是否返回单个值
$value = get_post_meta( $post_id, $key, $single );
if ( $value ) {
echo '元数据的值是：' . $value;
} else {
echo '没有找到该元数据';
}
?>$post_id：文章的 ID，告诉函数你要获取哪篇文章的元数据。$key：元数据的键名，告诉函数你要获取哪个元数据。$single：一个布尔值，告诉函数你是要获取单个值，还是要获取一个数组。 如果设置为true，函数会返回第一个匹配的值；如果设置为false，函数会返回一个包含所有匹配值的数组。
三、源码解剖：get_post_meta() 的内心世界
现在，让我们深入 get_post_meta() 的源码，看看它到底是怎么工作的。 源码位于 wp-includes/post.php 文件中，咱们挑关键的部分来分析：
function get_post_meta( $post_id, $key = '', $single = false ) {
// 1. 检查文章 ID 是否有效
$post_id = absint( $post_id );
if ( ! $post_id ) {
return false;
}
// 2. 使用缓存
$meta_cache = wp_cache_get( $post_id, 'post_meta' );
if ( ! $meta_cache ) {
// 3. 从数据库中获取元数据
$meta_cache = update_meta_cache( 'post', array( $post_id ) );
if ( isset( $meta_cache[ $post_id ] ) ) {
$meta_cache = $meta_cache[ $post_id ];
} else {
$meta_cache = false;
}
}
// 4. 处理空键名的情况
if ( empty( $key ) ) {
if ( $single ) {
return '';
} else {
return $meta_cache;
}
}
// 5. 获取指定键名的元数据
if ( isset( $meta_cache[ $key ] ) ) {
$values = $meta_cache[ $key ];
} else {
return '';
}
// 6. 处理单/多值的情况
if ( $single ) {
if ( ! empty( $values ) ) {
return maybe_unserialize( $values[0] );
} else {
return '';
}
} else {
foreach ( $values as $index => $value ) {
$values[ $index ] = maybe_unserialize( $value );
}
return $values;
}
}让我们一步一步地解读这段代码：
-
检查文章 ID 是否有效：
$post_id = absint( $post_id ); if ( ! $post_id ) { return false; }这一步是为了确保传入的
$post_id是一个有效的整数。如果$post_id为空或者不是一个有效的整数，函数会直接返回false。 -
使用缓存：
$meta_cache = wp_cache_get( $post_id, 'post_meta' ); if ( ! $meta_cache ) { // ... }WordPress 使用了缓存机制来提高性能。
wp_cache_get()函数会尝试从缓存中获取文章的元数据。 如果缓存中已经存在该文章的元数据，函数会直接返回缓存中的数据，避免重复查询数据库。 -
从数据库中获取元数据：
$meta_cache = update_meta_cache( 'post', array( $post_id ) ); if ( isset( $meta_cache[ $post_id ] ) ) { $meta_cache = $meta_cache[ $post_id ]; } else { $meta_cache = false; }如果缓存中没有找到该文章的元数据，
update_meta_cache()函数会从数据库中获取该文章的元数据，并将其存储到缓存中。update_meta_cache()函数会返回一个包含所有文章元数据的数组，我们需要从这个数组中提取出指定文章的元数据。 -
处理空键名的情况：
if ( empty( $key ) ) { if ( $single ) { return ''; } else { return $meta_cache; } }如果传入的
$key为空，表示要获取该文章的所有元数据。 如果$single为true，函数会返回一个空字符串；如果$single为false，函数会返回一个包含所有元数据的数组。 -
获取指定键名的元数据：
if ( isset( $meta_cache[ $key ] ) ) { $values = $meta_cache[ $key ]; } else { return ''; }如果传入的
$key不为空，函数会从$meta_cache数组中查找该键名对应的元数据。 如果找到了，函数会将该元数据存储到$values变量中；如果没有找到，函数会返回一个空字符串。 -
处理单/多值的情况：
if ( $single ) { if ( ! empty( $values ) ) { return maybe_unserialize( $values[0] ); } else { return ''; } } else { foreach ( $values as $index => $value ) { $values[ $index ] = maybe_unserialize( $value ); } return $values; }最后，函数会根据
$single参数的值，返回单个值或者一个包含所有值的数组。maybe_unserialize()函数用于反序列化元数据的值。 因为 WordPress 在存储元数据时，可能会将一些复杂的数据类型（比如数组、对象）序列化成字符串，所以需要在使用之前反序列化。
四、update_meta_cache()：幕后功臣
在 get_post_meta() 的源码中，update_meta_cache() 函数起着至关重要的作用。 它负责从数据库中获取元数据，并将其存储到缓存中。 让我们来看看 update_meta_cache() 函数的源码：
function update_meta_cache( $meta_type, $object_ids ) {
global $wpdb;
$table = _get_meta_table( $meta_type );
if ( ! $table ) {
return false;
}
$object_ids = array_map( 'intval', (array) $object_ids );
$object_ids = array_filter( $object_ids );
if ( empty( $object_ids ) ) {
return false;
}
$id_list = join( ',', $object_ids );
$cache = array();
$key = "$meta_type" . "_meta";
$results = $wpdb->get_results(
"SELECT meta_id, {$meta_type}_id, meta_key, meta_value FROM $table WHERE {$meta_type}_id IN ($id_list) ORDER BY meta_key,meta_id",
ARRAY_A
);
if ( ! empty( $results ) ) {
foreach ( $results as $row ) {
$object_id = intval( $row[ $meta_type . '_id' ] );
$meta_key = $row['meta_key'];
$meta_value = $row['meta_value'];
$cache[ $object_id ][ $meta_key ][] = $meta_value;
}
foreach ( $object_ids as $id ) {
if ( ! isset( $cache[ $id ] ) ) {
$cache[ $id ] = array();
}
wp_cache_set( $id, $cache[ $id ], $key );
}
}
return $cache;
}这个函数的主要步骤如下：
-
获取元数据表名：
$table = _get_meta_table( $meta_type ); if ( ! $table ) { return false; }_get_meta_table()函数根据$meta_type(例如 ‘post’, ‘user’, ‘term’) 返回对应的元数据表名。 对于文章元数据来说，表名通常是wp_postmeta。 -
构造 SQL 查询语句：
$id_list = join( ',', $object_ids ); $results = $wpdb->get_results( "SELECT meta_id, {$meta_type}_id, meta_key, meta_value FROM $table WHERE {$meta_type}_id IN ($id_list) ORDER BY meta_key,meta_id", ARRAY_A );这段代码构造了一个 SQL 查询语句，用于从元数据表中获取指定文章 ID 的元数据。
{$meta_type}_id会被替换成对应的字段名，比如post_id。IN ($id_list)用于指定要查询的文章 ID 列表。ORDER BY meta_key,meta_id用于对结果进行排序。 -
处理查询结果：
if ( ! empty( $results ) ) { foreach ( $results as $row ) { $object_id = intval( $row[ $meta_type . '_id' ] ); $meta_key = $row['meta_key']; $meta_value = $row['meta_value']; $cache[ $object_id ][ $meta_key ][] = $meta_value; } foreach ( $object_ids as $id ) { if ( ! isset( $cache[ $id ] ) ) { $cache[ $id ] = array(); } wp_cache_set( $id, $cache[ $id ], $key ); } }这段代码遍历查询结果，将元数据存储到
$cache数组中。$cache数组的结构是这样的：$cache = array( $post_id => array( $meta_key => array( $meta_value1, $meta_value2, ... ), ... ), ... );最后，这段代码使用
wp_cache_set()函数将元数据存储到缓存中。
五、数据库结构：wp_postmeta 表
get_post_meta() 和 update_meta_cache() 函数都离不开 wp_postmeta 表。 让我们来看看 wp_postmeta 表的结构：
| 字段名 | 数据类型 | 描述 |
|---|---|---|
| meta_id | bigint(20) unsigned | 元数据的 ID，自增长 |
| post_id | bigint(20) unsigned | 文章的 ID，关联 wp_posts 表的 ID 字段 |
| meta_key | varchar(255) | 元数据的键名 |
| meta_value | longtext | 元数据的值，可以存储字符串、数字、数组、对象等，如果是复杂类型，会被序列化后存储 |
wp_postmeta 表的每一行都代表一个元数据。 post_id 字段关联到 wp_posts 表的 ID 字段，表示该元数据属于哪篇文章。 meta_key 字段存储元数据的键名， meta_value 字段存储元数据的值。
六、总结：get_post_meta() 的工作流程
现在，让我们来总结一下 get_post_meta() 函数的工作流程：
- 检查文章 ID 是否有效。
- 尝试从缓存中获取元数据。
- 如果缓存中没有找到，则调用
update_meta_cache()函数从数据库中获取元数据，并将其存储到缓存中。 - 根据传入的键名，从缓存中获取对应的元数据。
- 根据
$single参数的值，返回单个值或者一个包含所有值的数组。 - 对元数据的值进行反序列化。
七、性能优化：如何让 get_post_meta() 跑得更快？
虽然 WordPress 已经使用了缓存机制来提高 get_post_meta() 的性能，但我们仍然可以通过一些技巧来进一步优化：
- 避免在循环中使用
get_post_meta()： 在循环中使用get_post_meta()会导致多次查询数据库，影响性能。 应该尽量在循环外部获取元数据，然后将其存储到变量中，然后在循环中使用该变量。 - 使用
update_meta_cache()批量获取元数据： 如果需要获取多个文章的元数据，可以使用update_meta_cache()函数一次性获取所有文章的元数据，避免多次查询数据库。 - 使用对象缓存插件： 对象缓存插件可以将数据存储到内存中，提高缓存的读写速度。 常用的对象缓存插件有 Memcached 和 Redis。
- 合理设计元数据结构： 尽量避免存储过大的元数据，可以将复杂的数据拆分成多个简单的元数据。
八、彩蛋：一些你可能不知道的 get_post_meta() 的小秘密
get_post_meta()函数可以获取任何类型的元数据，不仅仅是文章的元数据。 只要指定正确的$meta_type和$object_id，就可以获取用户、分类、标签等其他类型的元数据。get_post_meta()函数可以获取隐藏的元数据。 默认情况下，WordPress 会隐藏一些元数据，比如以_开头的元数据。 但是，你可以通过设置$key参数来获取这些隐藏的元数据。get_post_meta()函数可以获取序列化后的元数据。 默认情况下，get_post_meta()函数会自动反序列化元数据的值。 但是，你可以通过设置$single参数为false，然后手动反序列化元数据的值。
好了，今天的 get_post_meta() 源码探秘之旅就到这里了。 希望通过今天的讲解，大家对 get_post_meta() 函数有了更深入的了解。 掌握了 get_post_meta() 函数，你就可以更加灵活地使用 WordPress 的元数据功能，实现更加复杂的功能。
下次再见！