自定义 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 "<?php echo ($expression)->format('Y-m-d H:i'); ?>";
});
}
然后你就可以在 Blade 模板中使用：
@datetime($user->created_at)
输出类似：2025-04-05 10:30
常见自定义指令示例
1. 权限检查指令 @role
用于根据用户角色显示内容：
Blade::directive('role', function ($role) {
return "<?php if(auth()->check() && auth()->user()->hasRole({$role})): ?>";
});
Blade::directive('endrole', function () {
return '<?php endif; ?>';
});
用法：
@role('admin')
<p>欢迎管理员！</p>
@endrole
2. 格式化金额 @money
Blade::directive('money', function ($amount) {
return "<?php echo '¥' . number_format({$amount}, 2); ?>";
});
用法：@money(1299.99) 输出 ¥1,299.99
3. 输出带 CSRF 的删除表单 @deleteButton
Blade::directive('deleteButton', function ($route) {
return <<<EOT
<form action={$route} method="POST" style="display:inline;" onsubmit="return confirm('确定要删除吗？')">
<?php echo csrf_field() . method_field('DELETE'); ?>
<button type="submit">删除</button>
</form>
EOT;
});
注意事项
- 自定义指令名不能与现有指令冲突，比如不要重写 @if。
- 指令中的 $expression 是你传入的参数，原样嵌入 PHP 代码，注意避免注入风险。
- 如果逻辑复杂，建议封装到辅助函数或视图组件中，而不是全写在 directive 里。
- 修改指令后需清除视图缓存：
php artisan view:clear
基本上就这些。自定义 Blade 指令是个小功能，但用好了能让模板更干净、逻辑更集中。
