自拍偷在线精品自拍偷,亚洲欧美中文日韩v在线观看不卡

從0開始構(gòu)建一個屬于你自己的PHP框架

開發(fā) 后端
為什么我們要去構(gòu)建一個自己的PHP框架?可能絕大多數(shù)的人都會說“市面上已經(jīng)那么多的框架了,還造什么輪子?”。我的觀點“造輪子不是目的,造輪子的過程中汲取到知識才是目的”。

從0開始構(gòu)建一個屬于你自己的PHP框架

英文版

如何構(gòu)建一個自己的PHP框架

為什么我們要去構(gòu)建一個自己的PHP框架?可能絕大多數(shù)的人都會說“市面上已經(jīng)那么多的框架了,還造什么輪子?”。我的觀點“造輪子不是目的,造輪子的過程中汲取到知識才是目的”。

從0開始構(gòu)建一個屬于你自己的PHP框架

那怎樣才能構(gòu)建一個自己的PHP框架呢?大致流程如下:

  1. 入口文件 ----> 注冊自加載函數(shù) 
  2.         ----> 注冊錯誤(和異常)處理函數(shù) 
  3.         ----> 加載配置文件 
  4.         ----> 請求 
  5.         ----> 路由  
  6.         ---->(控制器 <----> 數(shù)據(jù)模型) 
  7.         ----> 響應(yīng) 
  8.         ----> json 
  9.         ----> 視圖渲染數(shù)據(jù) 

除此之外我們還需要單元測試、nosql支持、接口文檔支持、一些輔助腳本等。最終我的框架目錄如下:

