# 服务 —— 包开发
## 1、简介
包是添加功能到Laravel的主要方式。包可以提供任何功能，小到处理日期如[Carbon](https://github.com/briannesbitt/Carbon)，大到整个BDD测试框架如[Behat](https://github.com/Behat/Behat)。
当然，有很多不同类型的包。有些包是独立的，意味着可以在任何框架中使用，而不仅是Laravel。比如Carbon和Behat都是独立的包。所有这些包都可以通过在`composer.json`文件中请求以便被Laravel使用。
另一方面，其它包只能特定和Laravel一起使用，这些包可能有路由用于加强Laravel应用的功能，本章主要讨论只能在Laravel中使用的包。
## 2、服务提供者
[服务提供者](http://laravelacademy.org/post/91.html)是包和Laravel之间的连接点。服务提供者负责绑定对象到Laravel的[服务容器](http://laravelacademy.org/post/93.html)并告知Laravel从哪里加载包资源如视图、配置和本地化文件。
服务提供者继承自`Illuminate\Support\ServiceProvider`类并包含两个方法：`register`和`boot`。`ServiceProvider`基类位于Composer包`illuminate/support`。
要了解更多关于服务提供者的内容，查看其[文档](http://laravelacademy.org/post/91.html)。
## 3、路由
要定义包的路由，只需要在包服务提供者中的`boot`方法中引入路由文件。在路由文件中，可以使用`Route`门面[注册路由](http://laravelacademy.org/post/53.html)，和Laravel应用中注册路由一样：
~~~
/**
* Perform post-registration booting of services.
*
* @return void
*/
public function boot(){
if (! $this->app->routesAreCached()) {
require __DIR__.'/../../routes.php';
}
}
~~~
## 4、资源
### 4.1 视图
要在Laravel中注册包[视图](http://laravelacademy.org/post/76.html)，需要告诉Laravel视图在哪，可以使用服务提供者的`loadViewsFrom`方法来实现。`loadViewsFrom`方法接收两个参数：视图模板的路径和包名称。例如，如果你的包名称是“courier”，添加如下代码到服务提供者的`boot`方法：
~~~
/**
* Perform post-registration booting of services.
*
* @return void
*/
public function boot(){
$this->loadViewsFrom(__DIR__.'/path/to/views', 'courier');
}
~~~
包视图通过使用类似的`package::view`语法来引用。所以，你可以通过如下方式加载`courier`包上的`admin`视图：
~~~
Route::get('admin', function () {
return view('courier::admin');
});
~~~
### 4.1.1 覆盖包视图
当你使用`loadViewsFrom`方法的时候，Laravel实际上为视图注册了两个存放位置：一个是`resources/views/vendor`目录，另一个是你指定的目录。所以，以`courier`为例：当请求一个包视图时，Laravel首先检查开发者是否在`resources/views/vendor/courier`提供了自定义版本的视图，如果该视图不存在，Laravel才会搜索你调用`loadViewsFrom`方法时指定的目录。这种机制使得终端用户可以轻松地自定义/覆盖包视图。
### 4.1.2 发布视图
如果你想要视图能够发布到应用的`resources/views/vendor`目录，可以使用服务提供者的`publishes`方法。该方法接收包视图路径及其相应的发布路径数组作为参数：
~~~
/**
* Perform post-registration booting of services.
*
* @return void
*/
public function boot(){
$this->loadViewsFrom(__DIR__.'/path/to/views', 'courier');
$this->publishes([
__DIR__.'/path/to/views' => base_path('resources/views/vendor/courier'),
]);
}
~~~
现在，当包用户执行Laravel的Artisan命令`vendor:publish`时，你的视图包将会被拷贝到指定路径。
### 4.2 翻译
如果你的包包含[翻译文件](http://laravelacademy.org/post/211.html)，你可以使用`loadTranslationsFrom`方法告诉Laravel如何加载它们，例如，如果你的包命名为“courier”，你应该添加如下代码到服务提供者的`boot`方法：
~~~
/**
* Perform post-registration booting of services.
*
* @return void
*/
public function boot(){
$this->loadTranslationsFrom(__DIR__.'/path/to/translations', 'courier');
}
~~~
包翻译使用形如`package::file.line`的语法进行引用。所以，你可以使用如下方式从`messages`文件中加载`courier`包的`welcome`行：
~~~
echo trans('courier::messages.welcome');
~~~
### 4.3 配置
通常，你想要发布包配置文件到应用根目录下的`config`目录，这将允许包用户轻松覆盖默认配置选项，要发布一个配置文件，只需在服务提供者的`boot`方法中使用`publishes`方法即可：
~~~
/**
* Perform post-registration booting of services.
*
* @return void
*/
public function boot(){
$this->publishes([
__DIR__.'/path/to/config/courier.php' => config_path('courier.php'),
]);
}
~~~
现在，当包用户执行Laravel的Artisan命令`vendor:publish`时，你的文件将会被拷贝到指定位置，当然，配置被发布后，可以通过和其它配置选项一样的方式进行访问：
~~~
$value = config('courier.option');
~~~
### 4.3.1 默认包配置
你还可以选择将自己的包配置文件合并到应用的拷贝版本，这允许用户只引入他们在应用配置文件中实际想要覆盖的配置选项。要合并两个配置，在服务提供者的`register`方法中使用`mergeConfigFrom`方法即可：
~~~
/**
* Register bindings in the container.
*
* @return void
*/
public function register(){
$this->mergeConfigFrom(
__DIR__.'/path/to/config/courier.php', 'courier'
);
}
~~~
## 5、公共前端资源
你的包可能包含JavaScript、CSS和图片，要发布这些前端资源到应用根目录下的`public`目录，使用服务提供者的`publishes`方法。在本例中，我们添加一个前端资源组标签`public`，用于发布相关的前端资源组：
~~~
/**
* Perform post-registration booting of services.
*
* @return void
*/
public function boot(){
$this->publishes([
__DIR__.'/path/to/assets' => public_path('vendor/courier'),
], 'public');
}
~~~
现在，当包用户执行`vendor:publish`命令时，前端资源将会被拷贝到指定位置，由于你需要在每次包更新时重写前端资源，可以使用`--force`标识：
~~~
php artisan vendor:publish --tag=public --force
~~~
如果你想要确保前端资源已经更新到最新版本，可添加该命令到`composer.json`文件的`post-update-cmd`列表。
## 6、发布文件组
你可能想要分开发布包前端资源组和资源，例如，你可能想要用户发布包配置的同时不发布包前端资源，可以通过在调用时给它们打上“标签”来实现分离。下面我们在包服务提供者的`boot`方法中定义两个公共组：
~~~
/**
* Perform post-registration booting of services.
*
* @return void
*/
public function boot(){
$this->publishes([
__DIR__.'/../config/package.php' => config_path('package.php')
], 'config');
$this->publishes([
__DIR__.'/../database/migrations/' => database_path('migrations')
], 'migrations');
}
~~~
现在用户可以在使用Artisan命令`vendor:publish`时通过引用标签名来分开发布这两个组：
~~~
php artisan vendor:publish --provider="Vendor\Providers\PackageServiceProvider" --tag="config"
~~~
> 扩展阅读：[实例教程 —— 如何在Laravel 5.1中进行自定义包开发](http://laravelacademy.org/post/1219.html)
- 前言
- 序言
- 序言 ―― 发行版本说明
- 序言 ―― 升级指南
- 序言 ―― 贡献代码
- 开始
- 开始 ―― 安装及配置
- 开始 ―― Laravel Homestead
- 基础
- 基础 ―― HTTP路由
- 基础 ―― HTTP 中间件
- 基础 ―― HTTP 控制器
- 基础 ―― HTTP 请求
- 基础 ―― HTTP 响应
- 基础 ―― 视图
- 基础 ―― Blade模板
- 架构
- 架构 ―― 一次请求的生命周期
- 架构 ―― 应用目录结构
- 架构 ―― 服务提供者
- 架构 ―― 服务容器
- 架构 ―― 契约
- 架构 ―― 门面
- 数据库
- 数据库 ―― 起步
- 数据库 ―― 查询构建器
- 数据库 ―― 迁移
- 数据库 ―― 填充数据
- Eloquent ORM
- Eloquent ORM ―― 起步
- Eloquent ORM ―― 关联关系
- Eloquent ORM ―― 集合
- Eloquent ORM ―― 调整器
- Eloquent ORM ―― 序列化
- 服务
- 服务 ―― 用户认证
- 服务 ―― Artisan 控制台
- 服务 ―― Laravel Cashier（交易）
- 服务 ―― 缓存
- 服务 ―― 集合
- 服务 ―― Laravel Elixir
- 服务 ―― 加密
- 服务 ―― 错误&日志
- 服务 ―― 事件
- 服务 ―― 文件系统/云存储
- 服务 ―― 哈希
- 服务 ―― 帮助函数
- 服务 ―― 本地化
- 服务 ―― 邮件
- 服务 ―― 包开发
- 服务 ―― 分页
- 服务 ―― 队列
- 服务 ―― Redis
- 服务 ―― Session
- 服务 ―― Envoy 任务运行器（SSH任务）
- 服务 ―― 任务调度
- 服务 ―― 测试
- 服务 ―― 验证