PHP進(jìn)行手機(jī)APP開發(fā)(API 接口開發(fā))指導(dǎo)
做過 API 的人應(yīng)該了解,其實(shí)開發(fā) API 比開發(fā) WEB 更簡潔,但可能邏輯更復(fù)雜,因?yàn)?API 其實(shí)就是數(shù)據(jù)輸出,不用呈現(xiàn)頁面,所以也就不存在 MVC(API 只有 M 和 C),那么我們來探討下,如何使用php進(jìn)行手機(jī)API接口開發(fā)
2、為什么選擇 PHP 作為開發(fā)服務(wù)端的首選?
答:跨平臺(可以運(yùn)行在UNIX、LINUX、WINDOWS、Mac OS下)、低消耗(PHP消耗相當(dāng)少的系統(tǒng)資源)、運(yùn)行效率高(相對而言)、MySQL的完美搭檔,本身是免費(fèi)開源的,......
二、如何使用 PHP 開發(fā) API(Application Programming Interface,應(yīng)用程序編程接口) 呢?
做過 API 的人應(yīng)該了解,其實(shí)開發(fā) API 比開發(fā) WEB 更簡潔,但可能邏輯更復(fù)雜,因?yàn)?API 其實(shí)就是數(shù)據(jù)輸出,不用呈現(xiàn)頁面,所以也就不存在 MVC(API 只有 M 和 C),
1、和 WEB 開發(fā)一樣,首先需要一些相關(guān)的參數(shù),這些參數(shù),都會由客戶端傳過來,也許是 GET 也許是 POST,這個需要開發(fā)團(tuán)隊(duì)相互之間約定好,或者制定統(tǒng)一規(guī)范。
2、有了參數(shù),根據(jù)應(yīng)用需求,完成數(shù)據(jù)處理,例如:任務(wù)進(jìn)度更新、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ù)后,在客戶端本地和用戶進(jìn)行交互
臨時寫的一個簡單 API 例子:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
|
<?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ù)或者負(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 接口!' ); } |
點(diǎn)擊測試(對于客戶端而言,也是直接調(diào)用這樣的地址):
http://www.ezhi.net/api/test/index.php
http://www.ezhi.net/api/test/index.php?a=get_users
http://www.ezhi.net/api/test/index.php?a=get_users&uid=10001
http://www.ezhi.net/api/test/index.php?a=get_users&uid=10002
http://www.ezhi.net/api/test/index.php?a=get_users&uid=10003
三、實(shí)際項(xiàng)目中,我們在開發(fā) API 應(yīng)該注意的幾個事項(xiàng)(僅供參考):
1、單文件實(shí)現(xiàn)多接口的形式有很多種,例如:if..elseif.. 或 switch 或 動態(tài)方法 (也就是TP的這種訪問函數(shù)體的形式)
2、對于數(shù)據(jù)的輸出最好用json,json具有相當(dāng)強(qiáng)大的跨平臺性,市場上各大主流編程語言都支持json解析,json正在逐步取代xml,成為網(wǎng)絡(luò)數(shù)據(jù)的通用格式
3、接口安全,一定要增加接口驗(yàn)證。例如,客戶端和服務(wù)端針對不同接口統(tǒng)一做好加密方式,服務(wù)端在對于每次接口需要都要進(jìn)行驗(yàn)證。以保證防止接口被惡意刷新或黑客惡意調(diào)用,尤其是大型商業(yè)應(yīng)用。
4、對于線上的 API 必須保證所有接口正常且關(guān)閉所有的錯誤信息 => error_reporting(0),在輸出JSON 時,不能有任何其它輸出,否則,客戶端將會獲取錯誤的數(shù)據(jù)信息,98%直接導(dǎo)致客戶端 Crash!
5、開發(fā) API 和 WEB 有一定的區(qū)別,如果是 WEB 的話,可能代碼出錯了,不會導(dǎo)致特別嚴(yán)重的錯誤,也許只是導(dǎo)致數(shù)據(jù)寫入和查詢失敗,也許導(dǎo)致 WEB 的某個部分錯位或亂碼。但如果是 API,99%的情況都是客戶端直接Crash、閃退!
6、做接口開發(fā),不建議使用框架開發(fā),原因概括起來有兩點(diǎn)(其實(shí)我有點(diǎn)冒風(fēng)險的,本人也是 TPer 一枚,畢竟這是TP的官網(wǎng)):
客戶端一般對服務(wù)端的響應(yīng)速度有極高要求,因此,使用最原生態(tài)的 PHP完成接口開發(fā),是最高效的,假如用到了框架,還需要加載各種不需要多余的文件,就好比夏天穿了件冬天的衣服。試想,你在玩手機(jī)的時候,使用一個應(yīng)用隨便一個操作,等半天才有動靜,你受的了嗎?
就是上面第4點(diǎn)提到的,框架對于WEB開發(fā),是件很幸福的事,但對于 API 而言,你實(shí)在不敢想象它會給你出什么岔子!最后你將痛苦不堪~~因?yàn)楹芏嗫蚣芏际菫?WEB 誕生的(我也很期待有一天能看到專門為開發(fā) API 而生的框架或者擴(kuò)展)
說到這,不得不說扯一下,風(fēng)靡互聯(lián)網(wǎng)的開放平臺。其實(shí)那些開放平臺,所謂的開放,就是給你提供一個這樣的接口,你根據(jù)他們提供的技術(shù)文檔,按他們制定的格 式和要求,調(diào)它們提供的接口文件(一般都是返回JSON或者XML),你就可以獲取到他們的相關(guān)信息,例如:QQ用戶基本信息、淘寶店鋪、商品消息等等。 然后在根據(jù)這些消息,在你的應(yīng)用里完成交互。
推薦文章
2025-01-18
2024-11-28
2024-11-09
2024-10-25
2024-06-25
2024-01-04
2023-11-06
2023-10-30
2023-10-13
2023-10-10
穩(wěn)定
產(chǎn)品高可用性高并發(fā)貼心
項(xiàng)目群及時溝通專業(yè)
產(chǎn)品經(jīng)理1v1支持快速
MVP模式小步快跑承諾
我們選擇聲譽(yù)堅持
10年專注高端品質(zhì)開發(fā)聯(lián)系我們
友情鏈接: