WordPress小程序掃碼登錄功能實(shí)現(xiàn)指南

來自：素雅營銷研究院

方知筆記

2025年07月01日 09:13

引言

隨著移動(dòng)互聯(lián)網(wǎng)的發(fā)展，小程序因其輕量化、便捷性受到廣泛歡迎。許多WordPress網(wǎng)站希望通過小程序掃碼登錄功能提升用戶體驗(yàn)，實(shí)現(xiàn)快速、安全的身份驗(yàn)證。本文將介紹如何在WordPress中集成小程序掃碼登錄功能，幫助開發(fā)者高效完成這一需求。

一、實(shí)現(xiàn)原理

小程序掃碼登錄的核心流程如下：

生成二維碼：WordPress網(wǎng)站生成一個(gè)帶有唯一標(biāo)識(shí)的二維碼，并傳遞給小程序端。
用戶掃碼：用戶使用微信或其他平臺(tái)的小程序掃描二維碼，小程序獲取登錄憑證并提交到服務(wù)器。
驗(yàn)證登錄：服務(wù)器驗(yàn)證憑證的有效性，完成用戶身份認(rèn)證，并返回登錄狀態(tài)。
跳轉(zhuǎn)登錄：網(wǎng)站檢測(cè)到登錄成功后，自動(dòng)跳轉(zhuǎn)到用戶主頁或指定頁面。

二、具體實(shí)現(xiàn)步驟

1. 準(zhǔn)備工作

確保WordPress網(wǎng)站已啟用REST API功能。
注冊(cè)并獲取小程序的AppID和AppSecret（以微信小程序?yàn)槔?/li>
服務(wù)器需支持HTTPS，以保證數(shù)據(jù)傳輸安全。

2. 生成登錄二維碼

在WordPress中，可以通過以下代碼生成一個(gè)臨時(shí)的登錄令牌，并生成對(duì)應(yīng)的二維碼：

function generate_login_qrcode() {
$token = wp_generate_password(32, false);
set_transient('wp_miniapp_login_' . $token, 'pending', 300); // 5分鐘有效期
$qrcode_url = 'https://api.qrserver.com/v1/create-qr-code/?size=150x150&data=' . urlencode(home_url('/miniapp-login?token=' . $token));
return $qrcode_url;
}

3. 小程序端處理掃碼

小程序掃碼后，調(diào)用微信登錄接口獲取code，并提交到WordPress服務(wù)器：

wx.login({
success(res) {
if (res.code) {
wx.request({
url: 'https://your-wordpress-site.com/wp-json/miniapp/v1/login',
method: 'POST',
data: { code: res.code, token: '掃描的token' },
success(res) {
console.log('登錄成功', res.data);
}
});
}
}
});

4. 服務(wù)器端驗(yàn)證

在WordPress中，通過REST API接收小程序提交的code和token，驗(yàn)證后完成登錄：

add_action('rest_api_init', function () {
register_rest_route('miniapp/v1', '/login', array(
'methods' => 'POST',
'callback' => 'handle_miniapp_login',
));
});

function handle_miniapp_login(WP_REST_Request $request) {
$code = $request->get_param('code');
$token = $request->get_param('token');

// 驗(yàn)證token是否有效
if (!get_transient('wp_miniapp_login_' . $token)) {
return new WP_Error('invalid_token', '二維碼已過期', array('status' => 400));
}

// 通過code獲取用戶openid（以微信為例）
$openid = get_miniapp_openid($code);
$user = get_user_by('login', $openid);

// 用戶不存在則創(chuàng)建
if (!$user) {
$user_id = wp_create_user($openid, wp_generate_password());
$user = get_user_by('id', $user_id);
}

// 登錄用戶
wp_set_auth_cookie($user->ID);
delete_transient('wp_miniapp_login_' . $token);

return array('status' => 'success');
}