thinkphp使用url請求調(diào)用ThinkApi天氣教程【圖文詳解】
前言
看了一年多的thinkphp手冊,我才發(fā)現(xiàn)了這個國內(nèi)比較便宜的(主要免費的接口和對應次數(shù)比較多)Api服務商,雖然在使用之后發(fā)現(xiàn)部分接口的返回值沒有某合返回的數(shù)據(jù)要多以及類似內(nèi)容審核的不夠嚴謹,不過在我看來非常適合框架新手玩家去試一試調(diào)用接口的快樂~以下帶來詳細教程~
一、注冊ThinkPHP服務市場賬號
進入首頁后點擊右上角,注冊、實名過程我就不說了。
二、拿到自己的AppCode(因為調(diào)用接口需要啦)
(1)點擊我的服務
(2)點擊安全信息
三、隨便找個免費的接口試試~
偷懶~用大家喜聞樂見的天氣接口吧~
(每天一百次,這不比前段時間每天10次的某合數(shù)據(jù)友好?足夠讓大家慢慢調(diào)試數(shù)據(jù)~)
(1)發(fā)起請求代碼(放公共方法中,若不用框架,可與調(diào)用方法同層放置)
/** * 發(fā)送HTTP請求方法 * @param string $url 請求URL * @param array $params 請求參數(shù) * @param string $method 請求方法GET/POST * @return array $data 響應數(shù)據(jù) */ function http($url, $params, $method = 'GET', $header = array(), $multi = false){ $opts = array( CURLOPT_TIMEOUT => 30, CURLOPT_RETURNTRANSFER => 1, CURLOPT_SSL_VERIFYPEER => false, CURLOPT_SSL_VERIFYHOST => false, CURLOPT_HTTPHEADER => $header ); /* 根據(jù)請求類型設置特定參數(shù) */ switch(strtoupper($method)){ case 'GET': $opts[CURLOPT_URL] = $url . '?' . http_build_query($params); break; case 'POST': //判斷是否傳輸文件 $params = $multi ? $params : http_build_query($params); $opts[CURLOPT_URL] = $url; $opts[CURLOPT_POST] = 1; $opts[CURLOPT_POSTFIELDS] = $params; break; default: throw new Exception('不支持的請求方式!'); } /* 初始化并執(zhí)行curl請求 */ $ch = curl_init(); curl_setopt_array($ch, $opts); $data = curl_exec($ch); $error = curl_error($ch); curl_close($ch); if($error) throw new Exception('請求發(fā)生錯誤:' . $error); return $data; }
(2)調(diào)用Api代碼
public function test() { $url = 'https://api.topthink.com/weather/query'; $param = [ 'appCode'=>'填之前(二)里面自己的Appcode', 'city'=>'重慶' ]; $header = array("Content-Type: application/x-www-form-urlencoded; charset=UTF-8"); //must have it ↑ $res = http($url,$param,'GET',$header); $res = json_decode($res,true); if($res['code']!=0) return \json('接口調(diào)用出錯啦'); var_dump($res); }
(3)康康結果?
四、總結一下
除了數(shù)據(jù)庫小子以外,面向接口開發(fā)也是一個phper必不可少的一項技能,如thinkApi返回的那個json數(shù)據(jù)格式,我的經(jīng)驗標準是:
code | 0 一般代表成功,其他的分別代表除成功以外的各種情況 |
msg | 用于描述接口返回的各種情況說明,如成功亦或捕獲到拋出的錯誤 |
data | 用于裝載前端需要的數(shù)據(jù),里面的數(shù)據(jù)格式根據(jù)前端的需求來修改制定 |
那么這些標準從哪里來的呢?當然是每次調(diào)用接口的時候發(fā)現(xiàn)Tencent以及Alibaba那些大佬是這樣返回的數(shù)據(jù),久而久之就成了我們后者學習的標桿咯~
多嘴一句記錄一下:(初學者可以不看啦~)
為什么要用Url請求,不用SDK?因為后者涉及使用composer的版本管理問題,在thinkphp5.0版本使用SDK會牽涉到php7.1+ - 8.0+版本警告問題以及thinkphp框架5.0.24- 5.1及以上版本的框架結構改變等問題,簡而言之:在tp5.0版本使用composer安裝thinkApi的SDK之后我們的 thinkphp目錄下的start.php會消失,內(nèi)部的一些框架方法會拋出警告,而composer又不能智能為你此時的5.0框架安裝他能夠接受的SDK,而不去改變他的結構,故在遇到某些情況(如調(diào)用此SDK的接口不多)的時候我們可以退而求之使用url請求來避免版本管理的問題。
此外,關于天氣查詢相關接口還有如下幾種可供選擇:
- 阿里云天氣API:https://next.api.aliyun.com/document/AliGenie/ssp_1.0/GetWeather
- 和風天氣API:https://dev.qweather.com/docs/configuration/api-config/
- 心知天氣API:https://seniverse.yuque.com/hyper_data/datasets/start?
感興趣的朋友可以進一步了解一下~
- Thinkphp 在api開發(fā)中異常返回依然是html的解決方式
- thinkphp5框架API token身份驗證功能示例
- ThinkPHP框架整合微信支付之JSAPI模式圖文詳解
- ThinkPHP實現(xiàn)微信支付(jsapi支付)流程教程詳解
- thinkPHP5.0框架API優(yōu)化后的友好性分析
- Thinkphp5框架ajax接口實現(xiàn)方法分析
- thinkPHP5框架接口寫法簡單示例
- ThinkPHP框架實現(xiàn)的微信支付接口開發(fā)完整示例
- thinkPHP框架實現(xiàn)的短信接口驗證碼功能示例
- thinkPHP微信分享接口JSSDK用法實例
- thinkPHP框架對接支付寶即時到賬接口回調(diào)操作示例
- ThinkPHP和UCenter接口沖突的解決方法