扩展包初始化
composer init
基础信息配置- 声明依赖
illuminate/support
(提供ServiceProvidor
支持)
扩展包业务逻辑
自行组织,没有特殊要求
扩展包组件
Config配置
- 发布配置文件
- 可选的register方法中合并包的默认配置
$this->mergeConfigFrom(__DIR__.'.../xxx.php', 'xxx');
Artisan命令
# boot方法中注册
if ($this->app->runningInConsole()) {
$this->commands([
XxxCommand::class,
...
]);
}
Route路由
- boot方法中装载包的路由
$this->loadRoutesFrom(__DIR__.'.../routes.php');
View视图
- boot方法中装载
$this->loadViewsFrom(__DIR__.'.../views', 包名);
或发布文件 - 用户覆盖视图
resources/views/vendor/包名
- 使用:
return view('包名::视图名')
Migration迁移
- boot方法中装载
$this->loadMigrationsFrom(__DIR__.'.../migrations');
或发布文件
Translation翻译
- boot方法中装载
$this->loadTranslationsFrom(__DIR__.'.../translations', 包名);
或发布文件 - 使用翻译
echo trans('courier::filename.strname');
发布包文件
php artisan vendor:publish [--tag=发布组标识] --force
#boot方法中注册待发布文件
$this->publishes(
[
$from => $to
__DIR__.'.../xxx.php' => config_path('xxx.php'), //配置文件
__DIR__.'.../migrations' => database_path('migrations'), //迁移文件
__DIR__.'.../views' => resource_path('views/vendor'), //视图文件
__DIR__.'.../translations' => resource_path('lang/vendor'), //翻译文件
],
[可选的发布组标识]
);
拓展包ServiceProvidor
- 继承自
Illuminate\Support\ServiceProvider
- 处理业务:容器实例绑定,或资源加载(视图、配置、本地文件等)
拓展包安装方案
- 应用
config/app.php
->$providors
装载 - 拓展包
composer.json
->extra
节区配置包发现从而自动装载
"extra": {
"laravel": {
"providers": [ //包装载
"Xxx\\YyyServiceProvider"
],
"aliases": { //Facade装载
"Zzz": "Xxx\\ZzzFacade"
},
"dont-discover": [ //禁止装载
"Mmm/Nnn",
"*"
]
}
}