框架目錄一覽

  1. app                             [PHP應(yīng)用目錄] 
  2. ├── demo                        [模塊目錄] 
  3. │   ├── controllers             [控制器目錄] 
  4. │   │      └── Index.php        [默認(rèn)控制器文件,輸出json數(shù)據(jù)] 
  5. │   ├── logics                  [邏輯層,主要寫業(yè)務(wù)邏輯的地方] 
  6. │   │   ├── exceptions          [異常目錄] 
  7. │   │   ├── gateway            [一個邏輯層實現(xiàn)的gateway演示] 
  8. │   │   ├── tools               [工具類目錄] 
  9. │   │   └── UserDefinedCase.php [注冊框架加載到路由前的處理用例] 
  10. │   └── models                  [數(shù)據(jù)模型目錄] 
  11. │       └── TestTable.php       [演示模型文件,定義一一對應(yīng)的數(shù)據(jù)模型] 
  12. ├── config                      [配置目錄] 
  13. │    ├── demo                   [模塊配置目錄] 
  14. │    │   ├── config.php         [模塊自定義配置] 
  15. │    │   └── route.php          [模塊自定義路由] 
  16. │    ├── common.php             [公共配置] 
  17. │    ├── database.php           [數(shù)據(jù)庫配置] 
  18. │    └── nosql.php              [nosql配置] 
  19. docs                            [接口文檔目錄] 
  20. ├── apib                        [Api Blueprint] 
  21. │    └── demo.apib              [接口文檔示例文件] 
  22. ├── swagger                     [swagger] 
  23. framework                       [Easy PHP核心框架目錄] 
  24. ├── exceptions                  [異常目錄] 
  25. │      ├── CoreHttpException.php[核心http異常] 
  26. ├── handles                     [框架運行時掛載處理機(jī)制類目錄] 
  27. │      ├── Handle.php           [處理機(jī)制接口] 
  28. │      ├── ErrorHandle.php      [錯誤處理機(jī)制類] 
  29. │      ├── ExceptionHandle.php  [未捕獲異常處理機(jī)制類] 
  30. │      ├── ConfigHandle.php     [配置文件處理機(jī)制類] 
  31. │      ├── NosqlHandle.php      [nosql處理機(jī)制類] 
  32. │      ├── LogHandle.php        [log機(jī)制類] 
  33. │      ├── UserDefinedHandle.php[用戶自定義處理機(jī)制類] 
  34. │      └── RouterHandle.php     [路由處理機(jī)制類] 
  35. ├── orm                         [對象關(guān)系模型] 
  36. │      ├── Interpreter.php      [sql解析器] 
  37. │      ├── DB.php               [數(shù)據(jù)庫操作類] 
  38. │      ├── Model.php            [數(shù)據(jù)模型基類] 
  39. │      └── db                   [數(shù)據(jù)庫類目錄] 
  40. │          └── Mysql.php        [mysql實體類] 
  41. ├── nosql                       [nosql類目錄] 
  42. │    ├── Memcahed.php           [Memcahed類文件] 
  43. │    ├── MongoDB.php            [MongoDB類文件] 
  44. │    └── Redis.php              [Redis類文件] 
  45. ├── App.php                     [框架類] 
  46. ├── Container.php               [服務(wù)容器] 
  47. ├── Helper.php                  [框架助手類] 
  48. ├── Load.php                    [自加載類] 
  49. ├── Request.php                 [請求類] 
  50. ├── Response.php                [響應(yīng)類] 
  51. ├── run.php                     [框架應(yīng)用啟用腳本] 
  52. frontend                        [前端源碼和資源目錄] 
  53. ├── src                         [資源目錄] 
  54. │    ├── components             [vue組件目錄] 
  55. │    ├── views                  [vue視圖目錄] 
  56. │    ├── images                 [圖片] 
  57. │    ├── ... 
  58. ├── app.js                      [根js] 
  59. ├── app.vue                     [根組件] 
  60. ├── index.template.html         [前端入口文件模板] 
  61. ├── store.js                    [vuex store文件] 
  62. public                          [公共資源目錄,暴露到萬維網(wǎng)] 
  63. ├── dist                        [前端build之后的資源目錄,build生成的目錄,不是發(fā)布分支忽略該目錄] 
  64. │    └── ... 
  65. ├── index.html                  [前端入口文件,build生成的文件,不是發(fā)布分支忽略該文件] 
  66. ├── index.php                   [后端入口文件] 
  67. runtime                         [臨時目錄] 
  68. ├── logs                        [日志目錄] 
  69. ├── build                       [php打包生成phar文件目錄] 
  70. tests                           [單元測試目錄] 
  71. ├── demo                        [模塊名稱] 
  72. │      └── DemoTest.php         [測試演示] 
  73. ├── TestCase.php                [測試用例] 
  74. vendor                          [composer目錄] 
  75. .git-hooks                      [git鉤子目錄] 
  76. ├── pre-commit                  [git pre-commit預(yù)commit鉤子示例文件] 
  77. ├── commit-msg                  [git commit-msg示例文件] 
  78. .babelrc                        [babel配置文件] 
  79. .env                            [環(huán)境變量文件] 
  80. .gitignore                      [git忽略文件配置] 
  81. build                           [php打包腳本] 
  82. cli                             [框架cli模式運行腳本] 
  83. LICENSE                         [lincese文件] 
  84. logo.png                        [框架logo圖片] 
  85. composer.json                   [composer配置文件] 
  86. composer.lock                   [composer lock文件] 
  87. package.json                    [前端依賴配置文件] 
  88. phpunit.xml                     [phpunit配置文件] 
  89. README-CN.md                    [中文版readme文件] 
  90. README.md                       [readme文件] 
  91. webpack.config.js               [webpack配置文件] 
  92. yarn.lock                       [yarn lock文件] 

框架模塊說明:

入口文件

定義一個統(tǒng)一的入口文件,對外提供統(tǒng)一的訪問文件。對外隱藏了內(nèi)部的復(fù)雜性,類似企業(yè)服務(wù)總線的思想。

  1. // 載入框架運行文件  
  2. require('../framework/run.php'); 

[ file: public/index.php ]

自加載模塊

使用spl_autoload_register函數(shù)注冊自加載函數(shù)到__autoload隊列中,配合使用命名空間,當(dāng)使用一個類的時候可以自動載入(require)類文件。注冊完成自加載邏輯后,我們就可以使用use和配合命名空間申明對某個類文件的依賴。

