资讯专栏INFORMATION COLUMN

上云采购季！| 爆款云服务器低至4.6元/月，首单享0.9折

免费试用
首页/文章专栏/PHP实现支付宝小程序用户授权的工具类

PHP实现支付宝小程序用户授权的工具类

weapon / 1818人阅读

摘要：背景最近项目需要上线支付宝小程序，同时需要走用户的授权流程完成用户信息的存储，以前做过微信小程序的开发，本以为实现授权的过程是很简单的事情，但是再实现的过程中还是遇到了不少的坑，因此记录一下实现的过程学到的知识支付宝开放接口的调用模式以及实

背景

最近项目需要上线支付宝小程序，同时需要走用户的授权流程完成用户信息的存储，以前做过微信小程序的开发，本以为实现授权的过程是很简单的事情，但是再实现的过程中还是遇到了不少的坑，因此记录一下实现的过程

学到的知识

支付宝开放接口的调用模式以及实现方式

支付宝小程序授权的流程

RSA加密方式

吐槽点

支付宝小程序的入口隐藏的很深，没有微信小程序那么直接了当

支付宝小程序的开发者工具比较难用，编译时候比较卡，性能有很大的问题

每提交一次代码，支付宝小程序的体验码都要进行更换，比较繁琐，而且localStorage的东西不知道要如何删除

事先准备

到支付宝开放平台注册一个开发者账号，并做好相应的认证等工作

创建一个小程序，并记录好相关的小程序信息，包括支付宝公钥，私钥，app公钥等，可以借鉴支付宝官方提供的相应的公钥生成工具来生成公钥和私钥，工具的下载地址：传送门

了解下支付宝小程序的签名机制,详细见https://docs.open.alipay.com/...

熟悉下支付宝小程序获取用户信息的过程，详细见支付宝小程序用户授权指引

授权的步骤 授权时序图

实现流程

客户端通过my.getAuthCode接口获取code，传给服务端

服务端通过code，调用获取token接口获取access_token，alipay.system.oauth.token(换取授权访问令牌)

通过token接口调用支付宝会员查询接口获取会员信息，alipay.user.info.share(支付宝会员授权信息查询接口)

将获取的用户信息保存到数据库

AmpHelper工具类 
 $token,
        ];
        $param = self::buildApiBuisinessParam($busiParam,self::API_METHOD_GET_USER_INFO);
        return $param;

    }

    /**
     *获取二维码的基础参数
     */
    public static function getQrcodeBaseParam($page= "pages/index/index",$queryParam = [],$describe = ""){
        $busiParam = [
            "biz_content" => self::getQrBizContent($page,$queryParam,$describe)
        ];
        $param = self::buildApiBuisinessParam($busiParam,self::API_METHOD_GENERATE_QR);
        return $param;

    }

    /**
     *获取授权的基础参数
     */
    public static function getAuthBaseParam($code,$refreshToken = ""){
        $busiParam = [
            "grant_type" => "authorization_code",
            "code" => $code,
            "refresh_token" => $refreshToken,
        ];
        $param = self::buildApiBuisinessParam($busiParam,self::API_METHOD_AUTH_TOKEN);
        return $param;
    }


    /**
     * 构建业务参数
     */
    public static function buildApiBuisinessParam($businessParam,$apiMethod){
        $pubParam = self::getApiPubParam($apiMethod);
        $businessParam = array_merge($pubParam,$businessParam);
        $signContent = self::getSignContent($businessParam);
        error_log("sign_content ===========>".$signContent);
        $rsaHelper = new RsaHelper();
        $sign = $rsaHelper->createSign($signContent);
        error_log("sign ===========>".$sign);
        $businessParam["sign"] = $sign;
        return $businessParam;
    }


    /**
     * 公共参数
     *
     */
    public static function getApiPubParam($apiMethod){
        $ampBaseInfo = BusinessHelper::getAmpBaseInfo();
        $param = [
            "timestamp" => date("Y-m-d H:i:s") ,
            "method" => $apiMethod,
            "app_id" => formatArrValue($ampBaseInfo,"appid",config("param.amp.appid")),
            "sign_type" =>self::SIGN_TYPE_RSA2,
            "charset" =>self::FILE_CHARSET_UTF8,
            "version" =>self::VERSION,
        ];
        return $param;
    }


    /**
     * 获取签名的内容
     */
    public static function getSignContent($params) {
        ksort($params);
        $stringToBeSigned = "";
        $i = 0;
        foreach ($params as $k => $v) {
            if (!empty($v) && "@" != substr($v, 0, 1)) {
                if ($i == 0) {
                    $stringToBeSigned .= "$k" . "=" . "$v";
                } else {
                    $stringToBeSigned .= "&" . "$k" . "=" . "$v";
                }
                $i++;
            }
        }
        unset ($k, $v);
        return $stringToBeSigned;
    }


    public static function convertArrToQueryParam($param){
        $queryParam = [];
        foreach ($param as $key => $val){
            $obj = $key."=".$val;
            array_push($queryParam,$obj);
        }
        $queryStr = implode("&",$queryParam);
        return $queryStr;
    }

    /**
     * 转换字符集编码
     * @param $data
     * @param $targetCharset
     * @return string
     */
    public static function characet($data, $targetCharset) {
        if (!empty($data)) {
            $fileType = self::FILE_CHARSET_UTF8;
            if (strcasecmp($fileType, $targetCharset) != 0) {
                $data = mb_convert_encoding($data, $targetCharset, $fileType);
            }
        }
        return $data;
    }

    /**
     * 获取业务参数内容
     */
    public static function getQrBizContent($page, $queryParam = [],$describe = ""){
        if(is_array($queryParam)){
            $queryParam = http_build_query($queryParam);
        }
        $obj = [
            "url_param" => $page,
            "query_param" => $queryParam,
            "describe" => $describe
        ];
        $bizContent = json_encode($obj,JSON_UNESCAPED_UNICODE);
        return $bizContent;
    }

}
AmpHeler工具类关键代码解析 相关常量 
//支付宝的api接口地址
const API_DOMAIN = "https://openapi.alipay.com/gateway.do?";
//获取支付宝二维码的接口方法
const API_METHOD_GENERATE_QR = "alipay.open.app.qrcode.create";
//获取token的接口方法
const API_METHOD_AUTH_TOKEN = "alipay.system.oauth.token";
//获取用户信息的接口方法
const API_METHOD_GET_USER_INFO = "alipay.user.info.share";
//支付宝的签名方式，由RSA2和RSA两种
const SIGN_TYPE_RSA2 = "RSA2";
//版本号，此处固定挑那些就可以了
const VERSION = "1.0";
//UTF8编码
const FILE_CHARSET_UTF8 = "UTF-8";
//GBK编码
const FILE_CHARSET_GBK = "GBK";
//二维码接口调用成功的 返回节点
const RESPONSE_OUTER_NODE_QR = "alipay_open_app_qrcode_create_response";
//token接口调用成功的 返回节点
const RESPONSE_OUTER_NODE_AUTH_TOKEN = "alipay_system_oauth_token_response";
//用户信息接口调用成功的 返回节点
const RESPONSE_OUTER_NODE_USER_INFO = "alipay_user_info_share_response";
//错误的返回的时候的节点
const RESPONSE_OUTER_NODE_ERROR_RESPONSE = "error_response";

const STATUS_CODE_SUCCESS = 10000;
const STATUS_CODE_EXCEPT = 20000;
getAmpUserInfoByAuthCode方法

这个方法是获取用户信息的接口方法，只需要传入客户端传递的code，就可以获取到用户的完整信息

getAmpToken方法

这个方法是获取支付宝接口的token的方法，是一个公用方法，后面所有的支付宝的口调用，都可以使用这个方法先获取token

