自定义 Blade 指令必须在服务提供者 boot() 方法中注册，回调函数需返回可执行 PHP 代码而非 HTML，且不自动输出，须显式 echo；不支持闭合标签，多行或结构化语法应使用 Blade::if() 或组件。

可以直接用 Blade::directive() 注册自定义指令，但必须在服务提供者中注册，且不能在视图里动态定义。

在哪注册自定义 Blade 指令

必须在服务提供者的 boot() 方法中调用 Blade::directive()，通常放在 AppServiceProvider 或专用的 BladeServiceProvider 里。Laravel 启动后、视图编译前才会读取这些注册，延迟注册（比如在控制器或中间件里）完全无效。

• 注册位置错误是 90% 的“指令不生效”问题根源
• 不要在 register() 方法里注册——此时 Blade 编译器尚未初始化
• 如果指令逻辑复杂，建议抽成独立函数再传入，避免 directive() 回调体过长

如何写一个安全可用的 directive 回调函数

回调函数接收原始标签内容（字符串），必须返回合法 PHP 代码片段（不是 HTML），由 Blade 在编译阶段拼入最终 PHP 视图文件。常见错误是直接返回 HTML 字符串，导致运行时报错或 XSS 风险。

Blade::directive('datetime', function ($expression) {
    // ✅ 正确：返回可执行的 PHP 表达式，自动被包裹进 
    return "format('Y-m-d H:i:s'); ?>";
});

• $expression 是原始括号内内容，如 @datetime($post->created_at) 中的 $post->created_at，未被解析、未被转义
• 不要对 $expression 做 eval() 或 echo $expression —— 这等于把用户输入原样执行
• 若需默认值或条件判断，应在返回的 PHP 字符串中写，例如

为什么 @mydirective('hello') 编译后没输出

最常见原因是返回的 PHP 代码没有 echo 或 print，或者用了 return 而非输出语句。Blade 指令本身不隐式输出，它只是插入一段 PHP 代码。

• 错误写法：return ""; → 变量赋值但无输出
• 正确写法：return "";
• 调试技巧：清空 storage/framework/views/ 下缓存文件，再刷新页面，看生成的 PHP 视图里对应位置是否插入了预期代码
• 注意单双引号嵌套：PHP 字符串中若含变量，用双引号；若含大量引号，建议用 nowdoc/heredoc 或拼接

能否支持多行参数或闭合标签（@mydirective ... @endmydirective）

不能。原生 Blade::directive() 仅支持单行、无闭合的指令。要实现类似 @auth / @endauth 的结构化语法，必须使用 Blade::if()、Blade::component() 或更底层的 BladeCompiler::extend()。

• Blade::if('admin') 适合布尔型条件封装
• 复杂结构推荐写为匿名组件（...），语义清晰且支持 slot
• 强行用 directive() 模拟闭合标签会导致解析不稳定，尤其在嵌套或含 @include 时极易出错

真正难的不是写回调函数，而是理解 Blade 编译时机和 PHP 代码注入边界——所有传入的表达式都未经过滤，必须当成不可信输入处理。