自定义 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 表达式，自动被包裹进 <?php ... ?>
return "<?php echo (new DateTime($expression))->format('Y-m-d H:i:s'); ?>";
});
-
$expression是原始括号内内容，如@datetime($post->created_at)中的$post->created_at，未被解析、未被转义 - 不要对
$expression做eval()或echo $expression—— 这等于把用户输入原样执行 - 若需默认值或条件判断，应在返回的 PHP 字符串中写，例如
<?php echo $expression ?? 'N/A'; ?>
为什么 @mydirective('hello') 编译后没输出
最常见原因是返回的 PHP 代码没有 echo 或 print，或者用了 return 而非输出语句。Blade 指令本身不隐式输出，它只是插入一段 PHP 代码。
- 错误写法：
return "<?php \$date = $expression; ?>";→ 变量赋值但无输出 - 正确写法：
return "<?php echo date('Y-m-d', strtotime($expression)); ?>"; - 调试技巧：清空
storage/framework/views/下缓存文件，再刷新页面，看生成的 PHP 视图里对应位置是否插入了预期代码 - 注意单双引号嵌套：PHP 字符串中若含变量，用双引号；若含大量引号，建议用 nowdoc/heredoc 或拼接
能否支持多行参数或闭合标签（@mydirective ... @endmydirective）
不能。原生 Blade::directive() 仅支持单行、无闭合的指令。要实现类似 @auth / @endauth 的结构化语法，必须使用 Blade::if()、Blade::component() 或更底层的 BladeCompiler::extend()。
-
Blade::if('admin')适合布尔型条件封装 - 复杂结构推荐写为匿名组件（
<x-panel>...</x-panel>），语义清晰且支持 slot - 强行用
directive()模拟闭合标签会导致解析不稳定，尤其在嵌套或含 @include 时极易出错
真正难的不是写回调函数，而是理解 Blade 编译时机和 PHP 代码注入边界——所有传入的表达式都未经过滤，必须当成不可信输入处理。
