PHP代码篇（七）--ThinkPHP5.1使用支付宝-电脑网站支付

一、说明

　　1、整体流程

　　　　：之前没有做过支付，所以对于支付，还是有点迷糊，这次主要是记录下“支付宝电脑网站支付”的一个完成开发流程。说明（本身支付宝支付，微信支付其实有很多类型，比如支付宝有，当面付，APP支付，手机网站支付，微信JSAPI支付，付款码支付，Native支付，H5支付，我们根据公司业务需求，选择对应的官网开发文档，进行引入即可）。本次开发使用的是thinkPHP5.1版本。

　　2、涉及步骤

　　　　：支付宝支付流程说明

　　　　：支付宝官方damo的使用

　　　　：支付宝回调notify_url异步通知的书写

　　　　：集成thinkPHP框架下引入支付宝damo的流程

二、支付业务及支付宝流程说明

　　1、首先我们的业务需求及支付宝流程如下：

　　2、实际中大多页面场景如下：

 

 三、开发准备步骤：

　　1、查看支付宝“支付宝支付开放平台”地址https://open.alipay.com/developmentDocument.htm

 

 　　2、文档里面有非常详细的介绍，这边我们不做具体展开说明，实际开发中我们需要了解下，注意接口说明。这里我们点击下载 官方的PHP Demo

 

 　　3、下载后应该是一个压缩包 alipay.trade.page.pay-PHP-UTF-8.zip，我们对其解压，然后重命名为 alipayPc。

 

 　　4、上面的准备工作做好了后，我们接下来进入实际的开发步骤。

 四、实际开发流程，在框架中使用demo

　　1、涉及步骤

　　　　：将解压后的文件夹alipayPc复制到框架中

　　　　：对官方写的支付，回调，业务代码进行分离，分离出一个自定义的AliPayPc()类

　　　　：配置config.php支付相关参数，

　　　　：在控制器中调用AliPayPc()类，进行支付

　　　　：新增回调文件，书写回调代码

　　2、解压后我们可以看到，demo文件如下，文件具体我这边就不做说明，只说下本次需要参考的文件，具体自己可以看下官网手册。

 

 

 　　3、上面的return_url.php 为官方写的回调文件，主要是进行验证

$arr=$_POST;
$alipaySevice = new AlipayTradeService($config); 
$alipaySevice->writeLog(var_export($_POST,true));
$result = $alipaySevice->check($arr);//验签方法

 

 　　4、然后是pagepay文件夹里面，有进行支付，查询交易，关闭交易，退款，退款查询，的官方参看代码，待会我们书写自己的 AliPayPc()类，基本是参考这样写。

 

 

 　　5、这里说明下，解压的文件我们是放在thinkPHP的 extend 目录，有些人可能习惯放到 vendor 目录，thinkPHP官网有说过，vendor 作为 使用 composer安装的扩展文件目录，而extend是手动引入的第三方文件目录，所以我们开发，还是需要准守规范比较好。

 　　6、下面我们在extend下的lib目录，没有新建一个lib文件夹，新建一个刚才说的自定义支付类 AliPayPc.php 文件。

 

 

 

 　　7、代码如下，这里面我们进行分离出刚才说的官方支付代码

 <?php
/**
 * Created by PhpStorm.
 * User: WuYan
 * Date: 2020/4/28
 * Time: 20:00
 * 支付宝电脑网站支付
 */
namespace lib;
class AliPayPc
{
    /**
     * 支付宝收款
     */
    public static function setAilPay()
    {
        
    }
}

 

 　　8、直接复制和修改pagepay目录下的pagepay.php文件，主要是修改下文件引入路径，和参数传入的方式

<?php

/**
 * Created by PhpStorm.
 * User: WuYan
 * Date: 2020/4/28
 * Time: 20:00
 * 支付宝电脑网站支付
 */

namespace lib;

