本文详解如何在自定义 wordpress json api 中，通过原生 sql 查询直接获取文章的 featured image（特色图像）url，无需加载 wordpress 核心函数，适用于轻量级外部接口场景。
在 WordPress 数据库中，特色图像并非直接存储在 wp_posts 表中，而是通过 post meta 机制关联：每篇设置了特色图像的文章，会在 wp_postmeta 表中生成一条 meta_key = '_thumbnail_id' 的记录，其 meta_value 即为附件（attachment）在 wp_posts 表中的 ID。该附件本身是一条 post_type = 'attachment' 的记录，其 guid 字段通常保存着图片的完整 URL（尤其在默认配置下未启用“重写附件 URL”时）。
因此，要将特色图像 URL 注入你的 JSON API，需在原有 SQL 查询中新增对 wp_postmeta 表的 JOIN 操作，并嵌套子查询或使用 JOIN 获取对应附件的 guid。以下是优化后的完整实现：
<?php
header("Content-Type: application/json");
require_once 'wp-connect.php';
$result = [];
$sql = <<<SQL
SELECT
wp_posts.ID,
wp_posts.post_author,
wp_posts.post_content,
wp_posts.post_date,
wp_posts.post_type,
wp_posts.post_title,
wp_posts.post_name,
wp_posts.post_modified,
wp_users.user_nicename,
pivoted.first_name,
pivoted.last_name,
pivoted.avatar_hash,
attachments.guid AS featured_image_url
FROM wp_users
INNER JOIN wp_posts
ON wp_users.ID = wp_posts.post_author AND wp_posts.post_type = 'post'
INNER JOIN wp_postmeta
ON wp_postmeta.post_id = wp_posts.ID AND wp_postmeta.meta_key = '_thumbnail_id'
INNER JOIN wp_posts AS attachments
ON attachments.ID = wp_postmeta.meta_value AND attachments.post_type = 'attachment'
INNER JOIN (
SELECT
user_id,
MAX(IF(meta_key = 'first_name', meta_value, NULL)) AS first_name,
MAX(IF(meta_key = 'last_name', meta_value, NULL)) AS last_name,
MAX(IF(meta_key = 'avatar_hash', meta_value, NULL)) AS avatar_hash
FROM wp_usermeta
GROUP BY user_id
) pivoted ON pivoted.user_id = wp_users.ID
ORDER BY wp_posts.ID;
SQL;
foreach (mysqli_query($conn, $sql) as $row) {
$result[] = [
'post_id' => (int) $row['ID'],
'user_id' => (int) $row['post_author'],
'post' => $row['post_content'],
'firstName' => $row['first_name'] ?: '',
'lastName' => $row['last_name'] ?: '',
'username' => $row['user_nicename'],
'avatar' => $row['avatar_hash'] ?: '',
'post_date' => $row['post_date'],
'post_type' => $row['post_type'],
'post_title' => $row['post_title'],
'post_name' => $row['post_name'],
'post_modified' => $row['post_modified'],
'featured_image_url'=> $row['featured_image_url'] ?: null // 若无特色图则返回 null
];
}
echo json_encode($result, JSON_UNESCAPED_UNICODE | JSON_PRETTY_PRINT);
?>✅ 关键改进说明：
- 使用 INNER JOIN wp_posts AS attachments 显式关联附件表，并限定 attachments.post_type = 'attachment'，确保只匹配有效图片附件；
- 直接选取 attachments.guid 作为 featured_image_url，语义清晰、性能优于子查询；
- 添加 (int) 类型转换与空值处理（如 ?: null），提升 API 健壮性与前端兼容性；
- 启用 JSON_UNESCAPED_UNICODE 避免中文被转义，提升可读性。
⚠️ 注意事项：
- guid 字段在 WordPress 中不建议直接用于前端展示（官方文档明确指出它可能不是永久 URL，例如迁移站点后可能失效）。生产环境推荐在 WordPress 内部使用 wp_get_attachment_image_src() 生成带尺寸、CDN 支持的可靠链接；
- 若需支持 WebP、响应式 srcset 或缩略图尺寸，纯 SQL 方案无法实现，应考虑改用 REST API 或构建轻量 WordPress 环境调用原生函数；
- 确保数据库前缀（如 wp_）与实际一致，多站点环境下需动态适配；
- 建议为 wp_postmeta.meta_key 和 wp_posts.post_type 添加数据库索引以提升 JOIN 性能。
综上，该方案在保持轻量、零依赖的前提下，精准解决了特色图像 URL 的 SQL 提取问题，特别适合已存在独立数据库连接逻辑的定制化 API 场景。
