Laravel 5.6 Blade模板多控制器复用及动态变量适配问题

嘿，这个场景我太熟悉了——Laravel里处理这种「逻辑完全一致、只是对应的数据表/资源不同」的模板复用，有好几种优雅的方案，我给你拆解一下：

这是入门级的实现方式，每个控制器在返回视图时，把模板需要的动态数据传进去就行，比如资源名称、路由前缀这类变量。

控制器代码示例 #

// ManufacturerController.php
public function index()
{
    $manufacturers = Manufacturer::all();
    return view('common.resource-list', [
        'items' => $manufacturers,
        'resourceName' => 'Manufacturer', // 单数名称
        'resourcePlural' => 'Manufacturers', // 复数名称
        'routePrefix' => 'manufacturer' // 路由前缀
    ]);
}

// 再比如ProductController.php
public function index()
{
    $products = Product::all();
    return view('common.resource-list', [
        'items' => $products,
        'resourceName' => 'Product',
        'resourcePlural' => 'Products',
        'routePrefix' => 'product'
    ]);
}

改造后的Blade模板 #

把原来的硬编码内容替换成传递过来的变量，其他逻辑完全保留：

<!-- 你的动态导航链接 -->
<li><a href="{{ route("$routePrefix.index") }}">View All {{ $resourcePlural }}</a></li>

<!-- 还可以扩展其他通用操作，比如新增按钮 -->
<li><a href="{{ route("$routePrefix.create") }}">Add New {{ $resourceName }}</a></li>

<!-- 通用列表循环 -->
@foreach($items as $item)
    <tr>
        <td>{{ $item->name }}</td>
        <td>
            <a href="{{ route("$routePrefix.edit", $item) }}">Edit</a>
            <form action="{{ route("$routePrefix.destroy", $item) }}" method="POST">
                @csrf
                @method('DELETE')
                <button type="submit">Delete</button>
            </form>
        </td>
    </tr>
@endforeach

这里推荐用route()函数代替URL::to()，用命名路由更健壮，后续改路由前缀不用改模板。

如果有很多类似的资源控制器，重复传参太麻烦，可以把通用逻辑抽到父类控制器里，子类只需要定义对应的数据模型和资源信息。

基础父控制器 #

// app/Http/Controllers/BaseResourceController.php
namespace App\Http\Controllers;

use Illuminate\Routing\Controller;

abstract class BaseResourceController extends Controller
{
    protected $model;
    protected $resourceName;
    protected $resourcePlural;
    protected $routePrefix;

    public function __construct()
    {
        $this->setupResource(); // 子类初始化资源信息
    }

    // 子类必须实现这个方法，定义当前资源的参数
    abstract protected function setupResource();

    // 通用的列表方法
    public function index()
    {
        $items = $this->model::all();
        return view('common.resource-list', [
            'items' => $items,
            'resourceName' => $this->resourceName,
            'resourcePlural' => $this->resourcePlural,
            'routePrefix' => $this->routePrefix
        ]);
    }

    // 还可以把create、store、edit、update、destroy这些CRUD方法都抽成通用逻辑
}

子类控制器 #

只需要继承父类，实现初始化方法就行：

// ManufacturerController.php
namespace App\Http\Controllers;

use App\Models\Manufacturer;

class ManufacturerController extends BaseResourceController
{
    protected function setupResource()
    {
        $this->model = Manufacturer::class;
        $this->resourceName = 'Manufacturer';
        $this->resourcePlural = 'Manufacturers';
        $this->routePrefix = 'manufacturer';
    }
}

新增其他资源时，只需要写一个这样的子类，完全不用重复写CRUD逻辑，非常高效。

如果你的Laravel版本比较新，视图组件是更模块化的复用方式，把模板和逻辑封装成独立组件，方便维护和复用。

创建资源列表组件 #

// app/View/Components/ResourceList.php
namespace App\View\Components;

use Illuminate\View\Component;

class ResourceList extends Component
{
    public $items;
    public $resourceName;
    public $resourcePlural;
    public $routePrefix;

    // 组件接收的参数
    public function __construct($items, $resourceName, $resourcePlural, $routePrefix)
    {
        $this->items = $items;
        $this->resourceName = $resourceName;
        $this->resourcePlural = $resourcePlural;
        $this->routePrefix = $routePrefix;
    }

    // 渲染组件视图
    public function render()
    {
        return view('components.resource-list');
    }
}

组件视图文件 #

resources/views/components/resource-list.blade.php：

<li><a href="{{ route("$routePrefix.index") }}">View All {{ $resourcePlural }}</a></li>
<li><a href="{{ route("$routePrefix.create") }}">Add New {{ $resourceName }}</a></li>

<table>
    @foreach($items as $item)
        <tr>
            <td>{{ $item->name }}</td>
            <td>
                <a href="{{ route("$routePrefix.edit", $item) }}">Edit</a>
                <form action="{{ route("$routePrefix.destroy", $item) }}" method="POST">
                    @csrf
                    @method('DELETE')
                    <button type="submit">Delete</button>
                </form>
            </td>
        </tr>
    @endforeach
</table>

在页面中使用组件 #

控制器正常传数据到页面，然后在视图里调用组件：

<!-- manufacturer/index.blade.php -->
<x-resource-list 
    :items="$manufacturers" 
    resourceName="Manufacturer" 
    resourcePlural="Manufacturers" 
    routePrefix="manufacturer"
/>

这三种方案可以根据你的项目规模和需求选择，小项目用方案一足够，多资源场景推荐方案二或三，能大大减少重复代码~

内容的提问来源于stack exchange，提问作者Jonathan Clark