PHP實現支付寶小程序用戶授權的工具類

weapon 發布于2019-07-01 11:07 / 2100人閱讀

摘要：背景最近項目需要上線支付寶小程序，同時需要走用戶的授權流程完成用戶信息的存儲，以前做過微信小程序的開發，本以為實現授權的過程是很簡單的事情，但是再實現的過程中還是遇到了不少的坑，因此記錄一下實現的過程學到的知識支付寶開放接口的調用模式以及實

背景

最近項目需要上線支付寶小程序，同時需要走用戶的授權流程完成用戶信息的存儲，以前做過微信小程序的開發，本以為實現授權的過程是很簡單的事情，但是再實現的過程中還是遇到了不少的坑，因此記錄一下實現的過程

學到的知識

支付寶開放接口的調用模式以及實現方式

支付寶小程序授權的流程

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里面的實現

GPU云服務器云服務器支付寶小程序獲客寶小程序 php 程序授權機制工具類微信小程序怎么制作

文章版權歸作者所有，未經允許請勿轉載,若此文章存在違規行為，您可以聯系管理員刪除。

轉載請注明本文地址：http://m.specialneedsforspecialkids.com/yun/29856.html

PHP實現支付寶小程序發送模板消息的工具類

摘要：背景最近公司項目一直在圍繞著支付寶做應用開發，為了能保證消息能夠及時的給用戶傳遞，因此需要開發模板消息的功能，而小程序的模板消息也是最快捷的通知方式事先準備請仔細閱讀支付寶模板消息發送指引模板消息指引仔細閱讀用戶的授權文檔，用戶授權的詳細的背景最近公司項目一直在圍繞著支付寶做應用開發，為了能保證消息能夠及時的給用戶傳遞，因此需要開發模板消息的功能，而小程序的模板消息也是最快捷的通知...

n7then 2019-07-01 11:12 評論0 收藏0
開發支付寶小程序無從下手？我們給你創造了一條捷徑

摘要：即日起至月日公測活動期間，成功參與新版公測活動并接入支付寶小程序的用戶，可獲得個人版套餐個月價值元的免費使用資格。計劃的第一站我們選擇了支付寶小程序。支付寶以及其他平臺的小程序，在這個時代里，更加需要無服務器的開發方式。作為國內首家專注于小程序領域的后端云服務，知曉云正式開啟 3.0 計劃——全平臺 Serverless 服務。「知曉云」cloud.minapp.com，誕生于 2...

biaoxiaoduan 2019-08-23 15:21 評論0 收藏0
小程序上云，有點猛

摘要：另外小程序云應用有一套高可用架構，提供監控預警能力。自主可控小程序云應用提供服務器，開發者可以擁有登錄或重啟，也可以修改密碼。也就是說，服務器是由小程序云應用提供，但使用權歸開發者。　　前不久有一個朋友問我，到底是做什么端的小程序比較好？　　我只問了一句，你的產品里是否涉及錢和服務，如果涉及這兩者，建議你選擇支付寶小程序。你可以通過其他小程序玩裂變，但如果你想做服務和商業，一定要考慮支付寶...

jsdt 2019-04-24 19:38 評論0 收藏0
Antmove 緣起 - 好用的小程序多端解決方案

摘要：目前支持哪些平臺的搬家目前對外開放版本釋放了微信小程序轉支付寶小程序的功能，這也是我們在調研中發現需求最多的。從筆者的了解來看，微信小程序框架原理更接近于，而支付寶小程序更接近于。原文地址： https://ant-move.github.io/we... 螞蟻搬家工具（Antmove）是一個小程序開發輔助工具，致力于解決小程序跨平臺開發的難題，借助于 Antmove，你只需要編寫...

crelaber 2019-08-26 10:32 評論0 收藏0
【Copy攻城獅日志】借助Taro暴改Nideshop實現電商支付寶小程序雛形

摘要：接下來，在支付寶小程序開發者工具中打，不出意外能跑起來一個電商支付寶小程序雛形。地址以上是我這個攻城獅對使用轉換原生微信小程序為支付寶小程序的一次微不足道的實踐。 showImg(https://segmentfault.com/img/bVbnCCN?w=1818&h=931);↑開局一張圖，故事全靠編↑ 從一個需求說起作為底層的程序猿，哦不，我連猿都算不上，混的好的叫碼神，混得一...

gnehc 2019-08-23 14:54 評論0 收藏0