php調(diào)用接口及編寫接口
在這里openUser.php相當(dāng)于一個(gè)接口熟掂,其中g(shù)et_user_list 是一個(gè)API(獲取用戶列表),講求返回的數(shù)據(jù)類型為JSON格式扎拣。
你只需要在你PHP代碼中執(zhí)行這條鏈接他就會(huì)返回赴肚。
GET方式的直接使用
$file_contents = file_get_content
POST方式得用下面的(需要開啟PHP curl支持)。
$url =
$ch = curl_init ();
curl_setopt ( $ch, CURLOPT_URL, $url );
curl_setopt ( $ch, CURLOPT_RETURNTRANSFER, 1 );
curl_setopt ( $ch, CURLOPT_CONNECTTIMEOUT, 10 );
curl_setopt ( $ch, CURLOPT_POST, 1 ); //啟用POST提交
$file_contents = curl_exec ( $ch );
curl_close ( $ch );
在php 中編寫接口
一二蓝、先簡(jiǎn)單回答兩個(gè)問(wèn)題:
1誉券、PHP 可以開發(fā)客戶端?
答:不可以,因?yàn)镻HP是腳本語(yǔ)言侣夷,是負(fù)責(zé)完成 B/S架構(gòu) 或 C/S架構(gòu) 的S部分横朋,即:服務(wù)端的開發(fā)。(別去糾結(jié) GTK百拓、WinBinder)
2琴锭、為什么選擇 PHP 作為開發(fā)服務(wù)端的首選?
答:跨平臺(tái)(可以運(yùn)行在UNIX、LINUX衙传、WINDOWS决帖、Mac OS下)、低消耗(PHP消耗相當(dāng)少的系統(tǒng)資源)蓖捶、運(yùn)行效率高(相對(duì)而言)地回、MySQL的完美搭檔,本身是免費(fèi)開源的俊鱼,......
二刻像、如何使用 PHP 開發(fā) API(Application Programming Interface,應(yīng)用程序編程接口) 呢?
做過(guò) API 的人應(yīng)該了解并闲,其實(shí)開發(fā) API 比開發(fā) WEB 更簡(jiǎn)潔细睡,但可能邏輯更復(fù)雜,因?yàn)?API 其實(shí)就是數(shù)據(jù)輸出帝火,不用呈現(xiàn)頁(yè)面溜徙,所以也就不存在 MVC(API 只有 M 和 C)湃缎,
1、和 WEB 開發(fā)一樣蠢壹,首先需要一些相關(guān)的參數(shù)嗓违,這些參數(shù),都會(huì)由客戶端傳過(guò)來(lái)图贸,也許是 GET 也許是 POST蹂季,這個(gè)需要開發(fā)團(tuán)隊(duì)相互之間約定好,或者制定統(tǒng)一規(guī)范疏日。
2乏盐、有了參數(shù),根據(jù)應(yīng)用需求制恍,完成數(shù)據(jù)處理,例如:任務(wù)進(jìn)度更新神凑、APP內(nèi)購(gòu)净神、一局游戲結(jié)束數(shù)據(jù)提交等等
3、數(shù)據(jù)邏輯處理完之后溉委,返回客戶端所需要用到的相關(guān)數(shù)據(jù)鹃唯,例如:任務(wù)狀態(tài)、內(nèi)購(gòu)結(jié)果瓣喊、玩家信息等等
數(shù)據(jù)怎么返給客戶端?
直接輸出的形式坡慌,如:JSON、XML藻三、TEXT 等等洪橘。
4、客戶端獲取到你返回的數(shù)據(jù)后棵帽,在客戶端本地和用戶進(jìn)行交互
臨時(shí)寫的一個(gè)簡(jiǎn)單 API 例子:
$output = array();
$a = @$_GET['a'] ? $_GET['a'] : '';
$uid = @$_GET['uid'] ? $_GET['uid'] : 0;
if (empty($a)) {
$output = array('data'=>NULL, 'info'=>'坑爹啊!', 'code'=>-201);
exit(json_encode($output));
}
//走接口
if ($a == 'get_users') {
//檢查用戶
if ($uid == 0) {
$output = array('data'=>NULL, 'info'=>'The uid is null!', 'code'=>-401);
exit(json_encode($output));
}
//假設(shè) $mysql 是數(shù)據(jù)庫(kù)
$mysql = array(
10001 => array(
'uid'=>10001,
'vip'=>5,
'nickname' => 'Shine X',
'email'=>'979137@qq.com',
'qq'=>979137,
'gold'=>1500,
'powerplay'=> array('2xp'=>12,'gem'=>12,'bingo'=>5,'keys'=>5,'chest'=>8),
'gems'=> array('red'=>13,'green'=>3,'blue'=>8,'yellow'=>17),
'ctime'=>1376523234,
'lastLogin'=>1377123144,
'level'=>19,
'exp'=>16758,
),
10002 => array(
'uid'=>10002,
'vip'=>50,
'nickname' => 'elva',
'email'=>'elva@ezhi.net',
'qq'=>NULL,
'gold'=>14320,
'powerplay'=> array('2xp'=>1,'gem'=>120,'bingo'=>51,'keys'=>5,'chest'=>8),
'gems'=> array('red'=>13,'green'=>3,'blue'=>8,'yellow'=>17),
'ctime'=>1376523234,
'lastLogin'=>1377123144,
'level'=>112,
'exp'=>167588,
),
10003 => array(
'uid' => 10003,
'vip' => 5,
'nickname' => 'Lily',
'email' => 'Lily@ezhi.net',
'qq' => NULL,
'gold' => 1541,
'powerplay'=> array('2xp'=>2,'gem'=>112,'bingo'=>4,'keys'=>7,'chest'=>8),
'gems' => array('red'=>13,'green'=>3,'blue'=>9,'yellow'=>7),
'ctime' => 1376523234,
'lastLogin'=> 1377123144,
'level' => 10,
'exp' => 1758,
),
);
$uidArr = array(10001,10002,10003);
if (in_array($uid, $uidArr, true)) {
$output = array('data' => NULL, 'info'=>'The user does not exist!', 'code' => -402);
exit(json_encode($output));
}無(wú)錫人流醫(yī)院 http://www.bhnfkyy.com/
//查詢數(shù)據(jù)庫(kù)
$userInfo = $mysql[$uid];
//輸出數(shù)據(jù)
$output = array(
'data' => array(
'userInfo' => $userInfo,
'isLogin' => true,//是否首次登陸
'unread' => 4,//未讀消息數(shù)量
'untask' => 3,//未完成任務(wù)
),
'info' => 'Here is the message which, commonly used in popup window', //消息提示熄求,客戶端常會(huì)用此作為給彈窗信息。
'code' => 200, //成功與失敗的代碼逗概,一般都是正數(shù)或者負(fù)數(shù)
);
exit(json_encode($output));
} elseif ($a == 'get_games_result') {
//...
die('您正在調(diào) get_games_result 接口!');
} elseif ($a == 'upload_avatars') {
//....
die('您正在調(diào) upload_avatars 接口!');
}
復(fù)制代碼
點(diǎn)擊測(cè)試
三弟晚、實(shí)際項(xiàng)目中,我們?cè)陂_發(fā) API 應(yīng)該注意的幾個(gè)事項(xiàng)(僅供參考):
1逾苫、單文件實(shí)現(xiàn)多接口的形式有很多種卿城,例如:if..elseif.. 或 switch 或 動(dòng)態(tài)方法 (也就是TP的這種訪問(wèn)函數(shù)體的形式)
2、對(duì)于數(shù)據(jù)的輸出最好用json铅搓,json具有相當(dāng)強(qiáng)大的跨平臺(tái)性瑟押,市場(chǎng)上各大主流編程語(yǔ)言都支持json解析,json正在逐步取代xml狸吞,成為網(wǎng)絡(luò)數(shù)據(jù)的通用格式
3勉耀、接口安全指煎,一定要增加接口驗(yàn)證。例如便斥,客戶端和服務(wù)端針對(duì)不同接口統(tǒng)一做好加密方式至壤,服務(wù)端在對(duì)于每次接口需要都要進(jìn)行驗(yàn)證。以保證防止接口被惡意刷新或黑客惡意調(diào)用枢纠,尤其是大型商業(yè)應(yīng)用像街。
4、對(duì)于線上的 API 必須保證所有接口正常且關(guān)閉所有的錯(cuò)誤信息 => error_reporting(0)晋渺,在輸出JSON 時(shí)镰绎,不能有任何其它輸出,否則木西,客戶端將解析數(shù)據(jù)失敗畴栖,直接 Crash!
5、開發(fā) API 和 WEB 有一定的區(qū)別八千,如果是 WEB 的話吗讶,可能代碼出錯(cuò)了,不會(huì)導(dǎo)致特別嚴(yán)重的錯(cuò)誤恋捆,也許只是導(dǎo)致數(shù)據(jù)寫入和查詢失敗照皆,也許導(dǎo)致 WEB 的某個(gè)部分錯(cuò)位或亂碼。但如果是 API沸停,直接 Crash!
6膜毁、做接口開發(fā)嗜逻,不建議使用框架開發(fā)正卧,原因概括起來(lái)有兩點(diǎn)(其實(shí)我有點(diǎn)冒風(fēng)險(xiǎn)的崖面,本人也是 TPer 一枚绘雁,畢竟這是TP的官網(wǎng)):
1)客戶端一般對(duì)服務(wù)端的響應(yīng)速度有極高要求坪圾,因此若债,使用最原生態(tài)的 PHP 完成接口開發(fā)谬墙,是最高效的吵聪,假如用到了框架劲装,還需要加載各種不需要多余的文件胧沫,就好比夏天穿了件冬天的衣服。試想占业,你在玩手機(jī)的時(shí)候绒怨,使用一個(gè)應(yīng)用隨便一個(gè)操作,等半天才有動(dòng)靜谦疾,你受的了嗎?
2)就是上面第4點(diǎn)提到的南蹂,框架對(duì)于WEB開發(fā),是件很幸福的事念恍,但對(duì)于 API 而言六剥,你實(shí)在不敢想象它會(huì)給你出什么岔子!最后你將痛苦不堪~~因?yàn)楹芏嗫蚣芏际菫?WEB 誕生的(我也很期待有一天能看到專門為開發(fā) API 而生的框架或者擴(kuò)展)
這個(gè)也有人糾結(jié)晚顷,接口效率與穩(wěn)定性,還得看編碼的人疗疟,有的人可能寫的還不如框架跑的快该默,也有人覺(jué)得用框架沒(méi)什么問(wèn)題,這里只是建議策彤,關(guān)鍵看自己的實(shí)際情況栓袖,同時(shí)建議代碼上線前壓測(cè)一下
說(shuō)到這,不得不說(shuō)扯一下店诗,騰訊微博淘寶等開放平臺(tái)裹刮。其實(shí)那些開放平臺(tái),所謂的開放庞瘸,就是給你提供一個(gè)這樣的接口捧弃,你根據(jù)他們提供的技術(shù)文檔,按他們制定的格式和要求擦囊,調(diào)它們提供的接口文件(一般都是返回JSON或者XML)塔橡,你就可以獲取到他們的相關(guān)信息,例如:QQ用戶基本信息霜第、淘寶店鋪、商品消息等等户辞。然后在根據(jù)這些消息泌类,在你的應(yīng)用里完成交互。
其實(shí)底燎,ajax 也是調(diào)用 API 的接口
深圳網(wǎng)站建設(shè)www.sz886.com