[ file: framework/Load.php ]

錯誤和異常模塊

腳本運行期間:

  • 錯誤:

通過函數(shù)set_error_handler注冊用戶自定義錯誤處理方法,但是set_error_handler不能處理以下級別錯誤,E_ERROR、 E_PARSE、 E_CORE_ERROR、 E_CORE_WARNING、 E_COMPILE_ERROR、 E_COMPILE_WARNING,和在 調(diào)用 set_error_handler() 函數(shù)所在文件中產(chǎn)生的大多數(shù) E_STRICT。所以我們需要使用register_shutdown_function配合error_get_last獲取腳本終止執(zhí)行的***錯誤,目的是對于不同錯誤級別和致命錯誤進(jìn)行自定義處理,例如返回友好的提示的錯誤信息。

[ file: framework/hanles/ErrorHandle.php ]

異常:

通過函數(shù)set_exception_handler注冊未捕獲異常處理方法,目的捕獲未捕獲的異常,例如返回友好的提示和異常信息。

[ file: framework/hanles/ExceptionHandle.php ]

配置文件模塊

加載框架自定義和用戶自定義的配置文件。

[ file: framework/hanles/ConfigHandle.php ]

輸入和輸出

  • 定義請求對象:包含所有的請求信息
  • 定義響應(yīng)對象:申明響應(yīng)相關(guān)信息

框架中所有的異常輸出和控制器輸出都是json格式,因為我認(rèn)為在前后端完全分離的今天,這是很友善的,目前我們不需要再去考慮別的東西。

[ file: framework/Request.php ]

[ file: framework/Response.php ]

路由模塊

通過用戶訪問的url信息,通過路由規(guī)則執(zhí)行目標(biāo)控制器類的的成員方法。我在這里把路由大致分成了四類:

傳統(tǒng)路由

  1. domain/index.php?module=Demo&contoller=Index&action=test&username=test 

pathinfo路由

  1. domain/demo/index/modelExample 

用戶自定義路由

  1. // 定義在config/moduleName/route.php文件中,這個的this指向RouterHandle實例 
  2. $this->get('v1/user/info'function (Framework\App $app) { 
  3.     return 'Hello Get Router'
  4. }); 

微單體路由

我在這里詳細(xì)說下這里所謂的微單體路由,面向SOA和微服務(wù)架構(gòu)大行其道的今天,有很多的團(tuán)隊都在向服務(wù)化邁進(jìn),但是服務(wù)化過程中很多問題的復(fù)雜度都是指數(shù)級的增長,例如分布式的事務(wù),服務(wù)部署,跨服務(wù)問題追蹤等等。這導(dǎo)致對于小的團(tuán)隊從單體架構(gòu)走向服務(wù)架構(gòu)難免困難重重,所以有人提出來了微單體架構(gòu),按照我的理解就是在一個單體架構(gòu)的SOA過程,我們把微服務(wù)中的的各個服務(wù)還是以模塊的方式放在同一個單體中,比如:

  1. app 
  2. ├── UserService     [用戶服務(wù)模塊] 
  3. ├── ContentService  [內(nèi)容服務(wù)模塊] 
  4. ├── OrderService    [訂單服務(wù)模塊] 
  5. ├── CartService     [購物車服務(wù)模塊] 
  6. ├── PayService      [支付服務(wù)模塊] 
  7. ├── GoodsService    [商品服務(wù)模塊] 
  8. └── CustomService   [客服服務(wù)模塊] 

如上,我們簡單的在一個單體里構(gòu)建了各個服務(wù)模塊,但是這些模塊怎么通信呢?如下:

  1. App::$app->get('demo/index/hello', [ 
  2.     'user' => 'TIGERB' 
  3. ]); 

