天津APP開發(fā)——淺談 PHP 與手機 APP 開發(fā)(API 接口開發(fā)).
- 標簽 :
這個帖子寫給不太了解PHP與API開發(fā)的人
一、先簡單回答兩個問題:
1、PHP 可以開發(fā)客戶端?
答:不可以,因為PHP是腳本語言,是負責(zé)完成 B/S架構(gòu) 或 C/S架構(gòu) 的S部分,即:服務(wù)端的開發(fā)。(別去糾結(jié) GTK、WinBinder)
2、為什么選擇 PHP 作為開發(fā)服務(wù)端的首選?
答:跨平臺(可以運行在UNIX、LINUX、WINDOWS、Mac OS下)、低消耗(PHP消耗相當(dāng)少的系統(tǒng)資源)、運行效率高(相對而言)、MySQL的完美搭檔,本身是免費開源的,......
二、如何使用 PHP 開發(fā) API(Application Programming Interface,應(yīng)用程序編程接口) 呢?
做過 API 的人應(yīng)該了解,其實開發(fā) API 比開發(fā) WEB 更簡潔,但可能邏輯更復(fù)雜,因為 API 其實就是數(shù)據(jù)輸出,不用呈現(xiàn)頁面,所以也就不存在 MVC(API 只有 M 和 C),
1、和 WEB 開發(fā)一樣,首先需要一些相關(guān)的參數(shù),這些參數(shù),都會由客戶端傳過來,也許是 GET 也許是 POST,這個需要開發(fā)團隊相互之間約定好,或者制定統(tǒng)一規(guī)范。
2、有了參數(shù),根據(jù)應(yīng)用需求,完成數(shù)據(jù)處理,例如:任務(wù)進度更新、APP內(nèi)購、一局游戲結(jié)束數(shù)據(jù)提交等等
3、數(shù)據(jù)邏輯處理完之后,返回客戶端所需要用到的相關(guān)數(shù)據(jù),例如:任務(wù)狀態(tài)、內(nèi)購結(jié)果、玩家信息等等
數(shù)據(jù)怎么返給客戶端?
直接輸出的形式,如:JSON、xml、TEXT 等等。
4、客戶端獲取到你返回的數(shù)據(jù)后,在客戶端本地和用戶進行交互
臨時寫的一個簡單 API 例子:
<?php
$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ù)庫
????$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));
????}
????//查詢數(shù)據(jù)庫
????$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',?//消息提示,客戶端常會用此作為給彈窗信息。
????????'code'?=>?200,?//成功與失敗的代碼,一般都是正數(shù)或者負數(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?接口!');
}
點擊測試(對于客戶端而言,也是直接調(diào)用這樣的地址):
http://www.vip1993.com/api/test/index.php
http://www.vip1993.com/api/test/index.php?a=get_users
http://www.vip1993.com/api/test/index.php?a=get_users&uid=10001
http://www.vip1993.com/api/test/index.php?a=get_users&uid=10002
http://www.vip1993.com/api/test/index.php?a=get_users&uid=10003
三、實際項目中,我們在開發(fā) API 應(yīng)該注意的幾個事項(僅供參考):
1、單文件實現(xiàn)多接口的形式有很多種,例如:if..elseif.. 或 switch 或 動態(tài)方法 (也就是TP的這種訪問函數(shù)體的形式)
2、對于數(shù)據(jù)的輸出最好用json,json具有相當(dāng)強大的跨平臺性,市場上各大主流編程語言都支持json解析,json正在逐步取代xml,成為網(wǎng)絡(luò)數(shù)據(jù)的通用格式
3、接口安全,一定要增加接口驗證。例如,客戶端和服務(wù)端針對不同接口統(tǒng)一做好加密方式,服務(wù)端在對于每次接口需要都要進行驗證。以保證防止接口被惡意刷新或黑客惡意調(diào)用,尤其是大型商業(yè)應(yīng)用。
4、對于線上的 API 必須保證所有接口正常且關(guān)閉所有的錯誤信息 => error_reporting(0),在輸出JSON 時,不能有任何其它輸出,否則,客戶端將解析數(shù)據(jù)失敗,直接 Crash!
5、開發(fā) API 和 WEB 有一定的區(qū)別,如果是 WEB 的話,可能代碼出錯了,不會導(dǎo)致特別嚴重的錯誤,也許只是導(dǎo)致數(shù)據(jù)寫入和查詢失敗,也許導(dǎo)致 WEB 的某個部分錯位或亂碼。但如果是 API,直接 Crash!
6、做接口開發(fā),不建議使用框架開發(fā),原因概括起來有兩點(其實我有點冒風(fēng)險的,本人也是 TPer 一枚,畢竟這是TP的官網(wǎng)):
1)客戶端一般對服務(wù)端的響應(yīng)速度有極高要求,因此,使用最原生態(tài)的 PHP 完成接口開發(fā),是最高效的,假如用到了框架,還需要加載各種不需要多余的文件,就好比夏天穿了件冬天的衣服。試想,你在玩手機的時候,使用一個應(yīng)用隨便一個操作,等半天才有動靜,你受的了嗎?
2)就是上面第4點提到的,框架對于WEB開發(fā),是件很幸福的事,但對于 API 而言,你實在不敢想象它會給你出什么岔子!最后你將痛苦不堪~~因為很多框架都是為 WEB 誕生的(我也很期待有一天能看到專門為開發(fā) API 而生的框架或者擴展)
這個也有人糾結(jié),接口效率與穩(wěn)定性,還得看編碼的人,有的人可能寫的還不如框架跑的快,也有人覺得用框架沒什么問題,這里只是建議,關(guān)鍵看自己的實際情況,同時建議代碼上線前壓測一下
說到這,不得不說扯一下,騰訊微博淘寶等開放平臺。其實那些開放平臺,所謂的開放,就是給你提供一個這樣的接口,你根據(jù)他們提供的技術(shù)文檔,按他們制定的格式和要求,調(diào)它們提供的接口文件(一般都是返回JSON或者xml),你就可以獲取到他們的相關(guān)信息,例如:QQ用戶基本信息、淘寶店鋪、商品消息等等。然后在根據(jù)這些消息,在你的應(yīng)用里完成交互。
其實,ajax 也是調(diào)用 API 的一種體現(xiàn)形式,你覺得呢?
天津市犀思科技有限公司是專業(yè)從事web應(yīng)用定制開發(fā)的一家公司,主營業(yè)務(wù)包括定制營銷型網(wǎng)站建設(shè)、微信小程序開發(fā)、微信公眾號開發(fā)、APP定制開發(fā)、天津企業(yè)微信開發(fā)、ERP、CRM、OA等企業(yè)應(yīng)用場景信息化解決方案等服務(wù),致力于成為中國領(lǐng)先的IT服務(wù)及行業(yè)解決方案的提供商。

