@money 指令是编译期字符串替换，非运行时函数，不经过服务容器、不支持动态依赖；参数须为安全变量或字面量，避免 null 导致 php 报错；注册需在 appserviceprovider::boot() 中用 blade::directive()，委托给 money() 函数格式化；与 组件定位不同，前者纯文本输出，后者支持结构化渲染与交互。
@money 指令本质是字符串替换，不是运行时函数
Blade 的 @money 指令在模板编译阶段就被替换成 PHP 代码，不是调用某个函数或方法。这意味着它不经过 Laravel 的服务容器、不触发事件、也不支持动态依赖注入——你传进去的表达式，最终会被原样拼进生成的 PHP 文件里。
常见错误现象：@money($price * $tax) 看似合理，但若 $price 或 $tax 为 null，编译后 PHP 会直接报错（如 Unsupported operand types），而不会走任何异常处理逻辑。
- 所有参数必须是可安全拼入 PHP 表达式的变量或字面量，避免复杂语句
- 不能在
@money内部调用 Blade 组件、其他指令或使用@if等嵌套语法 - 修改指令定义后必须执行
php artisan view:clear，否则缓存旧编译结果，改动不生效
如何注册一个安全可用的 @money 指令
推荐在 AppServiceProvider::boot() 中注册，使用 Blade::directive() 并严格校验输入类型。不要直接 echo 原始值，应委托给 money() 辅助函数（来自 laravel-money 包）或自定义格式化逻辑。
示例注册代码：
use Illuminate\Support\Facades\Blade;
<p>Blade::directive('money', function ($expression) {
return "<?php echo money({$expression})->format(); ?>";
});
</p>
-
$expression是你写在括号里的全部内容，如@money(123.45)→$expression = '123.45' - 若需支持多参数（如金额 + 货币），得手动解析字符串，不推荐；更稳妥的是只传金额，货币由配置或上下文决定
- 务必确保
money()函数已加载（检查是否安装并启用laravel-money包）
@money 和 组件的关键区别
@money 是轻量级文本输出指令，<x-money></x-money> 是完整组件，二者定位不同，不能混用或互相替代。
-
@money(500)输出纯 HTML 字符串，比如$500.00，无额外标签、无 class、不可交互 -
<x-money amount="500" currency="USD"></x-money>渲染为带结构的 HTML 元素（如<span class="money">$500.00</span>），支持 slot、属性绑定和 JS 钩子 - 如果项目中已用
<x-money></x-money>实现了货币符号切换或实时汇率转换，再写@money指令就容易造成逻辑割裂
容易被忽略的兼容性陷阱
laravel-money 包的 money() 辅助函数默认使用应用配置的主货币（如 config('money.default')），但 @money 指令本身不感知 locale 或用户偏好。如果你在多语言站点中直接写 @money(100)，可能在法语界面仍显示 $100.00 而非 100,00 $。
- 不要依赖
@money自动适配区域格式，它只做基础格式化 - 需要本地化时，要么改用
@money(100, 'EUR')显式传参，要么统一走<x-money convert locale="fr"></x-money>这类组件能力 - 注意 PHP 版本：低于 8.0 的环境里，
money()返回对象的format()方法可能不支持intl扩展降级逻辑，导致千分位符异常
实际项目里，@money 最适合用在管理后台或内部报表这类对格式一致性要求高、但无需交互和本地化的场景。一旦涉及用户端展示、多币种切换或前端联动，就该让位给组件或 API 层处理。
