网站中，许多页面的侧边栏是相同的。例如：
分类列表页，与文章详情页的侧边栏都包含
- 最新文章
- 最新评论
- 统计计数
这些相同的侧边栏数据也是动态的，并不是固定的。
在每个 controller 里都写一遍数据读取逻辑，并赋值给模板，这样做有几个弊端
- 重复编码量不小。即使提取成函数，也要手动将变量传递给模板，controller 中无法专注于业务逻辑
- 不利于模块化
简单粗暴的做法 - 全局 view share
之前，我用了一种简单粗暴的解决方案：
在 app/Providers/AppServiceProvider.php 里全局共享模板变量，即，View::share。
但是，这种做法的弊端是
- 及时某些页面不需要这些变量，也会浪费时间去获取一遍
- 代码越来越臃肿
View Composer - 当 include 一个 view 时，自动获取其所需的变量
Laravel 的 View Composer 很好的解决了这个问题。
官方文档： https://laravel.com/docs/5.5/views#view-composers
View composer 实际上是一个回调，当需要渲染一个指定 blade 模板时，被自动调用。
View Composer 需要在 service provider 中进行注册。即，新建一个 Service Provider, 然后加入到 config/app.php 中，方便 Laravel 启动时自动载入。
这个 view composer 可以偷懒地写在 AppServiceProvider.php 中，但是，带来的问题就是代码乱的一塌糊涂。还是放到独立的文件中比较好。
class based composers VS Closure based composers
class based composers
View::composer(
'profile', 'App\Http\ViewComposers\ProfileComposer'
);
Closure based composers
View::composer('dashboard', function ($view) {
//
});
我更倾向于使用 Closure based composers，这样做的好处有
- 省去新建一个 composer 文件。因为如果没有复用、没有解耦的需求，新建一个代码文件是件我无法理解的事情
- 逻辑一目了然，不需要再切到另外一个文件查看
如果通过 $view->with 给一个模板传递多个变量
// 一个变量
$view->with('count', 1);
// 多个变量
$view->with('count', 1)
->with(‘site’, ‘sunzhongwei.com’);
如何通过 laravel 命令创建 View Composer 文件
View composer 统一放到目录
app/Http/ViewComposers
下。
Laravel 内置的命令
make:provider Create a new service provider class
即
php artisan make:provider SidebarCompoerServiceProvider
为何用这么长的名字？因为可以在 provider 列表里一目了然。
app/Providers/SidebarCompoerServiceProvider.php
namespace App\Providers;
use Illuminate\Support\ServiceProvider;
class SidebarCompoerServiceProvider extends ServiceProvider
{
/**
* Bootstrap the application services.
*
* @return void
*/
public function boot()
{
// View::composer
}
/**
* Register the application services.
*
* @return void
*/
public function register()
{
//
}
}
将该文件从 app/Providers 移动到 app/Http/ViewComposers 目录下。
添加 service provider 到 config.php 中
参考 AppServiceProvider 的做法
App\Providers\AppServiceProvider::class,
一个 View Composer 给多个 blade 模板提供数据
View::composer(
['profile', 'dashboard'],
'App\Http\ViewComposers\MyViewComposer'
);
当然也可以使用星号为所有模板提供数据 （严重不推荐， 这跟之前的 app service provider 中的做法没有本质区别）
Laravel Service Provider 是什么？
https://oomusou.io/laravel/laravel-service-provider/
我发现很难理解 Laravel Service Provider 的概念。
先从最常见的使用场景来看：
我们安装一个新的 Laravel 包，总是先 composer install xxx，然后修改 config/app.php 文件，在 providers 里加入 XXX::class 。
疑问来了，composer install 之后为何还要手动配置 provider.
因为，composer install 只是将三方包的代码安装到 vendor 目录下。
但是，Laravel 并不知道这个三方包的存在，如果想让 laravel 启动时自动加载这个三方包，就需要在 config/app.php 的 providers 中加入这个包。
所以，service provider 存在的意义就是方便管理哪些模块应该在 laravel 启动时自动载入的了？
Register 和 Boot 的使用，我还是看不懂？
一个完整的例子
创建 View Composer Service Provider
php artisan make:provider SidebarCompoerServiceProvider
mkdir app/Http/ViewComposers
mv app/Providers/SidebarComposerServiceProvider.php app/Http/ViewComposers/
代码填充如下
<?php
namespace App\Http\ViewComposers; // 注意修改 namespace
use Illuminate\Support\ServiceProvider;
use Illuminate\Support\Facades\View;
use App\Models\WebExamInfo;
use App\Models\Live;
class SidebarComposerServiceProvider extends ServiceProvider
{
/**
* Bootstrap the application services.
*
* @return void
*/
public function boot()
{
View::composer('detail_sidebar', function ($view) {
// 招考信息
$exams = WebExamInfo::orderBy('id', 'desc')
->limit(6)
->get();
// 直播信息
$lives = Live::where('is_deleted', 0)
->orderBy('id', 'desc')
->limit(6)
->get();
$view->with('exams', $exams)
->with('lives', $lives);
});
}
/**
* Register the application services.
*
* @return void
*/
public function register()
{
//
}
}
最后在 config/app.php 的 providers 中添加
App\Http\ViewComposers\SidebarComposerServiceProvider::class,
对应的修改 blade 渲染逻辑即可。
微信关注我哦 👍
我是来自山东烟台的一名开发者，有感兴趣的话题，或者软件开发需求，欢迎加微信 zhongwei 聊聊， 查看更多联系方式