_編程于我們,猶如著書而存世。表達,從簡單開始;代碼,亦然。 -- 暗夜在火星_
##接口,從簡單開始!
###一個隱喻
假設我們有這樣的表達式:
```
1 + 1 = 2
```
顯然,這是簡單明了而易于理解的。但倘若我們這樣:
```
1 + (96 - 867 + 700 - 6 + 7 - 30/10 + 100 - 27) + 1 = 2
```
同樣可以獲得相同的結果,但表達卻羞澀難懂。
你可能會偷笑:怎么可能會有人這樣編寫復雜又沒用的代碼呢?然而,如果你回顧一下曾經做過的項目或留意一下周圍的代碼,你會發現,這種情況是真實存在的。
當然,在不同領域的項目開發中,因各自需求不同各代碼的編寫也不盡相同。縱使這樣,即使我們不能簡化到最理想的狀態,但至少我們可以通過努力以達到“編寫人容易理解的代碼”。一如這樣:
```
1 + (0) + 1 = 2
```
###PhalApi框架所做的
使用PhalApi框架進行項目開發,我們不能保證項目編寫的代碼一定會“短而美”,因為更多的代碼編寫來自于你雙手的輸入、來自你自己切身的思考和設計。但我們希望PhalApi可以在支持接口快速開發的基礎上,為你和更多開發團隊提供關于項目開發的一些技藝、參考和幫助。
所以,與其他很多關注服務器性能的框架不同, **PhalApi更加關注的是人的心情、開發效率和團隊合作** ,而這些正是通過測試驅動開發、自動化工具、持續集成和敏捷開發等途徑來達成的 。
然而,這一切一切,都要從代碼的編寫開始。畢竟我們作為專業人士,代碼是我們連接世界的媒介。而接口代碼的編寫,又應從簡單開始。
泡一杯咖啡,讓我們開始吧。
###本框架和文檔適用于
1. 工匠:基于PHP語言的后臺接口項目開發,特別是創業項目的快速迭代
2. 探險者:進行定制和擴展,打造成公司內部產品簇的接口應用框架
3. 架構師:專注框架的設計、思想和開源
- 歡迎使用PhalApi!
- 接口,從簡單開始!
- [1.1]-下載與安裝
- [1.2]-創建一個自己的項目
- [1.3]-在線體驗
- [1.4]-文檔、幫助和官網
- [1.10]-對PhalApi框架的抉擇
- [1.11]-快速入門(backup)
- [1.12]-參數規則:接口參數規則配置
- [1.13]-統一的接口請求方式:_sevice=XXX.XXX
- [1.14]-統一的返回格式和結構:ret-data-msg
- [1.15]-數據庫操作:基于NotORM的使用及優化
- [1.16]-配置讀取:內外網環境配置的完美切換
- [1.17]-日記紀錄:簡化版的日記接口
- [1.18]-快速函數:人性化的關懷
- [1.19]-DI服務速查:各資源服務一覽表
- [1.20]-DB操作:數據庫基本操作速查
- [1.21]-類的自動加載:遵循PEAR包的命名規范
- [1.22]-簽名驗證:自定義簽名規則
- [1.23]-請求和響應:GET和POST兩者皆可得及超越JSON格式返回
- [1.24]-緩存策略:更靈活地可配置化的多級緩存
- [1.25]-國際化翻譯:為走向國際化提前做好翻譯準備
- [1.26]-數據安全:數據對稱加密方案
- [1.27]-精益開發:更富表現力的Model層和重量級數據獲取的應對方案
- [1.28]-COOKIE:對COOKIE原生態的支持及記憶加密升級版
- [1.29]-開放與封閉:多入口和統一初始化
- [1.30]-保持的力量:接口開發最佳實踐
- [1.31]-新型計劃任務:以接口形式實現的計劃任務
- [2.11]-核心思想:DI依賴注入-讓資源更可控
- [2.12]-海量數據:可配置的分庫分表
- [2.13]-接口調試:在線SQL語句查看與性能優化
- [2.14]-測試驅動開發:意圖導向編程下的接口開發
- [2.15]-演進:新型計劃任務續篇
- [2.16]-領域驅動設計:應對復雜領域業務的Domain層
- [2.17]-微服務:Api接口服務層
- [2.18]-定制化:資源服務的再實現
- [2.19]-擴展庫:可重用的擴展類庫
- [2.20]-約定編程:架構明顯的編程風格
- [2.21]-服務器統一部署方案簡明版:CentOs---Nginx---php-fpm---MySql-[--Memcached]
- [2.22]-更多工具:精益項目和團隊建設
- [3.1]-擴展類庫:微信開發
- [3.2]-擴展類庫:代理模式下phprpc協議的輕松支持
- [3.3]-擴展類庫:基于PHPMailer的郵件發送
- [3.4]-擴展類庫:優酷開放平臺接口調用
- [3.5]-擴展類庫:七牛云存儲接口調用
- [3.6]-擴展類庫:新型計劃任務
- [3.8]-擴展類庫:用戶、會話和第三方登錄集成
- [3.9]-擴展類庫:swoole支持下的長鏈接和異步任務實現
- [3.11]-擴展類庫:基于FastRoute的快速路由
- [4.2]-開發實戰2:模擬優酷開放平臺接口項目開發
- [4.3]-開發實戰3:一個簡單的小型項目開發(奔跑吧兄弟投票活動)
- [5.1]-架構與思想:PhalApi核心設計和思想解讀
- [5.2]-雜談:扯一些PhalApi的前世和今生
- [5.3]-框架總結:術語表和PHP開發建議
- [5.4]-許可
- [5.5]-聯系和加入我們
- [5.6]-更新日記
- [5.8]-致框架貢獻者:加入PhalApi開源指南
- [6.1]-基于接口查詢語言的SDK包
- [6.2]-SDK包(JAVA版)
- [6.3]-SDK包(PHP版)
- [6.4]-SDK包(Objective-C版)
- [6.5]-SDK包(javascript版)
- [6.6]-SDK包(Ruby版)
- [8.1]-PhalApi視頻教程
- 附錄1:接口文檔參考模板