PHP開發API
作為最流行的服務端語言PHP(PHP: Hypertext Preprocessor),在開發API方面,是很簡單且極具優勢的
這篇文章寫給不太瞭解PHP開發API介面的開發者
PHP交流群:294088839
Python交流群:652376983
一、先簡單回答兩個問題
1、PHP 可以開發客戶端嗎?
答:正確的回答是,不適合,因為PHP是服務端指令碼語言,負責 B/S或C/S 架構的S部分,即:Server端的開發。
(別去糾結 GTK、WinBinder)
2、為什麼選擇 PHP 作為開發服務端的首選?
答:跨平臺(可以執行在UNIX、LINUX、WINDOWS、Mac OS下)、低消耗(PHP消耗相當少的系統資源)、執行效率高(相對而言)、MySQL的完美搭檔,本身是免費開源的,......
二、如何使用 PHP 開發 API 呢?
有興趣細研究的,可以先看看百科介紹:http://baike.baidu.com/item/api/10154
百科寫的比較泛,嫌文字多?好吧,那就不看了,先了解下 API 是什麼鬼
1、API 比開發 WEB 更簡潔,但可能邏輯更復雜,API 只返回結果,也就是隻完成資料輸出,不呈現頁面,
2、WEB 開發,更多的是 GET 和 POST 請求,API 還有 PUT、DELETE 請求
3、和 WEB 開發一樣,首先需要一些相關的引數,這些引數,都會由客戶端傳過來,也許是 GET 也許是 POST,這個需要開發團隊相互之間約定好,或者制定統一規範
4、有了引數,根據應用需求,完成資料處理,例如:獲取使用者資訊、發朋友圈、發訊息、一局遊戲結束資料提交等等
5、資料邏輯處理完之後,返回客戶端所需要用到的相關資料,例如:使用者資訊陣列、朋友圈列表、訊息狀態、遊戲結果資料等等,那資料是怎麼返給客戶端呢?常見有XML、JSON,設定相應的header並把要返回的資料直接列印出來即可
6、客戶端獲取到你返回的資料後,在客戶端本地和使用者進行互動
所以我們大概知道,API 其實不存在Web領域的 MVC 架構模式,若要分層的,API 也只有 M 和 C 兩層,當然,後端可能會有更加複雜的架構!
通過下面一個HTTP協議的API例項來理解PHP怎麼開發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 |
|
把它部署到伺服器之後,任何語言都可以通過HTTP協議呼叫諸如下面的URL介面:
http://demo.979137.com/api/test/user.php
http://demo.979137.com/api/test/user.php?a=info&qq=979137&ticket=test
http://demo.979137.com/api/test/user.php?a=info&qq=979138&ticket=test
http://demo.979137.com/api/test/user.php?a=friends&qq=979137&ticket=test
http://demo.979137.com/api/test/user.php?a=fuck&qq=979137&ticket=test
介面輸出示例,返回的是一串json:
1 2 3 4 5 6 7 8 9 10 11 12 |
|
json具有很強的跨平臺性,幾乎每種語言都有解析json的函式,下面是一個PHP作為客戶端呼叫的示例:
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 |
|
頁面輸出結果:
1 2 3 4 5 6 7 8 9 10 11 12 13 |
|
實際業務中,就是拿到了介面返回的資料之後,結合自身的業務為使用者提供服務!
三、實際專案中,我們在開發 API 時應該注意的幾個點(僅供參考)
1、單檔案實現多介面的形式有很多種,例如:if..elseif.. 或 switch 或 很多框架裡用到的統一入口通過呼叫類函式的形式實現
2、資料輸出建議使用json,json具有很強的跨平臺性,大多程式語言都支援json解析,json正在逐步取代xml,成為網路資料的通用格式
3、為了保證介面安全,一定要加入鑑權體系
4、對於線上的API,務必關閉所有錯誤顯示,可以把錯誤寫到日誌裡,PHP中,可以通過 error_reporting(0) 遮蔽所有錯誤
這樣做的目的,一方面是保護介面安全,防止輸出不該列印的錯誤資訊
另一方面是保證輸出的是正確的資料格式,如json,假如不是標準的json格式,客戶端在解析時就會出錯,由此影響客戶端的正常運轉
PS:我們平時在使用手機APP時,手機會閃退,多半是這個原因,即介面呼叫異常
5、開發 API 和 WEB 有一定的區別,如果是 WEB 的話,如果程式寫的有問題,比如有個notice 或 warning 級別的錯誤,在 WEB 裡可能不會有什麼問題,也許就只是導致 WEB 的某個部分錯位或亂碼。但如果是 API,就會嚴重呼叫的客戶端了,如果是手機APP,那閃推啥的,是必然的,如果同樣也是Web呼叫,也可能會出現 Server Error 了
6、一定要重點考慮穩定性和響應速度,因為我們在使用手機APP時,都不希望APP經常閃推、而且希望應用很流暢
7、不要隨便使用一些 PHP 開源框架,原因概括起來有兩點:
1)如6所述,客戶端一般對 API 響應速度有極高要求,目前PHP領域的開源框架非常多,根據筆者的瞭解,目前比較流行的框架,普遍做的比較重,而且基本都是為WEB而生,因此,框架多了很多 API 用不到的東西,框架在載入和執行冗餘檔案時,實際是在消耗你的效能
2)如4和5所述,框架對於WEB開發,是件很幸福的事,但對於 API 而言,你實在不敢想象它會給你出什麼岔子,因為很多框架並沒有全面的考慮到 API 場景
相關文章
- PHP開發api介面,如何做才算是安全的PHPAPI
- 淘寶訂單評論API文件分析,PHP開發攻略APIPHP
- PHP做api開發離不開簽名驗證,我這樣設計PHPAPI
- API開發平臺,提高API開發及管理效率API
- PHP 開發量化交易的工具,模擬交易所 API 資料。PHPAPI
- php開發memcachedPHP
- Laravel 開發 API 心得LaravelAPI
- php 開發規範PHP
- PHP開發環境PHP開發環境
- PHP 開發基礎PHP
- API介面開發規範API
- SAP API開發方法大全API
- Go API 開發基礎GoAPI
- PHP 開發工程師基礎篇 - PHP 字串PHP工程師字串
- PHP微信支付開發PHP
- PHP 日常開發備忘PHP
- 開發php擴充套件PHP套件
- PhpStorm 9,PHP整合開發PHPORM
- 我是 Laravel 開發員,不是 PHP 開發員LaravelPHP
- Web 開發手冊——PHP 開發環境搭建WebPHP開發環境
- 【開發者福利】公開API的使用API
- laravel 結合JWT開發APILaravelJWTAPI
- Laravel 使用 passport 開發 API 介面LaravelPassportAPI
- leacmf通用api開發後臺ACMAPI
- JavaWeb開發基礎Servlet APIJavaWebServletAPI
- API介面開發簡述示例API
- laravel 使用路由api.phpLaravel路由APIPHP
- PHP 呼叫 ES API 小插曲PHPAPI
- php請求API介面方法PHPAPI
- Mac搭建PHP開發環境(PHP+Nginx+MySQL)MacPHP開發環境NginxMySql
- PHP 開發工程師基礎篇 (PHP 陣列)PHP工程師陣列
- MacOS PHP 開發環境配置MacPHP開發環境
- Docker配置PHP開發環境DockerPHP開發環境
- Mac 搭建 PHP 開發環境MacPHP開發環境
- PHP開發者成長圖PHP
- PhpStorm 2021 for Mac(PHP整合開發)PHPORMMac
- Go開發PHP擴充套件GoPHP套件
- PHP整合開發工具:PhpStorm 2022PHPORM
- PhpStorm 2022 for Mac(php整合開發)PHPORMMac