getResponse方法

考虑到会调用各个支付宝的接口，因此这里封装这个方法是为了方便截取接口返回成功之后的信息，提高代码的阅读性

getApiPubParam方法

这个方法是为了获取公共的参数，包括版本号，编码，appid，签名类型等基础业务参数

getSignContent方法

这个方法是获取签名的内容，入参是一个数组，最后输出的是参数的拼接字符串

buildApiBuisinessParam($businessParam,$apiMethod)

这个是构建api独立的业务参数部分方法，businessParam参数是支付宝各个接口的业务参数部分（出去公共参数），$apiMethod是对应的接口的方法名称，如获取token的方法名为alipay.system.oauth.token

签名帮助类 
createSign($data);      //生成签名
 *$is_ok = $rsa2->verifySign($data, $strSign); //验证签名
 */
class RsaHelper
{

    private static $PRIVATE_KEY;
    private static $PUBLIC_KEY;


    function __construct(){
        self::$PRIVATE_KEY = config("param.amp.private_key");
        self::$PUBLIC_KEY = config("param.amp.public_key");
    }

    /**
     * 获取私钥
     * @return bool|resource
     */
    private static function getPrivateKey()
    {
        $privKey = self::$PRIVATE_KEY;
        $privKey = "-----BEGIN RSA PRIVATE KEY-----".PHP_EOL.wordwrap($privKey, 64, PHP_EOL, true).PHP_EOL."-----END RSA PRIVATE KEY-----";
        ($privKey) or die("您使用的私钥格式错误，请检查RSA私钥配置");
        error_log("private_key is ===========>: ".$privKey);
        return openssl_pkey_get_private($privKey);
    }
    /**
     * 获取公钥
     * @return bool|resource
     */
    private static function getPublicKey()
    {
        $publicKey = self::$PUBLIC_KEY;
        $publicKey = "-----BEGIN RSA PRIVATE KEY-----".PHP_EOL.wordwrap($publicKey, 64, PHP_EOL, true).PHP_EOL."-----END RSA PRIVATE KEY-----";
        error_log("public key is : ===========>".$publicKey);
        return openssl_pkey_get_public($publicKey);
    }
    /**
     * 创建签名
     * @param string $data 数据
     * @return null|string
     */
    public function createSign($data = "")
    {
        //  var_dump(self::getPrivateKey());die;
        if (!is_string($data)) {
            return null;
        }
        return openssl_sign($data, $sign, self::getPrivateKey(),OPENSSL_ALGO_SHA256 ) ? base64_encode($sign) : null;
    }
    /**
     * 验证签名
     * @param string $data 数据
     * @param string $sign 签名
     * @return bool
     */
    public function verifySign($data = "", $sign = "")
    {
        if (!is_string($sign) || !is_string($sign)) {
            return false;
        }
        return (bool)openssl_verify(
            $data,
            base64_decode($sign),
            self::getPublicKey(),
            OPENSSL_ALGO_SHA256
        );
    }
}
调用 
$originUserData = AmpHelper::getAmpUserInfoByAuthCode($code);
echo $originUserData;

注意getAmpUserInfoByAuthCode方法，调用接口成功，会返回支付宝用户的正确信息，示例如下

{
    "alipay_user_info_share_response": {
        "code": "10000",
        "msg": "Success",
        "user_id": "2088102104794936",
        "avatar": "http://tfsimg.alipay.com/images/partner/T1uIxXXbpXXXXXXXX",
        "province": "安徽省",
        "city": "安庆",
        "nick_name": "支付宝小二",
        "is_student_certified": "T",
        "user_type": "1",
        "user_status": "T",
        "is_certified": "T",
        "gender": "F"
    },
    "sign": "ERITJKEIJKJHKKKKKKKHJEREEEEEEEEEEE"
}
踩坑点

在开发之前一定要仔细阅读用户的授权流程指引文档，否则很容出错