class AliPayPc
{
    /**
     * 支付宝收款
     * @param [type] $out_trade_no 商户订单号
     * @param [type] $subject 订单名称
     * @param [type] $total_amount 付款金额
     * @param [type] $body 商品描述，可空
     * @param [type] $config_data 支付参数,数组类型;为空则取默认参数
     * @return void
     */
    public static function setAilPay($out_trade_no,$subject,$total_amount,$body,$config_data = [])
    {
        require_once env('extend_path').'/alipayPc/config.php';//引入路径参考自己的实际存放路径
        require_once env('extend_path').'/alipayPc/pagepay/service/AlipayTradeService.php';
        require_once env('extend_path').'/alipayPc/pagepay/buildermodel/AlipayTradePagePayContentBuilder.php';

        //构造参数
        $payRequestBuilder = new \AlipayTradePagePayContentBuilder();//类名前面加 \ 调用外部类，需要在类名前加 \ 
        $payRequestBuilder->setBody($body);
        $payRequestBuilder->setSubject($subject);
        $payRequestBuilder->setTotalAmount($total_amount);
        $payRequestBuilder->setOutTradeNo($out_trade_no);

        $aop = new \AlipayTradeService($config);

        /**
         * pagePay 电脑网站支付请求
         * @param $builder 业务参数，使用buildmodel中的对象生成。
         * @param $return_url 同步跳转地址，公网可以访问
         * @param $notify_url 异步通知地址，公网可以访问
         * @return $response 支付宝返回的信息
         */
        $response = $aop->pagePay($payRequestBuilder,$config['return_url'],$config['notify_url']);
    
        //输出表单
        var_dump($response);
    }
}

 

 　　9、如上，我们支付的类就创建好了，现在我们配置下config.ph文件。

 

 

 　　10、这里主要是配置，应用id，商户私钥，支付宝公钥，支付宝网关（注意下是正式账号，还是沙箱测试账号）。

　　　　补充说明，支付宝如何开通支付和如何申请沙箱账号，这里不做说明，不会的话看下期讲解，然后生成密钥这里也不做介绍，下期。

 

 

 　　11、写好支付类AliPayPc()，和配置好config.php后，我们在控制器controller中开始调用。

<?php
namespace app\admin\controller;

use lib\AliPayPc;//引入支付类

class User extends Base
{


    public function MtAliPay(Request $request)
    {
        $out_trade_no = "19982019121202021000";//订单号
        $subject = "测试商品000";//商品名称
        $total_amount = 0.1;//商品金额 元
        $body = "这是用于测试";//商品描述
        $config_data = [
            'return_url'=>$request->domain().'/index.php/admin/user/return_url',//同步跳转 待写
            'notify_url'=>$request->domain().'/index.php/admin/callback/notify_url',//异步跳转 待写
        ];
　　　　　//-------------
　　　　　　书写业务代码，比如生成订单记录
　　　　  //-------------

        //因为声明为静态类，所以直接调用
        AliPayPc::setAilPay($out_trade_no,$subject,$total_amount,$body,$config_data = []);
    }
}

 

 　　12、点击 你的域名/index.php/admin/user/userAliPay发现，如果没有问题，就可以直接掉转到支付宝付款页面，如果是可以直接扫码支付，也可以登录你的账户进行支付，如果支付成功，页面就会跳转到，你写的同步地址index.php/admin/login/return_url处。

 

 

 　　13、当然上面的支付成功后，还有一个最重要的异步回调，如下是支付宝官方说明：https://opendocs.alipay.com/open/270/105902

：程序执行完后必须打印输出“success”（不包含引号）。如果商户反馈给支付宝的字符不是 success 这7个字符，支付宝服务器会不断重发通知，直到超过24小时22分钟。
一般情况下，25小时以内完成8次通知（通知的间隔频率一般是：4m,10m,10m,1h,2h,6h,15h）；

：程序执行完成后，该页面不能执行页面跳转。
如果执行页面跳转，支付宝会收不到 success 字符，会被支付宝服务器判定为该页面程序运行出现异常，而重发处理结果通知；

 

