分享封装的一个PHP微信支付的类库(扫码、H5、小程序)
php微信支付类传参直接使用(扫码、H5、小程序)
在我们编写相关支付的时候,经常会使用微信支付,
在php中使用微信支付还是比较简单的,
微信支付文档:https://pay.weixin.qq.com/wiki/doc/api/index.html
这里简单介绍微信支付的几种使用,
这里微信支付我封装了一个微信支付的类库,
直接传递参数就可使用:
首先把配置文件填写完整(细心不要填错,否则会导致签名错误):
$config = array( 'appid' => '', // 微信支付appid 'xcxappid' => '', // 微信小程序appid 'mch_id' => '', // 微信支付 mch_id 商户收款账号 'key' => '', // 微信支付key 'appsecret' => '', // 公众帐号secert(公众号支付专用) 'notify_url' => '', // 接收支付状态的连接 改成自己的回调地址 'redirect_uri' => '', // 公众号支付时,没有code,获取openid使用 );
对于相关支付我也也成了函数便于使用,
微信扫码支付:
/** * [qrcodePay 微信扫码支付] * @param [type] $order [订单信息数组] * @return [type] [description] * $order = array( * 'body' => '', // 产品描述 * 'total_fee' => '', // 订单金额(分) * 'out_trade_no' => '', // 订单编号 * 'product_id' => '', // 产品id(可用订单编号) * ); */ public static function qrcodePay($order=NULL) { if(!is_array($order) || count($order) < 4){ die("数组数据信息缺失!"); } $order['trade_type'] = 'NATIVE'; // Native支付 $result = self::unifiedOrder($order); $decodeurl = urldecode($result['code_url']); return $decodeurl; // 使用返回链接直接生成二维码 }
微信H5支付:
/** * [weixinH5 微信H5支付] * @param [type] $order [订单信息数组] * @return [type] [description] * $order = array( * 'body' => '', // 产品描述 * 'total_fee' => '', // 订单金额(分) * 'out_trade_no' => '', // 订单编号 * 'product_id' => '', // 产品id(可用订单编号) * ); */ public static function h5Pay($order=NULL) { if(!is_array($order) || count($order) < 4){ die("数组数据信息缺失!"); } $order['trade_type'] = 'MWEB'; // H5支付 $result = self::unifiedOrder($order); if ($result['return_code']=='SUCCESS' && $result['result_code']=='SUCCESS') return $result['mweb_url']; // 返回链接让用户点击跳转 if ($result['err_code_des']) die($result['err_code_des']); return false; }
微信小程序支付:
/** * [xcxPay 获取jssdk需要用到的数据] * @param [type] $order [订单信息数组] * @param boolean $type [区分是否是小程序,默认 true] * @return [type] [description] * $order = array( * 'body' => '', // 产品描述 * 'total_fee' => '', // 订单金额(分) * 'out_trade_no' => '', // 订单编号 * 'product_id' => '', // 产品id(可用订单编号) * 'openid' => '', // 用户openid * ); */ public static function xcxPay($order=NULL,$type=true) { if(!is_array($order) || count($order) < 5){ die("数组数据信息缺失!"); } $order['trade_type'] = 'JSAPI'; // 小程序支付 $result = self::unifiedOrder($order,$type); if ($result['return_code']=='SUCCESS' && $result['result_code']=='SUCCESS') { $data = array ( 'appId' => $type ? $this->config['xcxappid'] : $this->config['appid'], 'timeStamp' => time(), 'nonceStr' => self::get_rand_str(32, 0, 1), // 随机32位字符串 'package' => 'prepay_id='.$result['prepay_id'], 'signType' => 'MD5', // 加密方式 ); $data['paySign'] = self::makeSign($data); return $data; // 数据小程序客户端 } else { if ($result['err_code_des']) die($result['err_code_des']); return false; } }
使用方法(这里已小程序支付为示例):
<?php include './WeixinPay.php'; $get = $_GET; $weixinpay = new fengWeixinPay($config); $order_sn = time().rand(1000,9999); $order = array( 'body' => '测试商品', // 产品描述 'total_fee' => '1', // 订单金额(分) 'out_trade_no' => $order_sn, // 订单编号 'product_id' => $order_sn, // 产品id(可用订单编号) 'openid' => $get['openid'], // 用户openid ); $re = $weixinpay->xcxPay($order); die(json_encode($re)); // JSON化直接返回小程序客户端
如下代码是封装好的完整支付类文件(WeixinPay.php),
可以根据自己需求随意修改(不定期修改完善 Gitee 与 GitHub):
<?php /** * @Author: [FENG] <1161634940@qq.com> * @Date: 2019-09-06 09:50:30 * @Last Modified by: [FENG] <1161634940@qq.com> * @Last Modified time: 2020-10-08T17:33:39+08:00 */ namespace feng; error_reporting(E_ALL); ini_set('display_errors', '1'); // 定义时区 ini_set('date.timezone','Asia/Shanghai'); class WeixinPay { // 定义相关配置项 private static $sslcert_path = './cert/apiclient_cert.pem'; // 证书(退款时使用) private static $sslkey_path = './cert/apiclient_key.pem'; // 证书(退款时使用) private static $referer = ''; private static $config = array( 'appid' => '', // 微信支付appid 'xcxappid' => '', // 微信小程序appid 'mch_id' => '', // 微信支付 mch_id 商户收款账号 'key' => '', // 微信支付key 'appsecret' => '', // 公众帐号secert(公众号支付专用) 'notify_url' => '', // 接收支付状态的连接 改成自己的回调地址 'redirect_uri' => '', // 公众号支付时,没有code,获取openid使用 ); /** * [__construct 构造函数] * @param [type] $config [传递微信支付相关配置] */ public function __construct($config=NULL, $referer=NULL){ $config && self::$config = $config; self::$referer = $referer ? $referer : $_SERVER['HTTP_HOST']; } /** * [unifiedOrder 统一下单] * @param [type] $order [订单信息(必须包含支付所需要的参数)] * @param boolean $type [区分是否是小程序,是则传 true] * @return [type] [description] * $order = array( * 'body' => '', // 产品描述 * 'total_fee' => '', // 订单金额(分) * 'out_trade_no' => '', // 订单编号 * 'product_id' => '', // 产品id * 'trade_type' => '', // 类型:JSAPI--JSAPI支付(或小程序支付)、NATIVE--Native支付、APP--app支付,MWEB--H5支付 * ); */ public static function unifiedOrder($order, $type=NULL) { $weixinpay_config = array_filter(self::$config); // 获取配置项 $config = array( 'appid' => empty($type) ? $weixinpay_config['appid'] : $weixinpay_config['xcxappid'], 'mch_id' => $weixinpay_config['mch_id'], 'nonce_str' => 'test', 'spbill_create_ip' => self::get_iP(), 'notify_url' => $weixinpay_config['notify_url'] ); $data = array_merge($order, $config); // 合并配置数据和订单数据 $sign = self::makeSign($data); // 生成签名 $data['sign'] = $sign; $xml = self::array_to_xml($data); $url = 'https://api.mch.weixin.qq.com/pay/unifiedorder';//接收xml数据的文件 $header[] = "Content-type: text/xml";//定义content-type为xml,注意是数组 $ch = curl_init ($url); curl_setopt($ch, CURLOPT_URL, $url); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false); // 兼容本地没有指定curl.cainfo路径的错误 curl_setopt($ch, CURLOPT_REFERER, self::$referer); //设置 referer curl_setopt($ch, CURLOPT_HTTPHEADER, $header); curl_setopt($ch, CURLOPT_POST, 1); curl_setopt($ch, CURLOPT_POSTFIELDS, $xml); $response = curl_exec($ch); if(curl_errno($ch)){ die(curl_error($ch)); // 显示报错信息;终止继续执行 } curl_close($ch); $result = self::xml_to_array($response); if ($result['return_code']=='FAIL') die($result['return_msg']); // 显示错误信息 if ($result['result_code']=='FAIL') die($result['err_code_des']); // 显示错误信息 $result['sign'] = $sign; $result['nonce_str'] = 'test'; return $result; } /** * [qrcodePay 微信扫码支付] * @param [type] $order [订单信息数组] * @return [type] [description] * $order = array( * 'body' => '', // 产品描述 * 'total_fee' => '', // 订单金额(分) * 'out_trade_no' => '', // 订单编号 * 'product_id' => '', // 产品id(可用订单编号) * ); */ public static function qrcodePay($order=NULL) { if(!is_array($order) || count($order) < 4){ die("数组数据信息缺失!"); } $order['trade_type'] = 'NATIVE'; // Native支付 $result = self::unifiedOrder($order); $decodeurl = urldecode($result['code_url']); return $decodeurl; // qrcode($decodeurl); // qrcodeWithPicture($decodeurl); } /** * [jsPay 获取jssdk需要用到的数据] * @param [type] $order [订单信息数组] * @return [type] [description] * $order = array( * 'body' => '', // 产品描述 * 'total_fee' => '', // 订单金额(分) * 'out_trade_no' => '', // 订单编号 * 'product_id' => '', // 产品id(可用订单编号) * ); */ public static function jsPay($order=NULL,$code=NULL){ $config=self::$config; if (!is_array($order) || count($order) < 4) die("数组数据信息缺失!"); if (count($order) == 5) { $data = self::xcxPay($order, false); // 获取支付相关信息(获取非小程序信息) return $data; } empty($code) && $code = $_GET['code']; // 如果没有get参数没有code;则重定向去获取openid; if (empty($code)) { $out_trade_no = $order['out_trade_no']; // 获取订单号 $redirect_uri = $config['redirect_uri']; // 返回的url $redirect_uri = urlencode($redirect_uri); $url = 'https://open.weixin.qq.com/connect/oauth2/authorize?appid='.$config['appid'].'&redirect_uri='.$redirect_uri.'&response_type=code&scope=snsapi_base&state='.$out_trade_no.'#wechat_redirect'; header('Location: '.$url); } else { // 组合获取prepay_id的url $url = 'https://api.weixin.qq.com/sns/oauth2/access_token?appid='.$config['appid'].'&secret='.$config['appsecret'].'&code='.$code.'&grant_type=authorization_code'; $result = self::curl_get_contents($url); // curl获取prepay_id $result = json_decode($result,true); $order['openid'] = $result['openid']; // 获取到的openid $data = self::xcxPay($order, false); // 获取支付相关信息(获取非小程序信息) return $data; } } /** * [xcxPay 获取jssdk需要用到的数据] * @param [type] $order [订单信息数组] * @param boolean $type [区分是否是小程序,默认 true] * @return [type] [description] * $order = array( * 'body' => '', // 产品描述 * 'total_fee' => '', // 订单金额(分) * 'out_trade_no' => '', // 订单编号 * 'product_id' => '', // 产品id(可用订单编号) * 'openid' => '', // 用户openid * ); */ public static function xcxPay($order=NULL,$type=true) { if(!is_array($order) || count($order) < 5){ die("数组数据信息缺失!"); } $order['trade_type'] = 'JSAPI'; // 小程序支付 $result = self::unifiedOrder($order,$type); if ($result['return_code']=='SUCCESS' && $result['result_code']=='SUCCESS') { $data = array ( 'appId' => $type ? self::$config['xcxappid'] : self::$config['appid'], 'timeStamp' => (string)time(), 'nonceStr' => self::get_rand_str(32, 0, 1), // 随机32位字符串 'package' => 'prepay_id='.$result['prepay_id'], 'signType' => 'MD5', // 加密方式 ); $data['paySign'] = self::makeSign($data); return $data; // 数据小程序客户端 } else { if ($result['err_code_des']) die($result['err_code_des']); return false; } } /** * [weixinH5 微信H5支付] * @param [type] $order [订单信息数组] * @return [type] [description] * $order = array( * 'body' => '', // 产品描述 * 'total_fee' => '', // 订单金额(分) * 'out_trade_no' => '', // 订单编号 * 'product_id' => '', // 产品id(可用订单编号) * ); */ public static function h5Pay($order=NULL) { if(!is_array($order) || count($order) < 4){ die("数组数据信息缺失!"); } $order['trade_type'] = 'MWEB'; // H5支付 $result = self::unifiedOrder($order); if ($result['return_code']=='SUCCESS' && $result['result_code']=='SUCCESS') return $result['mweb_url']; // 返回链接让用户点击跳转 if ($result['err_code_des']) die($result['err_code_des']); return false; } /** * [Refund 微信支付退款] * @param [type] $order [订单信息] * @param [type] $type [是否是小程序] * $order = array( * 'body' => '', // 退款原因 * 'total_fee' => '', // 商品价格(分) * 'out_trade_no' => '', // 订单编号 * 'transaction_id'=> '', // 微信订单号 * ); */ public static function Refund($order, $type=NULL) { $config = self::$config; $data = array( 'appid' => empty($type) ? $config['appid'] : $config['xcxappid'] , 'mch_id' => $config['mch_id'], 'nonce_str' => 'test', 'total_fee' => $order['total_fee'], //订单金额 单位 转为分 'refund_fee' => $order['total_fee'], //退款金额 单位 转为分 'sign_type' => 'MD5', //签名类型 支持HMAC-SHA256和MD5,默认为MD5 'transaction_id'=> $order['transaction_id'], //微信订单号 'out_trade_no' => $order['out_trade_no'], //商户订单号 'out_refund_no' => $order['out_trade_no'], //商户退款单号 'refund_desc' => $order['body'], //退款原因(选填) ); // $unified['sign'] = self::makeSign($unified, $config['KEY']); $sign = self::makeSign($data); $data['sign'] = $sign; $xml = self::array_to_xml($data); $url = 'https://api.mch.weixin.qq.com/secapi/pay/refund';//接收xml数据的文件 $response = self::postXmlSSLCurl($xml,$url); $result = self::xml_to_array($response); // 显示错误信息 if ($result['return_code']=='FAIL') { die($result['return_msg']); } $result['sign'] = $sign; $result['nonce_str'] = 'test'; return $result; } /** * [notify 回调验证] * @return [array] [返回数组格式的notify数据] */ public static function notify() { $xml = file_get_contents('php://input', 'r'); // 获取xml if (!$xml) die('暂无回调信息'); $data = self::xml_to_array($xml); // 转成php数组 $data_sign = $data['sign']; // 保存原sign unset($data['sign']); // sign不参与签名 $sign = self::makeSign($data); // 判断签名是否正确 判断支付状态 if ($sign===$data_sign && $data['return_code']=='SUCCESS' && $data['result_code']=='SUCCESS') { $result=$data; }else{ $result=false; } // 返回状态给微信服务器 if ($result) { $str='<xml><return_code><![CDATA[SUCCESS]]></return_code><return_msg><![CDATA[OK]]></return_msg></xml>'; }else{ $str='<xml><return_code><![CDATA[FAIL]]></return_code><return_msg><![CDATA[签名失败]]></return_msg></xml>'; } echo $str; return $result; } /** * [makeSign 生成签名] * 本方法不覆盖sign成员变量,如要设置签名需要调用SetSign方法赋值 * @param [type] $data [description] * @return [type] [description] */ public static function makeSign($data) { // 去空 $data = array_filter($data); //签名步骤一:按字典序排序参数 ksort($data); $string_a = http_build_query($data); $string_a = urldecode($string_a); //签名步骤二:在string后加入key $config = self::$config; $string_sign_temp = $string_a."&key=".$config['key']; //签名步骤三:MD5加密 $sign = md5($string_sign_temp); // 签名步骤四:所有字符转为大写 $result = strtoupper($sign); return $result; } /** * [xml_to_array 将xml转为array] * @param [type] $xml [xml字符串] * @return [type] [转换得到的数组] */ public static function xml_to_array($xml) { //禁止引用外部xml实体 libxml_disable_entity_loader(true); $result = json_decode(json_encode(simplexml_load_string($xml, 'SimpleXMLElement', LIBXML_NOCDATA)), true); return $result; } /** * [array_to_xml 输出xml字符] * @param [type] $data [description] * @return [type] [description] */ public static function array_to_xml($data) { if(!is_array($data) || count($data) <= 0){ die("数组数据异常!"); } $xml = "<xml>"; foreach ($data as $key=>$val){ if (is_numeric($val)){ $xml .= "<".$key.">".$val."</".$key.">"; }else{ $xml .= "<".$key."><![CDATA[".$val."]]></".$key.">"; } } $xml .= "</xml>"; return $xml; } /** * [curl_get_contents get请求] * @param [type] $url [请求地址] * @return [type] [description] */ public static function curl_get_contents($url) { $ch = curl_init(); curl_setopt($ch, CURLOPT_URL, $url); //设置访问的url地址 // curl_setopt($ch,CURLOPT_HEADER,1); //是否显示头部信息 curl_setopt($ch, CURLOPT_TIMEOUT, 5); //设置超时 curl_setopt($ch, CURLOPT_USERAGENT, $_SERVER['HTTP_USER_AGENT']); //用户访问代理 User-Agent curl_setopt($ch, CURLOPT_REFERER, self::$referer); //设置 referer curl_setopt($ch, CURLOPT_FOLLOWLOCATION, 1); //跟踪301 curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1); //返回结果 $r=curl_exec($ch); curl_close($ch); return $r; } /** * [postXmlSSLCurl 需要使用证书的请求] * @param [type] $xml [xml数据] * @param [type] $url [post请求地址] * @param integer $second [description] * @return [type] [description] */ public static function postXmlSSLCurl($xml,$url,$second=30) { $ch = curl_init(); //超时时间 curl_setopt($ch,CURLOPT_TIMEOUT,$second); //这里设置代理,如果有的话 //curl_setopt($ch,CURLOPT_PROXY, '8.8.8.8'); //curl_setopt($ch,CURLOPT_PROXYPORT, 8080); curl_setopt($ch,CURLOPT_URL, $url); curl_setopt($ch,CURLOPT_SSL_VERIFYPEER,FALSE); curl_setopt($ch,CURLOPT_SSL_VERIFYHOST,FALSE); //设置header curl_setopt($ch,CURLOPT_HEADER,FALSE); //要求结果为字符串且输出到屏幕上 curl_setopt($ch,CURLOPT_RETURNTRANSFER,TRUE); //设置证书 //使用证书:cert 与 key 分别属于两个.pem文件 //默认格式为PEM,可以注释 curl_setopt($ch,CURLOPT_SSLCERTTYPE,'PEM'); curl_setopt($ch,CURLOPT_SSLCERT, self::$sslcert_path); //默认格式为PEM,可以注释 curl_setopt($ch,CURLOPT_SSLKEYTYPE,'PEM'); curl_setopt($ch,CURLOPT_SSLKEY, self::$sslkey_path); //post提交方式 curl_setopt($ch,CURLOPT_POST, true); curl_setopt($ch,CURLOPT_POSTFIELDS,$xml); $data = curl_exec($ch); //返回结果 if($data){ curl_close($ch); return $data; } else { $error = curl_errno($ch); echo "curl出错,错误码:$error"."<br>"; curl_close($ch); return false; } } /** fengkui.net * [get_rand_str 获取随机字符串] * @param integer $randLength [长度] * @param integer $addtime [是否加入当前时间戳] * @param integer $includenumber [是否包含数字] * @return [type] [description] */ public static function get_rand_str($randLength=6,$addtime=1,$includenumber=0) { if ($includenumber) $chars='abcdefghijklmnopqrstuvwxyzABCDEFGHJKLMNPQEST123456789'; $chars='abcdefghijklmnopqrstuvwxyz'; $len=strlen($chars); $randStr=''; for ($i=0;$i<$randLength;$i++){ $randStr .= $chars[rand(0,$len-1)]; } $tokenvalue = $randStr; $addtime && $tokenvalue=$randStr.time(); return $tokenvalue; } /** fengkui.net * [get_iP 定义一个函数get_iP() 客户端IP] * @return [type] [description] */ public static function get_iP() { if (getenv("HTTP_CLIENT_IP")) $ip = getenv("HTTP_CLIENT_IP"); else if(getenv("HTTP_X_FORWARDED_FOR")) $ip = getenv("HTTP_X_FORWARDED_FOR"); else if(getenv("REMOTE_ADDR")) $ip = getenv("REMOTE_ADDR"); else $ip = "Unknow"; if(preg_match('/^((?:(?:25[0-5]|2[0-4]d|((1d{2})|([1-9]?d))).){3}(?:25[0-5]|2[0-4]d|((1d{2})|([1 -9]?d))))$/', $ip)) return $ip; else return ''; } }