WordPress 自定義字段（Post Meta）核心函數深度解析

核心概念

WordPress 自定義字段實際是 文章元數據，儲存在 wp_postmeta 表，結構極簡：meta_id、post_id、meta_key、meta_value。這種鍵值對設計賦予了極大靈活性：同一篇文章可擁有多個同名字段、任意插件/主題均可擴展數據、特色圖像、頁面模板等核心功能均基於此機制。

字段可見性規則

• 前綴「_」的字段（如 _thumbnail_id、_wp_page_template）在後台「自定義欄目」面板隱藏，the_meta() 也不輸出，屬於內部使用。
• 值為數組的字段即使無下劃線前綴，也自動隱藏。
• 利用此特性，可將敏感配置、緩存數據等標記為 _custom_key 避免用戶誤操作。

核心操作函數

1. 添加字段：add_post_meta()

add_post_meta(int $post_id, string $meta_key, mixed $meta_value, bool $unique = false)

• $unique = true：若同鍵已存在則不再添加（防止重複）。
• 返回新字段的 meta_id，失敗返回 false。

2. 更新字段：update_post_meta()

update_post_meta(int $post_id, string $meta_key, mixed $meta_value, mixed $prev_value = '')

• 若字段不存在則自動創建（等同 add_post_meta）。
• $prev_value 指定時，僅更新值匹配的行（解決同鍵多值更新歧義）。

3. 獲取字段：get_post_meta()

get_post_meta(int $post_id, string $key = '', bool $single = false)

• $single = true：返回單一字符串值（取第一條）。
• $single = false（默認）：返回數組，包含所有同鍵值（按添加順序）。
• 省略 $key 返回該文章所有字段的關聯數組。

實戰範例：文章瀏覽計數器

// 統計瀏覽（掛在 wp_head）
function my_statistics_visitors() {
    if (!is_singular()) return;
    global $post;
    if (get_post($post->ID)->post_status !== 'publish') return;

    $views = (int) get_post_meta($post->ID, 'views', true);
    update_post_meta($post->ID, 'views', $views + 1) 
        || add_post_meta($post->ID, 'views', 1, true);
}
add_action('wp_head', 'my_statistics_visitors');

// 前台獲取顯示
function my_get_views() {
    global $post;
    return number_format((int) get_post_meta($post->ID, 'views', true));
}

最佳實踐建議

1. 統一前綴：插件/主題字段加唯一前綴（如 myplugin_），避免衝突。
2. 善用隱藏字段：內部邏輯數據用 _ 開頭，減少用戶困擾。
3. 數據類型一致性：儲存數組時使用 serialize/json_encode，讀取時反序列化。
4. 性能考量：高頻讀取的字段可考慮緩存到 wp_options 或對象緩存。