php如何获取小程序openid_php通过code换openid法【教程】_技术教程

必须用后端发起HTTPS请求换取openid，传入appid、secret和前端获取的code，5分钟内有效；微信返回JSON格式，推荐cURL并设置超时和SSL验证，错误通过errcode判断，openid不可直接作长期用户ID，需映射业务表并注意session_key安全。

PHP 调用微信接口用 `code` 换取 `openid` 的正确姿势

不能直接靠前端传来的 code 就调微信接口——必须用后端发起 HTTPS 请求，且必须带上小程序的 appid、secret 和用户登录时前端获取的 code。微信校验的是服务端身份，不是前端请求来源。

code 是一次性临时凭证，5 分钟内有效，用完即失效
必须用服务端发起请求，前端 JS 直接调 https://api.weixin.qq.com/sns/jscode2session 会跨域失败，且暴露 secret
微信返回是 JSON，不是 HTML，别用 file_get_contents() 不加 header 就硬读（可能被重定向或返回空）
推荐用 cURL，显式设置 Content-Type: application/json 和 timeout，避免超时卡住

PHP cURL 请求示例与关键参数说明

下面是最简可用的代码片段，重点在参数拼接和错误处理：

function getOpenidByCode($appid, $secret, $js_code) {
    $url = 'https://api.weixin.qq.com/sns/jscode2session?' .
           'appid=' . urlencode($appid) .
           '&secret=' . urlencode($secret) .
           '&js_code=' . urlencode($js_code) .
           '&grant_type=authorization_code';

    $ch = curl_init();
    curl_setopt($ch, CURLOPT_URL, $url);
    curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
    curl_setopt($ch, CURLOPT_TIMEOUT, 10);
    curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); // 生产环境建议开启证书验证
    $response = curl_exec($ch);
    curl_close($ch);

    return json_decode($response, true);
}

// 使用示例：
$result = getOpenidByCode('wx1234567890abcdef', 'your_secret_here', $_POST['code']);
if (isset($result['openid'])) {
    echo $result['openid'];
} else {
    error_log('WeChat openid fail: ' . json_encode($result));
}

grant_type=authorization_code 是固定值，漏掉会返回 {"errcode":40029,"errmsg":"invalid code"}
urlencode() 必须对 $appid、$secret、$js_code 分别编码，否则含特殊字符（如 +）的 code 会导致签名失败
CURLOPT_SSL_VERIFYPEER 在测试环境可关，但上线前务必设为 true 并配好 CA 证书，否则有中间人风险

常见错误响应及对应排查点

微信不返回 HTTP 错误码，而是统一 200 + JSON body，所有异常都在

errcode 字段里：

{"errcode":40029,"errmsg":"invalid code"}：最常见——code 已过期 / 已使用过 / 前端传错字段名（比如传了 res.code 却没取值）
{"errcode":40125,"errmsg":"invalid appid"}：appid 和当前小程序不匹配，或填成了公众号的 appid
{"errcode":40126,"errmsg":"invalid secret"}：secret 复制错了（注意有没有前后空格），或在微信公众平台重置过但没更新代码
{"errcode":45011,"errmsg":"reach max api daily limit"}：该 appid 的每日调用量超限（免费额度约 10 万次/日，但新账号初始较低）