本文详解如何通过 WordPress REST API 的 after 参数精准获取最近 14 天发布的全部文章，并提供可直接集成的 PHP 代码示例，涵盖时间格式规范、时区注意事项及分页处理建议。
本文详解如何通过 wordpress rest api 的 `after` 参数精准获取最近 14 天发布的全部文章，并提供可直接集成的 php 代码示例，涵盖时间格式规范、时区注意事项及分页处理建议。
在 WordPress 开发中，利用 REST API 按时间范围筛选文章是常见需求。REST API 支持 after 和 before 查询参数，其值必须为符合 ISO 8601 标准的 UTC 时间字符串（如 2024-06-01T00:00:00），且默认按文章的 date_gmt 字段进行比较——这意味着你的时间值应基于 GMT/UTC，而非本地时区，否则可能导致漏取或误取。
以下是对原方法的优化实现，重点增强时间计算准确性与健壮性：
public function get_posts_via_rest_api(): array
{
$page_number = (int) get_option('global_posts_page', 1);
// 使用 DateTimeImmutable 避免意外修改全局时间对象（推荐替代 DateTime）
$now_utc = new DateTimeImmutable('now', new DateTimeZone('UTC'));
$two_weeks_ago = $now_utc->sub(new DateInterval('P14D'));
// 设置为 UTC 时间当天 00:00:01（避免因毫秒级精度或时区偏移导致边界遗漏）
$after = $two_weeks_ago->setTime(0, 0, 1)->format('Y-m-d\TH:i:s');
$url = add_query_arg([
'page' => $page_number,
'after' => $after,
'per_page' => 100, // 建议显式设置 per_page（默认仅10条），提升效率
], 'https://example.com/wp-json/wp/v2/posts');
try {
$response = wp_remote_get($url, [
'timeout' => 30,
'headers' => ['User-Agent' => 'WordPress-Plugin/1.0']
]);
if (is_wp_error($response)) {
error_log('WP REST API request failed: ' . $response->get_error_message());
return [];
}
$status_code = wp_remote_retrieve_response_code($response);
if ($status_code !== 200) {
error_log("HTTP {$status_code} returned from REST API");
return [];
}
$body = wp_remote_retrieve_body($response);
$posts = json_decode($body, false, 512, JSON_THROW_ON_ERROR);
return is_array($posts) ? $posts : [];
} catch (JsonException $e) {
error_log('JSON decode error: ' . $e->getMessage());
return [];
} catch (Exception $e) {
error_log('Unexpected error: ' . $e->getMessage());
return [];
}
}
✅ 关键改进说明：
- 使用
DateTimeImmutable防止时间对象被意外复用或修改； - 显式指定时区为
'UTC'，确保after值与 WordPress 存储的date_gmt严格对齐； - 添加
per_page=100参数（最大允许值），减少分页请求次数； - 使用
add_query_arg()构建 URL，自动处理 URL 编码，避免手动拼接导致的特殊字符错误（如+或空格）； - 补充超时与请求头配置，提升生产环境稳定性；
- 对
wp_remote_get错误、HTTP 状态码、JSON 解析异常做分层捕获，便于定位问题。
⚠️ 注意事项：
- 若需获取所有符合条件的文章（不限于单页），需循环调用并检查响应头中的
X-WP-TotalPages，或改用批量拉取策略（如配合per_page=100+ 多页遍历）； -
after是开区间（即date_gmt > after），因此设为00:00:01可确保包含当日零点后发布的第一篇文章； - 测试时建议在 WordPress 后台查看某篇文章的「快速编辑」中显示的「GMT 日期」，用于验证时间参数是否匹配。
通过以上实现，你即可稳定、准确地从 WordPress REST API 中拉取最近 14 天内发布的全部文章，为数据聚合、同步或前端展示提供可靠的数据源。
大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
