Laravel View Composer - 当 include 一个模板时，自动获取其所需的变量

网站中，许多页面的侧边栏是相同的。例如：

分类列表页，与文章详情页的侧边栏都包含

最新文章
最新评论
统计计数

这些相同的侧边栏数据也是动态的，并不是固定的。

在每个 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 启动时自动载入的了？

一个完整的例子

创建 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 渲染逻辑即可。

巴特西