blade自定义指令本质是编译期字符串替换，须在appserviceprovider::boot()注册，参数为原始字符串，需手动拼接php代码并处理空格，区块指令需成对注册，嵌套内容须用blade::extend()并二次编译。
自定义 Blade 指令不是“写个函数就能用”，它本质是编译期字符串替换，注册位置错、参数处理错、PHP 代码拼错，都会导致模板编译失败或运行时报错——而且错误信息往往指向生成的缓存 PHP 文件，而不是你写的指令本身。
Blade::directive() 必须在 AppServiceProvider::boot() 里注册
这是最常踩的坑：注册位置不对，指令永远不生效。
- 不能在
register()方法里注册 —— 此时BladeCompiler实例还没初始化 - 不能在控制器、中间件、视图文件里动态调用 —— Laravel 只在服务提供者启动阶段读取一次注册表
- 不能在多个服务提供者中重复注册同名指令 —— 后注册的会静默覆盖前一个，无警告
- 改完指令后必须执行
php artisan view:clear，否则旧缓存继续运行，新逻辑不触发
@myDirective($arg) 的 $arg 是原始字符串，不是 PHP 变量值
比如你写 @datetime($user->created_at)，传给闭包的 $expression 是字面量 $user->created_at 这个字符串，不是它运行后的 Carbon 实例。
- 你得手动把它拼进返回的 PHP 字符串里，例如：
return "<?php echo ($expression)->format('Y-m-d'); ?>"; - 别在闭包里直接调用
auth()或request()—— 这些是运行时 Facade，而闭包是在编译阶段执行的 - 所有空格、换行、括号都原样保留，
@role( 'admin' )中的空格也会传进来，建议用trim($expression, " '\"")清理 - 返回的必须是合法 PHP 代码片段，结尾不加
;（Blade 会自动补），但开头结尾的<?php/?>必须自己写全
@myBlock ... @endmyBlock 要配对注册两个 directive，不能只写开头
Blade 不识别“区块指令”这个概念，它靠编译器栈匹配 @xxx 和 @endxxx —— 所以你必须显式注册两个独立指令。
-
Blade::directive('block', ...)返回<?php if (...): ?>类语句 -
Blade::directive('endblock', ...)必须返回对应结束语句，如<?php endif; ?>，否则编译出错或逻辑断裂 - 指令名必须严格对应：注册
'block'就只能用@block，@endblock才能被识别；写成@endBlock或@end_block都无效 - 不要试图用
Blade::if()实现带结束标签的结构 —— 它只支持单标签，@endxxx会被完全忽略
带嵌套内容的指令要用 Blade::extend()，但慎用
如果你需要捕获 @myComponent ... @endmyComponent 中间的所有 Blade 内容（包括里面的 @if、@foreach），Blade::directive() 不够用，必须上 Blade::extend()。
- 它接收正则匹配结果，
$matches[2]是原始未编译的内容，需手动传给Blade::compileString()二次编译，否则嵌套指令不生效 - 正则必须带
s修饰符（/.../s），否则.不匹配换行，多行内容截断 - 它在每次模板编译时执行（除非开启视图缓存），高频页面会明显拖慢热加载速度
- 无法访问 Laravel 的服务容器或请求上下文，纯文本处理，复杂逻辑应移到组件或辅助函数里
真正难的不是写出第一个 @log，而是当你要支持 @can('update', $post) 这种带变量和模型的指令时，得确保生成的 PHP 调用既安全又可测——这时候该收口到 Policy 或自定义门面，而不是在指令闭包里拼 SQL。
