From 6a4de7e2b66a55a4011e7ef75c8f7b369b43fdbf Mon Sep 17 00:00:00 2001
From: pf7lbvaho <1851784367@qq.com>
Date: Sun, 29 Dec 2024 15:26:02 +0800
Subject: [PATCH] Update curl.lib.php

---
 core/curl.lib.php | 277 ++++++++++++++++++++++------------------------
 1 file changed, 134 insertions(+), 143 deletions(-)

diff --git a/core/curl.lib.php b/core/curl.lib.php
index b1d97dd..7e69355 100644
--- a/core/curl.lib.php
+++ b/core/curl.lib.php
@@ -1,228 +1,219 @@
 <?php
 namespace LaneWeChat\Core;
+
 /**
- * CURL工具类
- * 用于简化HTTP请求的发送，支持GET、POST等请求方法。
+ * CURL工具类，用于简化HTTP请求操作。
  * Class Curl
+ * Created by Lane.
+ * @Author: lane
+ * @Mail: lixuan868686@163.com
+ * @Date: 14-1-10
+ * @Time: 下午4:22
+ * Mail: lixuan868686@163.com
+ * Website: http://www.lanecn.com
  */
-class Curl {
-    private static $_ch; // 存储CURL会话句柄
-    private static $_header;// 存储响应头部信息
-    private static $_body;// 存储响应主体信息
-    
-    private static $_cookie = array();// 存储Cookie信息
-    private static $_options = array();// 存储额外的CURL选项
-    private static $_url = array ();// 存储URL信息
-    private static $_referer = array ();// 存储Referer信息
-
+class Curl
+{
+    // 私有静态变量，用于存储CURL会话句柄、头部、主体等信息
+    private static $_ch;
+    private static $_header;
+    private static $_body;
+
+    // 存储Cookie、选项、URL和Referer的数组
+    private static $_cookie = array();
+    private static $_options = array();
+    private static $_url = array();
+    private static $_referer = array();
 
     /**
-     * 调用外部URL
-     * 根据提供的参数，使用GET或POST方法发送请求，并返回结果。
-     * @param string $queryUrl 请求的URL地址
-     * @param mixed $param 发送的数据，可以是数组或字符串
+     * 调用外部URL，支持GET和POST请求。
+     * @param string $queryUrl 请求的URL
+     * @param array|string $param 参数
      * @param string $method 请求方法，默认为'get'
-     * @param bool $is_json 是否期望返回JSON格式的数据
-     * @param bool $is_urlcode 是否对参数进行URL编码
-     * @return bool|mixed 请求失败返回false，成功则返回解码后的数据或原始数据
+     * @return bool|mixed 返回请求结果或false
      */
-    public static function callWebServer($queryUrl, $param='', $method='get', $is_json=true, $is_urlcode=true) {
+    public static function callWebServer($queryUrl, $param = '', $method = 'get', $is_json = true, $is_urlcode = true)
+    {
+        // 检查URL是否为空
         if (empty($queryUrl)) {
-            return false;// 如果URL为空，则直接返回false
+            return false;
         }
+        // 转换方法为小写
         $method = strtolower($method);
         $ret = '';
+        // 确保参数是数组
         $param = empty($param) ? array() : $param;
+        // 初始化CURL会话
         self::_init();
-        // 根据请求方法，调用对应的私有方法发送请求
+        // 根据请求方法调用相应的私有方法
         if ($method == 'get') {
             $ret = self::_httpGet($queryUrl, $param);
-        } elseif($method == 'post') {
+        } elseif ($method == 'post') {
             $ret = self::_httpPost($queryUrl, $param, $is_urlcode);
         }
-        if(!empty($ret)){
-            if($is_json){
-                return json_decode($ret, true);// 如果期望返回JSON格式的数据，则对返回的数据进行JSON解码
-            }else{
-                return $ret;// 否则返回原始数据
+        // 如果有返回结果，根据参数决定是否解析为JSON
+        if (!empty($ret)) {
+            if ($is_json) {
+                return json_decode($ret, true);
+            } else {
+                return $ret;
             }
         }
-        return true;// 如果请求成功，则返回true
+        return false;
     }
 
     /**
      * 初始化CURL会话
-     * 创建一个新的CURL会话，并设置一些默认的CURL选项。
      */
-    private static function _init() {
+    private static function _init()
+    {
         self::$_ch = curl_init();
-
-        curl_setopt(self::$_ch, CURLOPT_HEADER, true);// 设置CURL选项，启用响应头和返回传输
+        // 设置CURL选项
+        curl_setopt(self::$_ch, CURLOPT_HEADER, true);
         curl_setopt(self::$_ch, CURLOPT_RETURNTRANSFER, true);
-    }   // 设置CURL选项，使每次请求都是新的连接
-    // curl_setopt(self::$_ch, CURLOPT_FRESH_CONNECT, true);
-
+    }
 
-     /**
+    /**
      * 设置CURL选项
-     * 允许用户自定义CURL会话的选项。
-     * @param array $optArray 包含选项的关联数组，其中'key'是CURL选项的常量，'value'是对应的值
+     * @param array $optArray 选项数组
      */
-    public static function setOption($optArray=array()) {
-        foreach($optArray as $opt) {
+    public static function setOption($optArray = array())
+    {
+        foreach ($optArray as $opt) {
             curl_setopt(self::$_ch, $opt['key'], $opt['value']);
-        } 
+        }
     }
-    
 
     /**
      * 关闭CURL会话
-     * 释放CURL会话占用的资源。
-     * @return bool 操作成功返回true
+     * @return bool
      */
-    private static function _close() {
-        if (is_resource(self::$_ch)) {  
-            curl_close(self::$_ch);  
+    private static function _close()
+    {
+        if (is_resource(self::$_ch)) {
+            curl_close(self::$_ch);
         }
-        
         return true;
     }
-    
 
     /**
      * 发送GET请求
-     * 构建并发送一个HTTP GET请求，并将响应返回。
-     * @param string $url 请求的URL地址
-     * @param array $query 请求参数数组
-     * @return string 请求的响应内容
+     * @param string $url 请求URL
+     * @param array $query 查询参数
+     * @return mixed 请求结果
      */
-    private static function _httpGet($url, $query=array()) {
-        if (!empty($query)) {  
-            $url .= (strpos($url, '?') === false) ? '?' : '&';  
-            $url .= is_array($query) ? http_build_query($query) : $query;  // 将数组参数转换为URL参数字符串
-        }  
-        // 设置CURL选项，指定请求的URL
+    private static function _httpGet($url, $query = array())
+    {
+        // 构建查询字符串
+        if (!empty($query)) {
+            $url .= (strpos($url, '?') === false) ? '?' : '&';
+            $url .= is_array($query) ? http_build_query($query) : $query;
+        }
+        // 设置CURL选项
         curl_setopt(self::$_ch, CURLOPT_URL, $url);
-        // 设置CURL选项，启用返回传输
         curl_setopt(self::$_ch, CURLOPT_RETURNTRANSFER, 1);
-        // 设置CURL选项，不返回响应头
         curl_setopt(self::$_ch, CURLOPT_HEADER, 0);
-        // 设置CURL选项，不验证SSL证书
-        curl_setopt(self::$_ch, CURLOPT_SSL_VERIFYPEER, FALSE);
-        curl_setopt(self::$_ch, CURLOPT_SSL_VERIFYHOST, FALSE);
-        // 设置CURL选项，设置SSL版本
+        // 禁用SSL证书验证
+        curl_setopt(self::$_ch, CURLOPT_SSL_VERIFYPEER, false);
+        curl_setopt(self::$_ch, CURLOPT_SSL_VERIFYHOST, false);
         curl_setopt(self::$_ch, CURLOPT_SSLVERSION, 1);
-
-         // 执行CURL请求并获取响应
+        // 执行请求并返回结果
         $ret = self::_execute();
-        self::_close();// 关闭CURL会话
-        return $ret;  
+        self::_close();
+        return $ret;
     }
-    
 
     /**
      * 发送POST请求
-     * 构建并发送一个HTTP POST请求，并将响应返回。
-     * @param string $url 请求的URL地址
-     * @param array $query 请求参数数组
-     * @param bool $is_urlcode 是否对参数进行URL编码
-     * @return string 请求的响应内容
+     * @param string $url 请求URL
+     * @param array $query 查询参数
+     * @param bool $is_urlcode 是否进行URL编码
+     * @return mixed 请求结果
      */
-    private static function _httpPost($url, $query=array(), $is_urlcode=true) {
-        // 如果参数是数组，则对每个参数进行URL编码
+    private static function _httpPost($url, $query = array(), $is_urlcode = true)
+    {
+        // 对参数进行URL编码
         if (is_array($query)) {
-            foreach ($query as $key => $val) {  
-                if($is_urlcode){
+            foreach ($query as $key => $val) {
+                if ($is_urlcode) {
                     $encode_key = urlencode($key);
-                }else{
+                } else {
                     $encode_key = $key;
                 }
-                if ($encode_key != $key) {  
-                    unset($query[$key]);  
+                if ($encode_key != $key) {
+                    unset($query[$key]);
                 }
-                if($is_urlcode){
+                if ($is_urlcode) {
                     $query[$encode_key] = urlencode($val);
-                }else{
+                } else {
                     $query[$encode_key] = $val;
                 }
-            }  
+            }
         }
-       // 设置CURL选项，指定请求的URL
-       curl_setopt(self::$_ch, CURLOPT_URL, $url);
-       // 设置CURL选项，启用返回传输
-       curl_setopt(self::$_ch, CURLOPT_RETURNTRANSFER, 1);
-       // 设置CURL选项，不返回响应头
-       curl_setopt(self::$_ch, CURLOPT_HEADER, 0);
-       // 设置CURL选项，启用POST请求
-       curl_setopt(self::$_ch, CURLOPT_POST, true );
-       // 设置CURL选项，指定POST请求的数据
-       curl_setopt(self::$_ch, CURLOPT_POSTFIELDS, $query);
-       // 设置CURL选项，不验证SSL证书
-       curl_setopt(self::$_ch, CURLOPT_SSL_VERIFYPEER, FALSE);
-       curl_setopt(self::$_ch, CURLOPT_SSL_VERIFYHOST, FALSE);
-       // 设置CURL选项，设置SSL版本
-       curl_setopt(self::$_ch, CURLOPT_SSLVERSION, 1);
-
-       // 执行CURL请求并获取响应
-       $ret = self::_execute();
-       // 关闭CURL会话
-       self::_close();
-       return $ret;  
+        // 设置CURL选项
+        curl_setopt(self::$_ch, CURLOPT_URL, $url);
+        curl_setopt(self::$_ch, CURLOPT_RETURNTRANSFER, 1);
+        curl_setopt(self::$_ch, CURLOPT_HEADER, 0);
+        curl_setopt(self::$_ch, CURLOPT_POST, true);
+        curl_setopt(self::$_ch, CURLOPT_POSTFIELDS, $query);
+        // 禁用SSL证书验证
+        curl_setopt(self::$_ch, CURLOPT_SSL_VERIFYPEER, false);
+        curl_setopt(self::$_ch, CURLOPT_SSL_VERIFYHOST, false);
+        curl_setopt(self::$_ch, CURLOPT_SSLVERSION, 1);
+        // 执行请求并返回结果
+        $ret = self::_execute();
+        self::_close();
+        return $ret;
     }
-    
 
-     /**
+    /**
      * 发送PUT请求
-     * 构建并发送一个HTTP PUT请求，并将响应返回。
-     * @param string $url 请求的URL地址
-     * @param array $query 请求参数数组
-     * @return string 请求的响应内容
+     * @param string $url 请求URL
+     * @param array $query 查询参数
+     * @return mixed 请求结果
      */
-    private static function _put($url, $query = array()) {
-        // 设置CURL选项，指定请求方法为PUT
-        curl_setopt(self::$_ch, CURLOPT_CUSTOMREQUEST, 'PUT');  
-        
+    private static function _put($url, $query = array())
+    {
+        curl_setopt(self::$_ch, CURLOPT_CUSTOMREQUEST, 'PUT');
         return self::_httpPost($url, $query);
-    }  
+    }
 
     /**
      * 发送DELETE请求
-     * 构建并发送一个HTTP DELETE请求，并将响应返回。
-     * @param string $url 请求的URL地址
-     * @param array $query 请求参数数组
-     * @return string 请求的响应内容
+     * @param string $url 请求URL
+     * @param array $query 查询参数
+     * @return mixed 请求结果
      */
-    private static function _delete($url, $query = array()) {
-        // 设置CURL选项，指定请求方法为DELETE
-        curl_setopt(self::$_ch, CURLOPT_CUSTOMREQUEST, 'DELETE');  
-        
+    private static function _delete($url, $query = array())
+    {
+        curl_setopt(self::$_ch, CURLOPT_CUSTOMREQUEST, 'DELETE');
         return self::_httpPost($url, $query);
-    }  
-
+    }
 
     /**
      * 发送HEAD请求
-     * 构建并发送一个HTTP HEAD请求，并将响应返回。
-     * @param string $url 请求的URL地址
-     * @param array $query 请求参数数组
-     * @return string 请求的响应内容
+     * @param string $url 请求URL
+     * @param array $query 查询参数
+     * @return mixed 请求结果
      */
-    private static function _head($url, $query = array()) {
-        // 设置CURL选项，指定请求方法为HEAD
+    private static function _head($url, $query = array())
+    {
         curl_setopt(self::$_ch, CURLOPT_CUSTOMREQUEST, 'HEAD');
-        
         return self::_httpPost($url, $query);
-    }  
-    
-    private static function _execute() {
+    }
+
+    /**
+     * 执行CURL请求
+     * @return mixed 请求结果
+     */
+    private static function _execute()
+    {
         $response = curl_exec(self::$_ch);
         $errno = curl_errno(self::$_ch);
-
+        // 如果发生错误，抛出异常
         if ($errno > 0) {
             throw new \Exception(curl_error(self::$_ch), $errno);
         }
-        return  $response;
+        return $response;
     }
-}
-    //  执行CURL请求
-    //  执行CURL会话
+}
\ No newline at end of file