微信支付PHP SDK ―― 公众号支付代码详解

5年以前 | 阅读数：1139 次 | 编程语言：PHP

在微信支付开发者文档页面下载最新的 php SDK

http://mch.weixin.qq.com/wiki/doc/api/jsapi.php?chapter=11_1

这里假设你已经申请完微信支付

1. 微信后台配置如图

我们先进行测试，所以先把测试授权目录和测试白名单添加上。测试授权目录是你要发起微信请求的哪个文件所在的目录。

例如jsapi 发起请求一般是jsapi.php所在目录为测试目录，测试白名单即开发人员的微信号。

正式的支付授权目录不能和测试的一样否则会报错。不填写或者填错授权目录以及测试白名单都会报错。

报错样例：

NaNsystem:access_denied

不在测试白名单

2. 配置 lib/WxPay.Config.php文件

最主要配置一下四项：

const APPID = '';
const MCHID = '';
const KEY = '';
const APPSECRET = '';

APPID 和 APPSECRET都可以在微信后台中找到。
MCHID 在申请微信支付后发来的邮件中可以找到，KEY 则根据邮件提示

去商户平台配置即可。

3. 访问起始 index.php

首先访问 index.php 你可以看到界面

我们首先需要的是 JSAPI支付。但是看代码 index.php 最下面的链接。他默认是个demo的链接，改为我们自定义的即可

当然你也可以直接写死为自己的访问链接。

4. JSAPI 支付

必要代码解析：

$logHandler= new CLogFileHandler("../logs/".date('Y-m-d').'.log');
$log = Log::Init($logHandler, 15);

调用日志类可以通过 $log->DEBUG('test'); 打印调试信息。其实也可以直接使用 $Log::DEBUG('test'); 来调试

$tools = new JsApiPay();
$openId = $tools->GetOpenid();

主要是为了获取 openid 其中GetOpenid() 函数定义在文件 WxPay.JsApiPay.php 文件中


    public function GetOpenid()
     {
     //通过code获得openid
     if (!isset($_GET['code'])){
      //触发微信返回code码
      $baseUrl = urlencode('http://'.$_SERVER['HTTP_HOST'].$_SERVER['PHP_SELF'].$_SERVER['QUERY_STRING']);
      $url = $this->__CreateOauthUrlForCode($baseUrl);
      Header("Location: $url");
      exit();
     } else {
      //获取code码，以获取openid
       $code = $_GET['code'];
      $openid = $this->getOpenidFromMp($code);
      return $openid;
     }
     }

$baseUrl 其实就是为了在跳转回来这个页面。可以继续跟踪函数__CreateOauthUrlForCode() 其实就是通过微信的Auth2.0 来获取Openid
参考链接：http://mp.weixin.qq.com/wiki/17/c0f37d5704f0b64713d5d2c37b468d75.html

这就需要你把微信的网页授权接口也设置好。


    获取到 Openid 就可以调用微信支付的统一下单接口了。回到 文件 jsapi.php 如下代码
    $input = new WxPayUnifiedOrder();
    $input->SetBody("test");
    $input->SetAttach("test");
    $input->SetOut_trade_no(WxPayConfig::MCHID.date("YmdHis"));
    $input->SetTotal_fee("1");
    $input->SetTime_start(date("YmdHis"));
    $input->SetTime_expire(date("YmdHis", time() + 600));
    $input->SetGoods_tag("test");
    $input->SetNotify_url("http://paysdk.weixin.qq.com/example/notify.php");
    $input->SetTrade_type("JSAPI");
    $input->SetOpenid($openId);
    $order = WxPayApi::unifiedOrder($input);
    echo '<font color="#f00"><b>统一下单支付单信息</b></font><br/>';
    printf_info($order);
    $jsApiParameters = $tools->GetJsApiParameters($order);

这里面的代码：

$input->SetAttach("test");

如果把值改为 $input->SetAttach("test this is attach");就会存在bug 后面再说，其实这个参数不是必须的干脆可以去掉。
代码：

$input->SetNotify_url("http://paysdk.weixin.qq.com/example/notify.php");

是设置接收支付结果通知的Url 这里是默认的demo 链接我们可以设置成我们的：

$input->SetNotify_url(dirname('http://'.$_SERVER['HTTP_HOST'].$_SERVER['REQUEST_URI']).'/notify.php');

当然你也可以选择直接写死。

其中的函数 unifiedOrder($input) 可以到WxPay.Api.php 中文件跟踪，其实就是调用统一下单接口。

在 WxPay.Api.php 中需要更改的一处代码是：


    //异步通知url未设置，则使用配置文件中的url
        if(!$inputObj->IsNotify_urlSet()){
          $inputObj->SetNotify_url(WxPayConfig::NOTIFY_URL);//异步通知url
        }

就是当没设置 notifyUrl 的时候回去配置文件中找，但是配置文件中根本没有设置。

所以你可以选择在配置文件WxPay.Config.php 中加上这个配置，也可以直接写一个默认的notify链接。

函数 GetJsApiParameters() 是获取jsApi支付的参数给变量 $jsApiParameters 方便在下面的Js中调用

jsapi.php 中js的代码：


    function jsApiCall()
     {
     WeixinJSBridge.invoke(
      'getBrandWCPayRequest',
      <?php echo $jsApiParameters; ?>,
      function(res){
      WeixinJSBridge.log(res.err_msg);
      alert(res.err_code+res.err_desc+res.err_msg);
      }
     );
     }

     function callpay()
     {
     if (typeof WeixinJSBridge == "undefined"){
       if( document.addEventListener ){
         document.addEventListener('WeixinJSBridgeReady', jsApiCall, false);
       }else if (document.attachEvent){
         document.attachEvent('WeixinJSBridgeReady', jsApiCall); 
         document.attachEvent('onWeixinJSBridgeReady', jsApiCall);
       }
     }else{
       jsApiCall();
     }
     }

其中点击立即支付按钮调用的就是 callpay() 函数，他有会调用jsApiCall() 函数打开支付程序。
此后输入密码完成支付。

在完成支付页面点击完成会回到这个支付页面，并弹出支付成功的提示框

这个其实就是 js函数 jsApiCall 里面的alter 弹出的对话框

其中 res.err_msg 为get_brand_wcpay_request:ok 表明前端判断的支付成功，我们可以根据这个将支付跳转到成功页面。

但是这个并不可信。确认是否支付成功还是应当通过notify.php 处理业务逻辑。

5. 支付结果通知 notify.php

其实这个页面最主要的代码就两行

$notify = new PayNotifyCallBack();
$notify->Handle(false);

其中大部分逻辑在 Handle 函数中处理文件 WxPay.Notify.php


    final public function Handle($needSign = true)
     {
     $msg = "OK";
     //当返回false的时候，表示notify中调用NotifyCallBack回调失败获取签名校验失败，此时直接回复失败
     $result = WxpayApi::notify(array($this, 'NotifyCallBack'), $msg);
     if($result == false){
      $this->SetReturn_code("FAIL");
      $this->SetReturn_msg($msg);
      $this->ReplyNotify(false);
      return;
     } else {
      //该分支在成功回调到NotifyCallBack方法，处理完成之后流程
      $this->SetReturn_code("SUCCESS");
      $this->SetReturn_msg("OK");
     }
     $this->ReplyNotify($needSign);
     }

主要代码：


    $result = WxpayApi::notify(array($this, 'NotifyCallBack'), $msg);
    //跟踪函数 notify 文件WxPay.Api.php
    public static function notify($callback, &$msg)
     {
     //获取通知的数据
     $xml = $GLOBALS['HTTP_RAW_POST_DATA'];
     //如果返回成功则验证签名
     try {
      $result = WxPayResults::Init($xml);
     } catch (WxPayException $e){
      $msg = $e->errorMessage();
      return false;
     }

     return call_user_func($callback, $result);
     }

通过 $GLOBALS['HTTP_RAW_POST_DATA']; 获取同志数据然后 Init 函数验证签名等。验签成功运行代码
return call_user_func($callback, $result);

即调用了一个回调函数，NotifyCallBack() 函数并传递参数 $result 在NotifyCallBack函数中会调用我们重写的NotifyProcess()函数（此函数在notify.php 中被重写）

NotifyProcess() 判断也没有问题就会设置返回 success的xml信息

$this->SetReturn_code("SUCCESS");
$this->SetReturn_msg("OK");

并最终调用函数 $this->ReplyNotify($needSign); echo success的结果

函数ReplyNotify 需要修改一处代码：


    final private function ReplyNotify($needSign = true)
     {
     //如果需要签名
     if($needSign == true && 
      $this->GetReturn_code($return_code) == "SUCCESS")
     {
      $this->SetSign();
     }
     WxpayApi::replyNotify($this->ToXml());
     }

$this->GetReturn_code($return_code) == "SUCCESS")

改为

$this->GetReturn_code() == "SUCCESS")

即可。
这样整个流程就结束了。上面提到了传递订单参数

$input->SetAttach("test");

如果我设置值为 test this is attach (其实只要有空格就会存在bug)

如图传递的订单信息