前言
随着移动互联网的快速发展，小程序已成为连接用户与服务的重要渠道。对于使用WordPress搭建网站的企业或个人来说，将WordPress内容与小程序对接可以极大地扩展业务触达范围。本文将详细介绍如何使用WordPress为小程序构建高效、安全的API接口。
一、准备工作
- 环境要求
- WordPress 5.0及以上版本
- PHP 7.4及以上
- 已安装并配置SSL证书(HTTPS)
- 小程序开发者账号
- 必要插件安装
- REST API插件：WP REST API
- 安全插件：JWT Authentication for WP REST API
- 可选：Custom Post Type UI(如需自定义内容类型)
二、基础接口配置
- 启用WordPress REST API WordPress本身已内置REST API功能，默认访问地址为：
https://您的域名/wp-json/wp/v2/
- 安装JWT认证插件
- 在插件市场搜索”JWT Authentication for WP REST API”并安装
- 修改wp-config.php文件，添加：
define('JWT_AUTH_SECRET_KEY', '您的自定义密钥');
define('JWT_AUTH_CORS_ENABLE', true);
- 测试基础接口 使用Postman等工具测试获取文章列表：
GET https://您的域名/wp-json/wp/v2/posts
三、小程序专用接口开发
- 创建自定义端点 在主题的functions.php中添加：
add_action('rest_api_init', function() {
register_rest_route('wxapp/v1', '/latest-posts', array(
'methods' => 'GET',
'callback' => 'get_latest_posts_for_wxapp',
));
});
function get_latest_posts_for_wxapp($request) {
$args = array(
'post_type' => 'post',
'posts_per_page' => 10,
'orderby' => 'date',
'order' => 'DESC'
);
$posts = get_posts($args);
$data = array();
foreach ($posts as $post) {
$data[] = array(
'id' => $post->ID,
'title' => $post->post_title,
'excerpt' => wp_trim_words($post->post_content, 30),
'thumbnail' => get_the_post_thumbnail_url($post->ID, 'thumbnail'),
'date' => $post->post_date
);
}
return new WP_REST_Response($data, 200);
}
- 用户登录集成
add_action('rest_api_init', function() {
register_rest_route('wxapp/v1', '/login', array(
'methods' => 'POST',
'callback' => 'wxapp_user_login',
));
});
function wxapp_user_login($request) {
$params = $request->get_json_params();
$username = $params['username'];
$password = $params['password'];
$user = wp_authenticate($username, $password);
if (is_wp_error($user)) {
return new WP_Error('auth_failed', '认证失败', array('status' => 403));
}
// 生成JWT token
$token = JWT_AUTH::generate_token($user);
return new WP_REST_Response(array(
'token' => $token,
'user_id' => $user->ID,
'display_name' => $user->display_name
), 200);
}
四、性能优化与安全
- 缓存策略
- 安装WP Super Cache或W3 Total Cache插件
- 为API响应添加缓存头：
header('Cache-Control: max-age=3600');
- 接口限流
add_filter('rest_pre_dispatch', 'limit_rest_api_requests', 10, 3);
function limit_rest_api_requests($result, $server, $request) {
$ip = $_SERVER['REMOTE_ADDR'];
$transient_name = 'api_limit_' . $ip;
$requests = get_transient($transient_name) ?: 0;
if ($requests > 100) { // 每分钟限制100次请求
return new WP_Error('too_many_requests', '请求过于频繁', array('status' => 429));
}
set_transient($transient_name, $requests + 1, 60); // 60秒过期
return $result;
}
- 数据过滤与验证
function get_latest_posts_for_wxapp($request) {
// 验证参数
$per_page = $request->get_param('per_page');
$per_page = is_numeric($per_page) ? min(absint($per_page), 20) : 10;
// ...其余代码
}
五、小程序端对接
- 基础请求封装
const API_BASE = 'https://您的域名/wp-json/wxapp/v1';
function wpRequest(endpoint, method = 'GET', data = null) {
return new Promise((resolve, reject) => {
wx.request({
url: API_BASE + endpoint,
method: method,
data: data,
header: {
'Content-Type': 'application/json',
'Authorization': 'Bearer ' + wx.getStorageSync('token')
},
success: (res) => {
if (res.statusCode >= 200 && res.statusCode < 300) {
resolve(res.data);
} else {
reject(res.data);
}
},
fail: (err) => {
reject(err);
}
});
});
}
- 获取文章列表示例
Page({
data: {
posts: []
},
onLoad() {
this.fetchPosts();
},
fetchPosts() {
wpRequest('/latest-posts')
.then(posts => {
this.setData({ posts });
})
.catch(err => {
console.error('获取文章失败:', err);
});
}
});
六、常见问题解决
- 跨域问题
- 确保WordPress站点已启用HTTPS
- 在.htaccess中添加：
Header set Access-Control-Allow-Origin "*"
Header set Access-Control-Allow-Methods "GET, POST, OPTIONS"
Header set Access-Control-Allow-Headers "Content-Type, Authorization"
- 数据格式处理
- 使用wpautop()处理WordPress内容中的段落
- 转换图片URL为绝对路径
- 性能瓶颈
- 避免使用WP_Query的N+1查询问题
- 对大型站点考虑使用自定义数据库查询
结语
通过WordPress为小程序构建API接口，您可以充分利用现有内容资源，快速拓展移动端业务。本文介绍的方法既保持了WordPress的灵活性，又能满足小程序的性能要求。随着业务发展，您还可以进一步扩展接口功能，如添加支付系统、会员积分等高级特性，打造更完整的小程序生态系统。
建议在实际开发中，根据具体需求调整接口设计，并做好充分的测试和安全防护，确保数据交互的可靠性和用户信息的安全性。