对于用户信息接口，在获取授权信息接口并没有做明确的说明，所以需要先梳理清楚

支付宝的签名机制和微信的有很大不同，对于习惯了微信小程序开发的人来说，刚开始可能有点不适应，所以需要多看看sdk里面的实现

私有云 云服务器 支付宝小程序 获客宝小程序 php 程序授权机制 工具类微信小程序怎么制作

文章版权归作者所有，未经允许请勿转载,若此文章存在违规行为，您可以联系管理员删除。

转载请注明本文地址：https://www.ucloud.cn/yun/29856.html

相关文章

  • PHP实现支付宝小程序发送模板消息的工具类

    摘要：背景最近公司项目一直在围绕着支付宝做应用开发，为了能保证消息能够及时的给用户传递，因此需要开发模板消息的功能，而小程序的模板消息也是最快捷的通知方式事先准备请仔细阅读支付宝模板消息发送指引模板消息指引仔细阅读用户的授权文档，用户授权的详细的 背景 最近公司项目一直在围绕着支付宝做应用开发，为了能保证消息能够及时的给用户传递，因此需要开发模板消息的功能，而小程序的模板消息也是最快捷的通知...

    n7then 评论0 收藏0

  • 开发支付宝小程序无从下手？我们给你创造了一条捷径

    摘要：即日起至月日公测活动期间，成功参与新版公测活动并接入支付宝小程序的用户，可获得个人版套餐个月价值元的免费使用资格。计划的第一站我们选择了支付宝小程序。支付宝以及其他平台的小程序，在这个时代里，更加需要无服务器的开发方式。 作为国内首家专注于小程序领域的后端云服务，知晓云正式开启 3.0 计划——全平台 Serverless 服务。 「知晓云」cloud.minapp.com，诞生于 2...

    biaoxiaoduan 评论0 收藏0

  • 小程序上云，有点猛

    摘要：另外小程序云应用有一套高可用架构，提供监控预警能力。自主可控小程序云应用提供服务器，开发者可以拥有登录或重启，也可以修改密码。也就是说，服务器是由小程序云应用提供，但使用权归开发者。　　前不久有一个朋友问我，到底是做什么端的小程序比较好？ 　　我只问了一句，你的产品里是否涉及钱和服务，如果涉及这两者，建议你选择支付宝小程序。你可以通过其他小程序玩裂变，但如果你想做服务和商业，一定要考虑支付宝...

    jsdt 评论0 收藏0

  • Antmove 缘起 - 好用的小程序多端解决方案

    摘要：目前支持哪些平台的搬家目前对外开放版本释放了微信小程序转支付宝小程序的功能，这也是我们在调研中发现需求最多的。从笔者的了解来看，微信小程序框架原理更接近于，而支付宝小程序更接近于。 原文地址： https://ant-move.github.io/we... 蚂蚁搬家工具（Antmove）是一个小程序开发辅助工具，致力于解决小程序跨平台开发的难题，借助于 Antmove，你只需要编写...

    crelaber 评论0 收藏0

  • 【Copy攻城狮日志】借助Taro暴改Nideshop实现电商支付宝小程序雏形

    摘要：接下来，在支付宝小程序开发者工具中打，不出意外能跑起来一个电商支付宝小程序雏形。地址以上是我这个攻城狮对使用转换原生微信小程序为支付宝小程序的一次微不足道的实践。 showImg(https://segmentfault.com/img/bVbnCCN?w=1818&h=931);↑开局一张图，故事全靠编↑ 从一个需求说起 作为底层的程序猿，哦不，我连猿都算不上，混的好的叫码神，混得一...

    gnehc 评论0 收藏0

发表评论

登陆后可评论

0条评论

weapon

男|高级讲师
我要私信

TA的文章

阅读更多

云社区相关服务

提问 提问 学习 学习 认证 认证 产品 产品 技术服务 技术服务 售前咨询 售前咨询
最新活动
阅读需要支付1元查看
<