laravel 自定义服务提供者

导语

laravel 的服务提供者，是框架的核心，提供了路由、日志、缓存等功能。这里要实现的需求是使用第三方 API 获取天气状况，涉及到服务提供者、契约、依赖注入等方面。相关内容能够经过下方参考资料进行了解，本文内容不进行展开介绍，代码可查看 GitHub。

建立服务提供者

1. 可使用 artisan 快捷的建立服务提供者，执行 php artisan make:provider WeatherServiceProvider 即在 app/Providers 目录下建立了 WeatherServiceProvider.php 文件；
2. 在 config/app.php 中注册服务提供者，在 providers 数组中将建立的服务提供者 App\Providers\WeatherServiceProvider::class, 写入，以下

建立契约

1. 在 app 目录下新建 Contracts 目录用以存放契约文件；
2. 在 app/Contracts 目录下建立契约，即 Weather.php 接口文件。在接口中只定义了 public function getWeather($cityName); 一个方法用于获取天气信息；

实现契约

1. 在 app 目录下新建 Service/Weather 目录用于存放实现 Weather.php 契约的文件；
2. 选择一个第三方的天气 API 来实现契约。这里使用的是心知天气。关于 API 的调用，能够查看文档；
3. 最终建立的文件是 app/Service/Weather/Xinzhi.php。继承了 Weather.php 接口文件，全部要实现 getWeather 方法，代码可查看 GitHub；
4. 这里先埋个伏笔。除了上面的 Xinzhi.php，另外选择和风天气实现契约，文件为 app/Service/Weather/Hefeng.php。代码查看 GitHub；

服务提供者绑定

咱们已经实现了契约，接下来就是绑定具体实现类。回到开始建立的服务提供者，在 register 方法中添加以下代码

$this->app->bind('App\Contracts\Weather', function() {
    return new Xinzhi();
});

最后就能够正常使用了。新建路由，而后测试。试下经过依赖注入调用

public function getWeather(Request $request, Weather $weather)
{
    return $weather->getWeather($request->input('city', 'beijing'));
}

没有问题

解耦

完成上述全部步骤，这个需求已经实现了。看起来很麻烦是吧，彻底能够封装一个函数，直接调用就能够了，没有必要自定义服务提供者、建立契约。实际上述步骤，其中的一个目的就是小标题那两个字——解耦。
假设一下，咱们须要在不少代码中使用这个功能，忽然有一天，这个 API 挂了，怎么办？四处去查找、检查代码，而后再去修改，同时要注意参数、返回值等。光是听起来就很烦了。这个时候，若是咱们的代码按照上述的步骤进行开发，解决方法就大不相同了。简而言之，一行代码就能够搞定。
还记得上面那个伏笔吧，一共有两个实例实现了接口。将自定义的服务提供者 register 作以下修改

$this->app->bind('App\Contracts\Weather', function() {
       // return new Xinzhi();
        return new Hefeng();
});

修改了契约的绑定，全部使用 Weather 契约进行依赖注入的实例，都会由 Xinzhi.php 实例切换到 Hefeng.php 实例。

契约固然不止解耦这一个做用，代码更容易理解、更方便维护，甚至能够当作简明的开发文档。更多的深刻理解，请查看下方参考资料。

---

参考资料：底层原理 —— 服务提供者、底层原理 —— 契约（Contracts）、Laravel 服务容器实例教程 —— 深刻理解控制反转（IoC）和依赖注入（DI）、 Laravel 从学徒到工匠系列 依赖注入篇。