函数文档

get_meta_keys()

💡 云策文档标注

概述

get_meta_keys() 函数用于从数据库中检索所有已定义的元键(meta key)名称。它通过查询 postmeta 表并返回一个字符串数组来实现此功能。

关键要点

  • 函数返回一个字符串数组,包含所有已定义的元键名称。
  • 使用全局 $wpdb 对象执行 SQL 查询,从 $wpdb->postmeta 表中按 meta_key 分组并排序。
  • 该函数自 WordPress 1.2.0 版本引入,是核心功能的一部分。

代码示例

function get_meta_keys() {
    global $wpdb;

    $keys = $wpdb->get_col(
        "SELECT meta_key
        FROM $wpdb->postmeta
        GROUP BY meta_key
        ORDER BY meta_key"
    );

    return $keys;
}

注意事项

  • 此函数依赖于 wpdb::get_col() 方法来获取数据库列数据,确保数据库连接正常。
  • 返回的元键列表基于 postmeta 表,可能不包括其他类型的元数据(如用户或评论元数据)。

📄 原文内容

Returns a list of previously defined keys.

Return

string[] Array of meta key names.

Source

function get_meta_keys() {
	global $wpdb;

	$keys = $wpdb->get_col(
		"SELECT meta_key
		FROM $wpdb->postmeta
		GROUP BY meta_key
		ORDER BY meta_key"
	);

	return $keys;
}

Changelog

Version Description
1.2.0 Introduced.