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、当然上面的支付成功后,还有一个最重要的异步回调,如下是支付宝官方说明:
:程序执行完后必须打印输出“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、如果大家还是有疑问,可以留言,或是页面左上角二维码咨询。