最近項目想用Laravel框架作開發,但考慮到隨着項目的增大,代碼的增多,需求變的複雜多樣化,將全部代碼寫在一塊兒,無疑是一個很大的問題,這將致使代碼過於複雜,一些寫過的功能點想要從新使用,查找起來太過費勁;因此考慮到使用和其餘框架相似的模塊化開發,可是laravel框架沒有明確的模塊化劃分,因此就想找一下看是否有其餘第三方模塊化(Module)開發包來使用,畢竟laravel社區這麼火熱和強大,最終找到了模塊化開發包,還比較好用,因此總結一下,分享出來。
感慨一下:站在巨人的肩膀上寫東西就是好!!!
這裏使用的第三方鏡像包是:nwidart/laravel-modules,laravel的模塊管理器。用起來很方便,git地址:https://github.com/nWidart/laravel-modules
接下來就說一下使用的狀況:php
composer require nwidart/laravel-modules
固然這一步是要創建在你本地已經安裝了composer的狀況下。不會安裝composer能夠查看官方說明,地址:https://getcomposer.org/download/laravel
'providers' => [ Nwidart\Modules\LaravelModulesServiceProvider::class, ],
添加別名到同一文件的別名數組中。git
'aliases' => [ 'Module' => Nwidart\Modules\Facades\Module::class, ],
以上兩步是進行服務註冊,必需要進行添加,不過在laravel5.5版本以後能夠不添加也能運行,這得益於laravel5.5提供的包自動發現機制。
接下來發布軟件包的配置,經過運行如下方式:github
php artisan vendor:publish --provider="Nwidart\Modules\LaravelModulesServiceProvider"
執行完上面這條命令以後,在config文件夾下會生成一個modules.php文件,這個是模塊開發的配置文件,你能夠在這裏面進行配置。web
{ "autoload": { "psr-4": { "App\\": "app/", "Modules\\": "Modules/" } } }
提示:不要忘記運行 composer dump-autoload 命令。json
php artisan module:make module-name
若是須要一次生成多個模塊,可使用如下命令:bootstrap
php artisan module:make module-name1 module-name2 module-name3
app/ bootstrap/ vendor/ Modules/ ├── Blog/ ├── Assets/ ├── Config/ ├── Console/ ├── Database/ ├── Migrations/ ├── Seeders/ ├── Entities/ ├── Http/ ├── Controllers/ ├── Middleware/ ├── Requests/ ├── routes.php ├── Providers/ ├── BlogServiceProvider.php ├── Resources/ ├── lang/ ├── views/ ├── Repositories/ ├── Tests/ ├── composer.json ├── module.json ├── start.php
至此,鏡像包安裝和使用已經完成,能夠正常使用了。數組
模塊位置修改
因爲以上生成的目錄結構的模塊是在和app同級的目錄下,我想把他放到app目錄下面,這樣看起來會好一點(我的習慣,可沒必要修改)。
方法:修改配置文件config/modules.php文件app
'namespace' => 'App\Modules',
'paths' => [ 'modules' => base_path('App\Modules'), ]
如今執行生成模塊命令,生成的Modules模塊會在app目錄下面。
路由修改
使用nwidart/laravel-modules鏡像包安裝的路由文件默認是在Blog/Http/routes.php下面,而使用路由是由模塊生成的start.php文件加載的。我想把他提取出來,放到單獨的文件夾下面,像laravel的路由同樣(我的習慣,可沒必要修改)。
方法:修改配置文件config/modules.php文件
①將配置文件中有關start的配置去掉composer
'stubs' => [ 'enabled' => false, 'path' => base_path() . '/vendor/nwidart/laravel-modules/src/Commands/stubs', 'files' => [ // 'start' => 'start.php', 'routes' => 'Http/routes.php', ], 'replacements' => [ // 'start' => ['LOWER_NAME'], ], ],
接下來再將Blog/module.json下面生成的start.php去掉
{ "files": [], }
以上兩步是爲了不程序執行期間報錯,因此必須執行。
②修改路由文件生成路徑
'stubs' => [ 'files' => [ // 'start' => 'start.php', 'routes' => 'Routes/routes.php', ],
如今執行生成模塊命令,生成的路由文件會在Blog/Routes/route.php模塊下面。
③接下來修改路由服務提供者,註冊路由
執行命令:
php artisan module:route-provider Blog
爲指定的模塊生成給定的路由。
執行完此命令以後,會在Blog/Providers目錄下面生成一個RouteServiceProvider.php文件,此文件就是路由的服務提供者。
接下來修改RouteServiceProvider.php文件
public function map(Router $router) { // if (!app()->routesAreCached()) { // require __DIR__ . '/Http/routes.php'; // } if (! app()->routesAreCached()) { $this->mapWebRoutes(); } }
增長方法:
protected function mapWebRoutes() { //方法一: //Route::group([ //'middleware' => 'web', //'namespace' => $this->namespace, //], function ($router) { //require module_path('Admin') . '/Routes/routes.php'; //}); //方法二: Route::middleware('web') ->namespace($this->rootUrlNamespace) ->group(module_path('Blog') . '/Routes/routes.php'); }
在此RouteServiceProvider.php文件已經修改完畢。
接下來修改Blog/Providers/BlogServiceProvider.php文件,修改以下:
public function register() { //註冊服務提供者 $this->app->register(RouteServiceProvider::class); }
到此使用第三方鏡像包,開發laravel模塊化項目已經說明完畢,但願對你們有用。