必须在AppServiceProvider::boot()中调用Blade::directive()注册自定义指令，指令名仅支持字母开头的字母数字下划线组合，回调接收原始字符串并须返回合法PHP代码，带结束标签需用Blade::extend()配合正则匹配与二次编译。
如何注册自定义 Blade 指令（Blade::directive）
自定义 Blade 指令本质是字符串替换，不是运行时 PHP 执行——这点不理解，后面所有问题都绕不开。
必须在 AppServiceProvider::boot() 中调用 Blade::directive()，且只能注册一次；重复注册会静默覆盖前一个，不会报错但行为不可预期。
- 指令名不支持连字符（如
@if-else），只接受字母、数字、下划线，且必须以字母开头（@myIf✅，@2ndTry❌） - 回调函数接收的参数是原始 Blade 内容字符串（含换行和空格），不是已解析的 PHP 变量，别试图在里面直接用
$user - 返回值必须是合法 PHP 代码字符串，且需手动处理缩进和分号——Blade 不帮你补
;，也不自动缩进嵌套块
示例：注册一个简单日志指令
Blade::directive('log', function ($expression) {
return "<?php Log::info({$expression}); ?>";
});
// 用法：<code>@log('user login')</code> → 编译为 <?php Log::info('user login'); ?>
怎么写带结束标签的指令（@myComponent…@endmyComponent）
普通 Blade::directive() 只能处理单行指令；要支持开闭标签（比如包裹内容、条件渲染、循环体），必须用 Blade::if() 或更底层的 Blade::component() + Blade::include() 组合，但最可控的方式是直接操作编译器状态——也就是用 Blade::extend()。
Blade::extend() 是唯一能捕获起始到结束之间全部内容的机制，但它不解析变量，纯文本匹配，容易因空格/换行错位而失效。
- 正则必须严格匹配换行符：用
/(s*)@myBlocks*(.*?)(.*?)@endmyBlock/s，末尾s修饰符让.匹配换行 - 捕获的内容（
$2）是原始 Blade 片段，需手动传给Blade::compileString()二次编译，否则里面嵌套的@if不生效 - 别在
Blade::extend()里做复杂逻辑，它在模板编译阶段运行，每次请求都会触发（除非缓存开启），性能敏感场景慎用
为什么 @auth 能用变量而我的指令不能？
因为 @auth 是 Laravel 内置指令，底层调用的是 BladeCompiler::compileAuth()，它把 @auth($guard) 编译成 __auth($guard) 这样的辅助函数调用，再由 PHP 运行时解析变量。
你写的指令如果想支持动态参数（比如 @can('edit', $post)），就不能只拼字符串，得生成可执行的函数调用，并确保该函数存在且签名匹配。
- 安全第一：所有用户输入的表达式（如
$post）必须原样透传，不要eval、不要str_replace注入变量名 - 推荐模式：指令只负责生成标准函数调用，如
return "<?php if (app()->call(['App\Http\Blade\MyDirectives', 'can'], ['ability' => {$expression}])): ?>"; - 函数里再做权限判断、日志记录等逻辑，和模板编译解耦，也方便单元测试
指令编译后没生效？检查这三处硬伤
Blade 指令不是“写完就跑”，它依赖缓存和编译时机，很多问题卡在这几步上。
- 修改了
AppServiceProvider但没清缓存：执行php artisan view:clear，不是config:clear - 指令注册在
register()而非boot()：Laravel 在register阶段连Blade服务都还没绑定，调用Blade::directive会抛Call to a member function directive() on null - 用了
@push/@stack类指令但没配StackManager：这类指令依赖视图栈机制，若在非根布局中提前调用@stack，内容会丢失，不是指令问题，是使用顺序错了
指令一旦注册，就固化在编译器里，改了回调函数不重启 artisan serve 或不清缓存，永远看不到效果。
