在php中調(diào)用接口以及編寫接口

如:

http://localhost/openUser.php?act=get_user_list&type=json

在這里openUser.php相當(dāng)于一個(gè)接口,其中g(shù)et_user_list 是一個(gè)API(獲取用戶列表),講求返回的數(shù)據(jù)類型為JSON格式。

你只需要在你PHP代碼中執(zhí)行這條鏈接他就會(huì)返回。

GET方式的直接使用

$file_contents = file_get_content('http://localhost/openUser.php?act=get_user_list&type=json')

POST方式得用下面的(需要開啟PHP curl支持)。

$url = 'http://localhost/openUser.php?act=get_user_list&type=json';

$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 中編寫接口

一、先簡單回答兩個(gè)問題:

1、PHP 可以開發(fā)客戶端?

答:不可以,因?yàn)镻HP是腳本語言,是負(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)用程序編程接口) 呢?

做過 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ù),都會(huì)由客戶端傳過來,也許是 GET 也許是 POST,這個(gè)需要開發(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)行交互

臨時(shí)寫的一個(gè)簡單 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ù)庫

$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',//消息提示,客戶端常會(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)擊測試(對(duì)于客戶端而言,也是直接調(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)目中,我們?cè)陂_發(fā) API 應(yīng)該注意的幾個(gè)事項(xiàng)(僅供參考):

1、單文件實(shí)現(xiàn)多接口的形式有很多種,例如:if..elseif.. 或 switch 或 動(dòng)態(tài)方法 (也就是TP的這種訪問函數(shù)體的形式)

2、對(duì)于數(shù)據(jù)的輸出最好用json,json具有相當(dāng)強(qiáng)大的跨平臺(tái)性,市場上各大主流編程語言都支持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ā),原因概括起來有兩點(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)定性,還得看編碼的人,有的人可能寫的還不如框架跑的快,也有人覺得用框架沒什么問題,這里只是建議,關(guān)鍵看自己的實(shí)際情況,同時(shí)建議代碼上線前壓測一下

說到這,不得不說扯一下,騰訊微博淘寶等開放平臺(tái)。其實(shí)那些開放平臺(tái),所謂的開放,就是給你提供一個(gè)這樣的接口,你根據(jù)他們提供的技術(shù)文檔,按他們制定的格式和要求,調(diào)它們提供的接口文件(一般都是返回JSON或者XML),你就可以獲取到他們的相關(guān)信息,例如:QQ用戶基本信息、淘寶店鋪、商品消息等等。然后在根據(jù)這些消息,在你的應(yīng)用里完成交互。

其實(shí),ajax 也是調(diào)用 API 的接口

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請(qǐng)聯(lián)系作者
【社區(qū)內(nèi)容提示】社區(qū)部分內(nèi)容疑似由AI輔助生成,瀏覽時(shí)請(qǐng)結(jié)合常識(shí)與多方信息審慎甄別。
平臺(tái)聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡書系信息發(fā)布平臺(tái),僅提供信息存儲(chǔ)服務(wù)。

相關(guān)閱讀更多精彩內(nèi)容

  • Spring Cloud為開發(fā)人員提供了快速構(gòu)建分布式系統(tǒng)中一些常見模式的工具(例如配置管理,服務(wù)發(fā)現(xiàn),斷路器,智...
    卡卡羅2017閱讀 136,618評(píng)論 19 139
  • 發(fā)現(xiàn) 關(guān)注 消息 iOS 第三方庫、插件、知名博客總結(jié) 作者大灰狼的小綿羊哥哥關(guān)注 2017.06.26 09:4...
    肇東周閱讀 15,421評(píng)論 4 61
  • 紙質(zhì)名片好多內(nèi)容展示不出來、發(fā)了沒人看、沒有新意、不便攜帶易丟失...那么yo名片來了!yo名片真正的讓名片實(shí)現(xiàn)互...
    往來獵頭人閱讀 248評(píng)論 0 0
  • 3至5歲的孩子最愛問“媽媽,我是從哪兒來的呢?”,父母該怎樣回答呢? 許多父母為了省事,煞有介事的告訴孩子: 你是...
    立體故事閱讀 401評(píng)論 0 0
  • 初到重慶,是今年元旦。不過從去年九月起,便對(duì)這個(gè)城市魂?duì)繅艨M。 去年九月,我開始了我的大學(xué)時(shí)光,一切青澀而...
    華燈初上_c0d7閱讀 697評(píng)論 0 2

友情鏈接更多精彩內(nèi)容