　　14、回调的意思就是，通过你设置的 notify_url回调地址，支付宝在支付成功后，会带参（比如业务参数类：交易号，交易金额，公共参数：授权appid，签名）来请求你这个地址，告诉你，这一单，我们支付宝收到款了，怎么，怎么的，然后这里肯定有可能会有第三方的恶意请求（伪造请求）。所以你对这些进行验证，然后识别出是支付宝的回调，然后进行业务处理。比如修改订单支付状态。

　　15、最后，我们书写回调，当然还是先写一个回调的类，在之前的AliPayPc()类里面新增setNotify_url()//这个主要是进行验签

<?php

/**
 * Created by PhpStorm.
 * User: WuYan
 * Date: 2020/4/20
 * Time: 10:59
 * 支付宝
 */

namespace lib;

class AliPay
{
    /**
     * 支付宝收款
     *
     * @param [type] $out_trade_no 商户订单号
     * @param [type] $subject 订单名称
     * @param [type] $total_amount 付款金额
     * @param [type] $body 商品描述，可空
     * @param [type] $config_data 支付参数,数组类型;为空则取默认参数
     *
     * @return void
     */
    public static function setAilPay($out_trade_no,$subject,$total_amount,$body,$config_data = [])
    {
        require_once env('extend_path') . '/alipayPc/config.php';
        require_once env('extend_path'). '/alipayPc/pagepay/service/AlipayTradeService.php';
        require_once env('extend_path') .'/alipayPc/pagepay/buildermodel/AlipayTradePagePayContentBuilder.php';
        $config = array_merge($config, $config_data);
        //构造参数
        $payRequestBuilder = new \AlipayTradePagePayContentBuilder();
        if(!empty($body)){
            $payRequestBuilder->setBody($body);
        }
        $payRequestBuilder->setSubject($subject);
        $payRequestBuilder->setTotalAmount($total_amount);
        $payRequestBuilder->setOutTradeNo($out_trade_no);
        $aop = new \AlipayTradeService($config);
        /**
         * pagePay 电脑网站支付请求
         * @param $builder 业务参数，使用buildmodel中的对象生成。
         * @param $return_url 同步跳转地址，公网可以访问
         * @param $notify_url 异步通知地址，公网可以访问
         * @return $response 支付宝返回的信息
         */
        $response = $aop->pagePay($payRequestBuilder,$config['return_url'],$config['notify_url']);
        //输出表单
        // var_dump($response);
    }

    /**
     * 支付宝服务器异步通知页面
     *
     * @param [type] $arr 支付成功返回信息post
     *
     * @return void
     */
    public static function setNotify_url($arr)
    {
        require_once env('extend_path') . '/alipayPc/config.php';
        require_once env('extend_path'). '/alipayPc/pagepay/service/AlipayTradeService.php';

        $alipaySevice = new \AlipayTradeService($config);
        $alipaySevice->writeLog(var_export($arr,true));
        $result = $alipaySevice->check($arr);//进行验签
        if($result) {//验证成功
            //交易状态
            if($arr['trade_status'] == 'TRADE_FINISHED' || $arr['trade_status'] == 'TRADE_SUCCESS') {
                return true;
            }else {
                return false;
            }
        }else {
            return false;
        }
    }
}

　　16、然后在控制器里面新增回调方法

<?php
/**
 * 第三方请求，不需要验证
 */
namespace app\api\controller;

use think\Controller;
use lib\AliPayPc;

class callback extends Controller
{
    /**
     * 支付宝商户收款异步回调
     */
    public function notify_url()
    {
        $arr = $_POST;
        $result = AliPayPc::setNotify_url($arr);//进行验签
        //验签成功后
        //判断订单号是否存在数据库
        //进行业务处理----------------------
    }
}

 

五、结束语

　　1、支付宝电脑网页支付，整体来说，由于支付宝官方文档和本身集成，还是相对容易的，主要是在实际中，对于支付日志，回调日志，防止重复提交，防止伪造请求，和重复回调这些代码业务端的进行合理书写。

　　2、如果大家还是有疑问，可以留言，或是页面左上角二维码咨询。