4.5.2、WechatServerApi · Endor Wechat SDK

# 服務器基礎接口 WechatServerApi **目錄 (Table of Contents)** [TOC] ## 類基本信息 **類簡要描述：** - 微信公眾平臺服務端基礎接口，主要用于獲取API令牌和JS API令牌等。 **類名字空間：** - endor/wechat/server **類繼承關系：** WechatServerApi -> WechatCommon ## 類成員函數/方法 ### __construct($configure) + 參數列表： |參數名|類型|必填項|說明 |:---- |:---|:----- |----- | |$configure| object (WechatConfig) | 是 | 微信配置參數對象 | + 返回值： `無` + 函數說明： `構造函數` ### getAccessToken(); + 參數列表： `無` + 返回值： `array` + 返回值（示例） ``` [ "access_token" => 4SyHI39Irn4ZEkQby2LTTQiAHAZZWXX .... "expires_in" => 7200 ] ``` + 錯誤返回 `如果函數內有錯誤或異常，拋出 WechatException異常 ` + 函數說明： `獲取微信公眾號API 令牌，該令牌請保存在數據庫，有獲取次數限制` + Eample： ```PHP $wxConfigure = new WechatConfig(); $wxConfigure->setParameter("appid","wx210100001"); $wxConfigure->setParameter("appsecret","BeU_91p2K7idjxcHaI6jcXkYHPlDj3"); $wechatServer = new WechatServerApi($wxConfigure); try{ $results = $wechatServer->getAccessToken(); $access_token = $results['access_token']; $epxires_in = $results['expires_in']; $wxConfigure->setParameter("access_token ", $access_token); } catch(WechatException $wechatException) { echo "[err code:] ". $wechatException->getCode(); echo "[error msg:] " . $wechatException->getMessage() ; } ``` ### getWechatJsapiTicket（） + 參數列表： `無` + 返回值： `array` + 返回值（示例） ``` [ "ticket" => 4SyHI39Irn4ZEkQby2LTTQiAHAZZWXX .... "expires_in" => 7200 ] ``` + 錯誤返回 `如果函數內有錯誤或異常，拋出 WechatException異常 ` + 函數說明： `獲取微信公眾號JS API Ticket，該Ticket請保存在數據庫，有獲取次數限制` + Eample： ```PHP // 假設我們在這里已經通過getAccessToken()獲取到了全局access_token，存在變量 // $access_token中 $wxConfigure = new WechatConfig(); $wxConfigure->setParameter("appid","wx210100001"); $wxConfigure->setParameter("appsecret","BeU_91p2K7idjxcHaI6jcXkYHPlDj3"); $wxConfigure->setParameter("access_token",$access_token); $wechatServer = new WechatServerApi($wxConfigure); try{ $results = $wechatServer->getWechatJsapiTicket(); $ticket = $results['ticket']; $epxires_in = $results['expires_in']; $wxConfigure->setParameter("jsapi_ticket",$ticket); } catch(WechatException $wechatException) { echo "[err code:] ". $wechatException->getCode(); echo "[error msg:] " . $wechatException->getMessage() ; } ``` ### getJsApiSign（） + 參數列表： `無` + 返回值： `array` + 返回值（示例） ``` [ "appId" => 4SyHI39Irn4ZEkQbysdadsdaX .... "nonceStr" => 7200, "timestamp"=>1555533333, "url"=>"https://mobile.test.com/", "signature"=>"f3fd4sdadad4900e0305dab3048c171630984c8", "rawString"=>.... 此處略 ] ``` + 錯誤返回 `如果函數內有錯誤或異常，拋出 WechatException異常 ` + 函數說明： `獲取微信公眾號Js Api 簽名，該返回值用于初始化 js wx 對象 ` + Eample： ```PHP // 假設我們在這里已經通過getWechatJsapiTicket()獲取到了jsapi ticket，存在變量 // $ticket 中 $wxConfigure = new WechatConfig(); $wxConfigure->setParameter("appid","wx210100001"); $wxConfigure->setParameter("appsecret","BeU_91p2K7idjxcHaI6jcXkYHPlDj3"); $wxConfigure->setParameter("ticket",$ticket); $wechatServer = new WechatServerApi($wxConfigure); try{ $results = $wechatServer->getJsApiSign(); echo $results; // 將對象返回給JS頁面 } catch(WechatException $wechatException) { echo "[err code:] ". $wechatException->getCode(); echo "[error msg:] " . $wechatException->getMessage() ; } ``` ```Javascript <html> <header> <script type="text/javascript" src="https://res.wx.qq.com/open/js/jweixin-1.1.0.js"></script> </header> <body> </body> <script> // 假設前端獲取到后端返回來的jsapi 簽名對象為 results wx.config({ debug: false, appId:results.appId, timestamp:results.timestamp, nonceStr: 'results.nonceStr, signature:results.signature, jsApiList: [ // 所有要調用的 API 都要加到這個列表中 'checkJsApi', 'openLocation', 'getLocation', 'scanQRCode', 'translateVoice', ] }); </script> ``` ### getWechatServerIp（） + 參數列表： `無` + 返回值： `array` + 返回值（示例） ``` [ "101.226.233.139", "101.226.233.140", .... ] ``` + 錯誤返回 `如果函數內有錯誤或異常，拋出 WechatException異常 ` + 函數說明： `獲取微信公眾號服務器IP列表 `