通過上面的方式我們就可以松耦合的方式進(jìn)行單體下各個模塊的通信和依賴了。與此同時,業(yè)務(wù)的發(fā)展是難以預(yù)估的,未來當(dāng)我們向SOA的架構(gòu)遷移時,很簡單,我們只需要把以往的模塊獨立成各個項目,然后把App實例get方法的實現(xiàn)轉(zhuǎn)變?yōu)镽PC或者REST的策略即可,我們可以通過配置文件去調(diào)整對應(yīng)的策略或者把自己的,第三方的實現(xiàn)注冊進(jìn)去即可。

[ file: framework/hanles/RouterHandle.php ]

傳統(tǒng)的MVC模式提倡為MCL模式

傳統(tǒng)的MVC模式包含model-view-controller層,絕大多時候我們會把業(yè)務(wù)邏輯寫到controller層或model層,但是慢慢的我們會發(fā)現(xiàn)代碼難以閱讀、維護(hù)、擴(kuò)展,所以我在這里強(qiáng)制增加了一個logics層。至于,邏輯層里怎么寫代碼怎么,完全由你自己定義,你可以在里面實現(xiàn)一個工具類,你也可以在里面再新建子文件夾并在里面構(gòu)建你的業(yè)務(wù)邏輯代碼,你甚至可以實現(xiàn)一個基于責(zé)任連模式的網(wǎng)關(guān)(我會提供具體的示例)。這樣看來,我們的最終結(jié)構(gòu)是這樣的:

  • M: models, 職責(zé)只涉及數(shù)據(jù)模型相關(guān)操作
  • C: controllers, 職責(zé)對外暴露資源,前后端分離架構(gòu)下controllers其實就相當(dāng)于json格式的視圖
  • L: logics, 職責(zé)靈活實現(xiàn)所有業(yè)務(wù)邏輯的地方

logics邏輯層

邏輯層實現(xiàn)網(wǎng)關(guān)示例:

我們在logics層目錄下增加了一個gateway目錄,然后我們就可以靈活的在這個目錄下編寫邏輯了。gateway的結(jié)構(gòu)如下:

  1. gateway                     [Logics層目錄下gateway邏輯目錄] 
  2.   ├── Check.php             [接口] 
  3.   ├── CheckAppkey.php       [檢驗app key
  4.   ├── CheckArguments.php    [校驗必傳參數(shù)] 
  5.   ├── CheckAuthority.php    [校驗訪問權(quán)限] 
  6.   ├── CheckFrequent.php     [校驗訪問頻率] 
  7.   ├── CheckRouter.php       [網(wǎng)關(guān)路由] 
  8.   ├── CheckSign.php         [校驗簽名] 
  9.   └── Entrance.php          [網(wǎng)關(guān)入口文件] 

網(wǎng)關(guān)入口類主要負(fù)責(zé)網(wǎng)關(guān)的初始化,代碼如下:

  1. // 初始化一個:必傳參數(shù)校驗的check 
  2. $checkArguments   =  new CheckArguments(); 
  3. // 初始化一個:app key check 
  4. $checkAppkey      =  new CheckAppkey(); 
  5. // 初始化一個:訪問頻次校驗的check 
  6. $checkFrequent    =  new CheckFrequent(); 
  7. // 初始化一個:簽名校驗的check 
  8. $checkSign        =  new CheckSign(); 
  9. // 初始化一個:訪問權(quán)限校驗的check 
  10. $checkAuthority   =  new CheckAuthority(); 
  11. // 初始化一個:網(wǎng)關(guān)路由規(guī)則 
  12. $checkRouter      =  new CheckRouter(); 
  13.  
  14. // 構(gòu)成對象鏈 
  15. $checkArguments->setNext($checkAppkey) 
  16.                ->setNext($checkFrequent) 
  17.                ->setNext($checkSign) 
  18.                ->setNext($checkAuthority) 
  19.                ->setNext($checkRouter); 
  20.  
  21. // 啟動網(wǎng)關(guān) 
  22. $checkArguments->start( 
  23.     APP::$container->getSingle('request'
  24. ); 

實現(xiàn)完成這個gateway之后,我們?nèi)绾卧诳蚣苤腥ナ褂媚?在logic層目錄中我提供了一個user-defined的實體類,我們把gateway的入口類注冊到UserDefinedCase這個類中,示例如下:

  1. /** 
  2.  * 注冊用戶自定義執(zhí)行的類 
  3.  * 
  4.  * @var array 
  5.  */ 
  6. private $map = [ 
  7.     // 演示 加載自定義網(wǎng)關(guān) 
  8.     'App\Demo\Logics\Gateway\Entrance' 
  9. ]; 

這樣這個gateway就可以工作了。接著說說這個UserDefinedCase類,UserDefinedCase會在框架加載到路由機(jī)制之前被執(zhí)行,這樣我們就可以靈活的實現(xiàn)一些自定義的處理了。這個gateway只是個演示,你完全可以天馬行空的組織你的邏輯~

視圖View去哪了?由于選擇了完全的前后端分離和SPA(單頁應(yīng)用), 所以傳統(tǒng)的視圖層也因此去掉了,詳細(xì)的介紹看下面。

[ file: app/* ]

使用Vue作為視圖

源碼目錄

完全的前后端分離,數(shù)據(jù)雙向綁定,模塊化等等的大勢所趨。這里我把我自己開源的vue前端項目結(jié)構(gòu) easy-vue 移植到了這個項目里,作為視圖層。我們把前端的源碼文件都放在frontend目錄里,詳細(xì)如下,你也可以自己定義:

  1. frontend                        [前端源碼和資源目錄,這里存放我們整個前端的源碼文件] 
  2. ├── src                         [資源目錄] 
  3. │    ├── components             [編寫我們的前端組件] 
  4. │    ├── views                  [組裝我們的視圖] 
  5. │    ├── images                 [圖片] 
  6. │    ├── ... 
  7. ├── app.js                      [根js] 
  8. ├── app.vue                     [根組件] 
  9. ├── index.template.html         [前端入口文件模板] 
  10. └── store.js                    [狀態(tài)管理,這里只是個演示,你可以很靈活的編寫文件和目錄] 

build步驟

  1. yarn install  
  2. DOMAIN=http://你的域名 npm run dev 

編譯后

build成功之后會生成dist目錄和入口文件index.html在public目錄中。非發(fā)布分支.gitignore文件會忽略這些文件,發(fā)布分支去除忽略即可。

  1. public [公共資源目錄,暴露到萬維網(wǎng)]  
  2. ├── dist [前端build之后的資源目錄,build生成的目錄,不是發(fā)布分支忽略該目錄] 
  3. │ └── ...  
  4. ├── index.html [前端入口文件,build生成的文件,不是發(fā)布分支忽略該文件] 

[ file: frontend/* ]

數(shù)據(jù)庫對象關(guān)系映射

數(shù)據(jù)庫對象關(guān)系映射ORM(Object Relation Map)是什么?按照我目前的理解:顧名思義是建立對象和抽象事物的關(guān)聯(lián)關(guān)系,在數(shù)據(jù)庫建模中model實體類其實就是具體的表,對表的操作其實就是對model實例的操作。可能絕大多數(shù)的人都要問“為什么要這樣做,直接sql語句操作不好嗎?搞得這么麻煩!”,我的答案:直接sql語句當(dāng)然可以,一切都是靈活的,但是從一個項目的 可復(fù)用,可維護(hù), 可擴(kuò)展 出發(fā),采用ORM思想處理數(shù)據(jù)操作是理所當(dāng)然的,想想如果若干一段時間你看見代碼里大段的難以閱讀且無從復(fù)用的sql語句,你是什么樣的心情。

市面上對于ORM的具體實現(xiàn)有thinkphp系列框架的Active Record,yii系列框架的Active Record,laravel系列框架的Eloquent(據(jù)說是***雅的),那我們這里言簡意賅就叫ORM了。接著為ORM建模,首先是ORM客戶端實體DB:通過配置文件初始化不同的db策略,并封裝了操作數(shù)據(jù)庫的所有行為,最終我們通過DB實體就可以直接操作數(shù)據(jù)庫了,這里的db策略目前我只實現(xiàn)了mysql(負(fù)責(zé)建立連接和db的底層操作)。接著我們把DB實體的sql解析功能獨立成一個可復(fù)用的sql解析器的trait,具體作用:把對象的鏈?zhǔn)讲僮鹘馕龀删唧w的sql語句。***,建立我們的模型基類model,model直接繼承DB即可。***的結(jié)構(gòu)如下:

  1. ├── orm                         [對象關(guān)系模型] 
  2. │      ├── Interpreter.php      [sql解析器] 
  3. │      ├── DB.php               [數(shù)據(jù)庫操作類] 
  4. │      ├── Model.php            [數(shù)據(jù)模型基類] 
  5. │      └── db                   [數(shù)據(jù)庫類目錄] 
  6. │          └── Mysql.php        [mysql實體類] 

DB類使用示例

  1. /** 
  2.  * DB操作示例 
  3.  * 
  4.  * findAll 
  5.  * 
  6.  * @return void 
  7.  */ 
  8. public function dbFindAllDemo() 
  9.     $where = [ 
  10.         'id'   => ['>=', 2], 
  11.     ]; 
  12.     $instance = DB::table('user'); 
  13.     $res      = $instance->where($where
  14.                          ->orderBy('id asc'
  15.                          ->limit(5) 
  16.                          ->findAll(['id','create_at']); 
  17.     $sql      = $instance->sql; 
  18.  
  19.     return $res; 

Model類使用示例

  1. // controller 代碼 
  2. /** 
  3.  * model example 
  4.  * 
  5.  * @return mixed 
  6.  */ 
  7. public function modelExample() 
  8.     try {  
  9.         DB::beginTransaction(); 
  10.         $testTableModel = new TestTable(); 
  11.  
  12.         // find one data 
  13.         $testTableModel->modelFindOneDemo(); 
  14.         // find all data 
  15.         $testTableModel->modelFindAllDemo(); 
  16.         // save data 
  17.         $testTableModel->modelSaveDemo(); 
  18.         // delete data 
  19.         $testTableModel->modelDeleteDemo(); 
  20.         // update data 
  21.         $testTableModel->modelUpdateDemo([ 
  22.                'nickname' => 'easy-php' 
  23.             ]); 
  24.         // count data 
  25.         $testTableModel->modelCountDemo(); 
  26.  
  27.         DB::commit(); 
  28.         return 'success'
  29.  
  30.     } catch (Exception $e) { 
  31.         DB::rollBack(); 
  32.         return 'fail'
  33.     } 
  34.  
  35. //TestTable model 
  36. /** 
  37.  * Model操作示例 
  38.  * 
  39.  * findAll 
  40.  * 
  41.  * @return void 
  42.  */ 
  43. public function modelFindAllDemo() 
  44.     $where = [ 
  45.         'id'   => ['>=', 2], 
  46.     ]; 
  47.     $res = $this->where($where
  48.                 ->orderBy('id asc'
  49.                 ->limit(5) 
  50.                 ->findAll(['id','create_at']); 
  51.     $sql = $this->sql; 
  52.  
  53.     return $res; 

[ file: framework/orm/* ]

服務(wù)容器模塊

什么是服務(wù)容器?

服務(wù)容器聽起來很浮,按我的理解簡單來說就是提供一個第三方的實體,我們把業(yè)務(wù)邏輯需要使用的類或?qū)嵗⑷氲竭@個第三方實體類中,當(dāng)需要獲取類的實例時我們直接通過這個第三方實體類獲取。

服務(wù)容器的意義?

用設(shè)計模式來講:其實不管設(shè)計模式還是實際編程的經(jīng)驗中,我們都是強(qiáng)調(diào)“高內(nèi)聚,松耦合”,我們做到高內(nèi)聚的結(jié)果就是每個實體的作用都是極度專一,所以就產(chǎn)生了各個作用不同的實體類。在組織一個邏輯功能時,這些細(xì)化的實體之間就會不同程度的產(chǎn)生依賴關(guān)系,對于這些依賴我們通常的做法如下:

  1. class Demo 
  2.     public function __construct() 
  3.     { 
  4.         // 類demo直接依賴RelyClassName 
  5.         $instance = new RelyClassName(); 
  6.     } 

這樣的寫法沒有什么邏輯上的問題,但是不符合設(shè)計模式的“最少知道原則”,因為之間產(chǎn)生了直接依賴,整個代碼結(jié)構(gòu)不夠靈活是緊耦合的。所以我們就提供了一個第三方的實體,把直接依賴轉(zhuǎn)變?yōu)橐蕾囉诘谌?,我們獲取依賴的實例直接通過第三方去完成以達(dá)到松耦合的目的,這里這個第三方充當(dāng)?shù)慕巧皖愃葡到y(tǒng)架構(gòu)中的“中間件”,都是協(xié)調(diào)依賴關(guān)系和去耦合的角色。***,這里的第三方就是所謂的服務(wù)容器。

在實現(xiàn)了一個服務(wù)容器之后,我把Request,Config等實例都以單例的方式注入到了服務(wù)容器中,當(dāng)我們需要使用的時候從容器中獲取即可,十分方便。使用如下:

  1. // 注入單例 
  2. App::$container->setSingle('別名,方便獲取''對象/閉包/類名'); 
  3.  
  4. // 例,注入Request實例 
  5. App::$container->setSingle('request'function () { 
  6.     // 匿名函數(shù)懶加載 
  7.     return new Request(); 
  8. }); 
  9. // 獲取Request對象 
  10. App::$container->getSingle('request'); 

[ file: framework/Container ]

Nosql模塊

提供對nosql的支持,提供全局單例對象,借助我們的服務(wù)容器我們在框架啟動的時候,通過配置文件的配置把需要的nosql實例注入到服務(wù)容器中。目前我們支持redis/memcahed/mongodb。

如何使用?如下,

  1. // 獲取redis對象 
  2. App::$container->getSingle('redis'); 
  3. // 獲取memcahed對象 
  4. App::$container->getSingle('memcahed'); 
  5. // 獲取mongodb對象 
  6. App::$container->getSingle('mongodb'); 

[ file: framework/nosql/* ]

接口文檔生成和接口模擬模塊

通常我們寫完一個接口后,接口文檔是一個問題,我們這里使用Api Blueprint協(xié)議完成對接口文檔的書寫和mock(可用),同時我們配合使用Swagger通過接口文檔實現(xiàn)對接口的實時訪問(目前未實現(xiàn))。

Api Blueprint接口描述協(xié)議選取的工具是snowboard,具體使用說明如下:

接口文檔生成說明

  1. cd docs/apib  
  2. ./snowboard html -i demo.apib -o demo.html -s  
  3. open the website, http://localhost:8088/ 

接口mock使用說明

  1. cd docs/apib  
  2. ./snowboard mock -i demo.apib  
  3. open the website, http://localhost:8087/demo/index/hello 

[ file: docs/* ]

單元測試模塊

基于phpunit的單元測試,寫單元測試是個好的習(xí)慣。

如何使用?

tests目錄下編寫測試文件,具體參考tests/demo目錄下的DemoTest文件,然后運行:

  1. vendor/bin/phpunit 

測試斷言示例:

  1. /** 
  2.  * 演示測試 
  3.  */ 
  4. public function testDemo() 
  5.     $this->assertEquals( 
  6.         'Hello Easy PHP'
  7.         // 執(zhí)行demo模塊index控制器hello操作,斷言結(jié)果是不是等于'Hello Easy PHP'  
  8.         App::$app->get('demo/index/hello'
  9.     ); 

phpunit斷言文檔語法參考

[ file: tests/* ]

Git鉤子配置

目的規(guī)范化我們的項目代碼和commit記錄。

  • 代碼規(guī)范:配合使用php_codesniffer,在代碼提交前對代碼的編碼格式進(jìn)行強(qiáng)制驗證。
  • commit-msg規(guī)范:采用ruanyifeng的commit msg規(guī)范,對commit msg進(jìn)行格式驗證,增強(qiáng)git log可讀性和便于后期查錯和統(tǒng)計log等, 這里使用了 Treri 的commit-msg腳本,Thx~。

[ file: ./git-hooks/* ]

輔助腳本

cli腳本

以命令行的方式運行框架,具體見使用說明。

build腳本

打包PHP項目腳本,打包整個項目到runtime/build目錄,例如:

  1. runtime/build/App.20170505085503.phar  
  2. <?php 
  3. // 入口文件引入包文件即可 
  4. require('runtime/build/App.20170505085503.phar'

[ file: ./build ]

如何使用?

執(zhí)行:

  • composer install
  • chmod -R 777 runtime

網(wǎng)站服務(wù)模式:

  • 步驟 1: yarn install
  • 步驟 2: DOMAIN=http://localhost:666 npm run demo
  • 步驟 3: cd public
  • 步驟 4: php -S localhost:666

訪問網(wǎng)站:http://localhost:666/index.html

訪問接口:http://localhost:666/Demo/Index/hello

demo如下:

客戶端腳本模式:

  1. php cli --method= --= ...  
  2. 例如, php cli --method=demo.index.get --username=easy-php 

獲取幫助:

使用命令 php cli 或者 php cli --help

問題和貢獻(xiàn)

不足的地方還有很多,如果大家發(fā)現(xiàn)了什么問題,可以給我提 issue 或者PR。

或者你覺著在這個框架實現(xiàn)的細(xì)節(jié)你想了解的,一樣可以給我提 issue ,后面我會總結(jié)成相應(yīng)的文章分享給大家。

如何貢獻(xiàn)?

  1. cp ./.git-hooks/* ./git/hooks 

然后正常發(fā)起PR即可, 所有的commit我都會進(jìn)行代碼格式(psr)驗證和commit-msg驗證,如果發(fā)生錯誤,請按照提示糾正即可。

項目地址: https://github.com/TIGERB/easy-php

TODO

  • 懶加載優(yōu)化框架加載流程
  • 性能測試和優(yōu)化
  • 變更Helper助手類的成員方法為框架函數(shù),簡化使用提高生產(chǎn)效率
  • 提供更友善的開發(fā)api幫助
  • 模塊支持?jǐn)?shù)據(jù)庫nosql自定義配置
  • 支持mysql主從配置
  • ORM提供更多鏈?zhǔn)讲僮鱝pi
  • 框架log行為進(jìn)行級別分類
  • 想辦法解決上線部署是配置文件問題
  • 基于phar文件和git webhook自動化打包部署
  • ...
責(zé)任編輯:未麗燕 來源: Github
相關(guān)推薦

2022-09-01 10:46:02

前端組件庫

2020-04-07 15:12:07

微服務(wù)架構(gòu)數(shù)據(jù)

2018-08-15 10:51:01

JavaSpring MVC框架

2016-09-14 17:48:44

2013-01-14 09:44:58

JavaScriptJSJS框架

2015-09-06 10:58:36

PHP框架搭建結(jié)構(gòu)

2020-04-02 08:47:04

開發(fā)網(wǎng)站技術(shù)

2020-01-09 11:11:35

RPC框架調(diào)用遠(yuǎn)程

2024-02-06 09:55:33

框架代碼

2012-06-04 18:02:56

社區(qū)

2019-05-13 15:05:34

TomcatWeb Server協(xié)議

2014-08-26 10:05:37

框架開發(fā)AngularJS

2009-10-01 09:19:45

PHP框架ZendFramewoCake

2021-08-04 11:55:45

Python天氣查詢PySide2

2015-07-03 11:27:30

程序員自己神器

2024-06-07 09:13:23

2022-07-06 19:00:00

微服務(wù)框架鏈路

2021-03-10 09:52:38

開發(fā)技能架構(gòu)

2024-09-14 14:09:40

2013-07-10 10:38:48

JavaScript框
點贊
收藏

51CTO技術(shù)棧公眾號