自定义 Blade 指令可提升模板可读性与复用性，如权限判断、格式化时间等场景。通过在 AppServiceProvider 的 boot 方法中使用 Blade::directive() 注册指令，例如创建 @datetime 格式化时间、@role 检查用户角色、@money 格式化金额、@deleteButton 输出删除表单。需注意避免指令名冲突、防范代码注入，并在修改后清除视图缓存：php artisan view:clear。

在 Laravel 中，Blade 是一个强大且简洁的模板引擎，它允许你使用 PHP 代码结合 HTML 构建视图。除了内置的指令如 @if、@foreach、@include 外，Laravel 还支持自定义 Blade 指令，让你可以封装常用逻辑，提升代码可读性和复用性。

为什么需要自定义 Blade 指令？

当你在多个视图中重复写相同的判断或格式化逻辑时，比如检查用户权限、格式化时间、输出特定 HTML 结构，就可以把这些逻辑抽象成自定义指令。这样模板更清晰，也更容易维护。

如何注册自定义 Blade 指令？

你需要在服务提供者中使用 Blade::directive() 方法来注册自定义指令。通常建议创建一个独立的服务提供者，或者在现有的 AppServiceProvider 的 boot() 方法中添加。

例如，在 app/Providers/AppServiceProvider.php 中：

use Illuminate\Support\Facades\Blade;

public function boot()
{
    Blade::directive('datetime', function ($expression) {
        return "format('Y-m-d H:i'); ?>";
    });
}

然后你就可以在 Blade 模板中使用：

@datetime($user->created_at)

输出类似：2025-04-05 10:30

常见自定义指令示例

1. 权限检查指令 @role

用于根据用户角色显示内容：

Blade::directive('role', function ($role) {
    return "check() && auth()->user()->hasRole({$role})): ?>";
});

Blade::directive('endrole', function () {
    return '';
});

用法：

@role('admin')
    
欢迎管理员！
@endrole

2. 格式化金额 @money

Blade::directive('money', function ($amount) {
    return "";
});

用法：@money(1299.99) 输出 ¥1,299.99

3. 输出带 CSRF 的删除表单 @deleteButton

Blade::directive('deleteButton', function ($route) {
    return <<
    
    删除

EOT;
});

注意事项

• 自定义指令名不能与现有指令冲突，比如不要重写 @if。
• 指令中的 $expression 是你传入的参数，原样嵌入 PHP 代码，注意避免注入风险。
• 如果逻辑复杂，建议封装到辅助函数或视图组件中，而不是全写在 directive 里。
• 修改指令后需清除视图缓存：php artisan view:clear

基本上就这些。自定义 Blade 指令是个小功能，但用好了能让模板更干净、逻辑更集中。