From a6412026827bfd72facca2d440623e4fe0679db1 Mon Sep 17 00:00:00 2001
From: p9x75mskn <3278354422@qq.com>
Date: Mon, 30 Dec 2024 09:10:14 +0800
Subject: [PATCH] Update wechatoauth.lib.php

---
 core/wechatoauth.lib.php | 52 ++++++++++++++++++++++++++++------------
 1 file changed, 37 insertions(+), 15 deletions(-)

diff --git a/core/wechatoauth.lib.php b/core/wechatoauth.lib.php
index 1991690..4e4f8e6 100644
--- a/core/wechatoauth.lib.php
+++ b/core/wechatoauth.lib.php
@@ -1,47 +1,69 @@
+
 <?php
 namespace LaneWeChat\Core;
+// WeChatOAuth类用于处理微信OAuth认证流程。
 class WeChatOAuth{
-        public static function getCode($redirect_uri, $state=1, $scope='snsapi_base'){
+    // getCode静态方法用于生成用户授权的URL，并重定向用户到微信授权页面。
+    public static function getCode($redirect_uri, $state=1, $scope='snsapi_base'){
+        // 如果redirect_uri以'/'开头，则去掉它。
         if($redirect_uri[0] == '/'){
             $redirect_uri = substr($redirect_uri, 1);
         }
         
+        // 从配置中获取appid。
         $appid = WECHAT_APPID;
-       
+        
+        // 将redirect_uri添加到WECHAT_URL后进行URL编码。
         $redirect_uri = WECHAT_URL . $redirect_uri;
         $redirect_uri = urlencode($redirect_uri);
         
+        // 设置response_type为code，表示期望的响应类型是授权码。
         $response_type = 'code';
         
-        $url = 'https://open.weixin.qq.com/connect/oauth2/authorize?appid='.$appid.'&redirect_uri='.$redirect_uri.'&response_type='.$response_type.'&scope='.$scope.'&state='.$state.'#wechat_redirect';
-        header('Location: '.$url, true, 301);
+        // 构造微信授权URL。
+        $url = 'https://open.weixin.qq.com/connect/oauth2/authorize?appid=' . $appid . '&redirect_uri=' . $redirect_uri . '&response_type=' . $response_type . '&scope=' . $scope . '&state=' . $state . '#wechat_redirect'; 
+        // 发送HTTP重定向响应到微信授权URL。
+        header('Location: ' . $url, true, 301);
     }
 
-
-        public static function getAccessTokenAndOpenId($code){
+    // getAccessTokenAndOpenId静态方法用于通过授权码获取access_token和openid。
+    public static function getAccessTokenAndOpenId($code){
         
+        // 设置grant_type为authorization_code，表示使用授权码换取access_token。
         $grant_type = 'authorization_code';
-       
-        $url = 'https://api.weixin.qq.com/sns/oauth2/access_token?appid='.WECHAT_APPID.'&secret='.WECHAT_APPSECRET.'&code='.$code.'&grant_type='.$grant_type.'';
         
+        // 构造获取access_token的URL。
+        $url = 'https://api.weixin.qq.com/sns/oauth2/access_token?appid=' . WECHAT_APPID . '&secret=' . WECHAT_APPSECRET . '&code=' . $code . '&grant_type=' . $grant_type; 
+        
+        // 调用Curl类的方法发送请求并获取结果。
         return Curl::callWebServer($url);
     }
 
-        public static function refreshToken($refreshToken){
-        $queryUrl = 'https://api.weixin.qq.com/sns/oauth2/refresh_token?appid='.WECHAT_APPID.'&grant_type=refresh_token&refresh_token='.$refreshToken;
+    // refreshToken静态方法用于刷新access_token。
+    public static function refreshToken($refreshToken){
+        // 构造刷新access_token的URL。
+        $queryUrl = 'https://api.weixin.qq.com/sns/oauth2/refresh_token?appid=' . WECHAT_APPID . '&grant_type=refresh_token&refresh_token=' . $refreshToken; 
         $queryAction = 'GET';
+        // 调用Curl类的方法发送请求并获取结果。
         return Curl::callWebServer($queryUrl, '', $queryAction);
     }
 
-        public static function getUserInfo($accessToken, $openId, $lang='zh_CN'){
-        $queryUrl = 'https://api.weixin.qq.com/sns/userinfo?access_token='. $accessToken . '&openid='. $openId .'&lang=zh_CN';
+    // getUserInfo静态方法用于获取用户信息。
+    public static function getUserInfo($accessToken, $openId, $lang='zh_CN'){
+        // 构造获取用户信息的URL。
+        $queryUrl = 'https://api.weixin.qq.com/sns/userinfo?access_token=' . $accessToken . '&openid=' . $openId . '&lang=' . $lang;
         $queryAction = 'GET';
+        // 调用Curl类的方法发送请求并获取结果。
         return Curl::callWebServer($queryUrl, '', $queryAction);
     }
 
-       public static function checkAccessToken($accessToken, $openId){
-        $queryUrl = 'https://api.weixin.qq.com/sns/auth?access_token='.$accessToken.'&openid='.$openId;
+    // checkAccessToken静态方法用于检查access_token是否有效。
+    public static function checkAccessToken($accessToken, $openId){
+        // 构造检查access_token的URL。
+        $queryUrl = 'https://api.weixin.qq.com/sns/auth?access_token=' . $accessToken . '&openid=' . $openId; 
         $queryAction = 'GET';
+        // 调用Curl类的方法发送请求并获取结果。
         return Curl::callWebServer($queryUrl, '', $queryAction);
     }
-}
\ No newline at end of file
+}
+