视图合成器是解决view()->share()无条件执行问题的必要手段，必须在AppServiceProvider::boot()中注册；它仅在匹配视图渲染时运行，避免非页面场景开销，且视图名匹配不支持路径或URL，仅支持点号分隔的标识符。
视图合成器不是“高级技巧”，而是解决 view()->share() 无条件执行问题的必要手段——它只在匹配视图真正渲染时运行，避免给 API、队列、PDF 等非页面场景徒增开销。
必须注册在 AppServiceProvider::boot() 里
注册位置错，整个逻辑就失效。常见错误包括：
-
register()中调用：服务容器未构建完成，View门面不可用，报Call to a member function composer() on null - 写在中间件里：执行时机早于视图实例创建，
$view尚未存在 - 写在控制器里：只对当前响应生效，无法复用于邮件模板、后台侧边栏等其他视图
正确姿势是统一收口到 AppServiceProvider::boot() 或独立的服务提供者（如 MenuServiceProvider）：
use Illuminate\Support\Facades\View;
public function boot()
{
View::composer('backpack::base.sidebar_content', function ($view) {
$view->with('menu_items', \App\Models\MenuItem::where('is_active', true)->orderBy('order')->get());
});
}
View::composer() 的第一个参数只认视图名，不认路径或 URL
传入的是 Blade 视图标识符（即 view('xxx.yyy') 中的字符串），不是磁盘路径，也不是路由地址：
-
['auth.login', 'auth.register']✅ 匹配resources/views/auth/login.blade.php -
'admin.*'✅ 匹配admin/dashboard、admin/users/index，但不匹配admin（缺点号） -
'/admin/dashboard'❌ 视图名不含斜杠，永远不命中 -
'admin/*'❌ 通配符只支持.分隔的点号语法，不支持 shell 风格*
闭包 vs 类式写法：性能和可维护性差异明显
闭包写法轻量，适合简单逻辑；类式写法更适合复杂场景：
- 闭包易导致
AppServiceProvider膨胀，难以测试，且每次渲染都重新解析闭包 - 类式写法（如
App\Http\ViewComposers\SidebarComposer）可被依赖注入、单元测试、复用到多个视图 - 类中构造函数能提前注入模型或服务，避免在
compose()方法里重复查库
示例类式结构：
<?php
namespace App\Http\ViewComposers;
use Illuminate\View\View;
use App\Models\MenuItem;
class SidebarComposer
{
public function compose(View $view)
{
$menu_items = cache()->remember('sidebar_menu', 3600, function () {
return MenuItem::where('is_active', true)->orderBy('order')->get();
});
$view->with('menu_items', $menu_items);
}
}
注册方式：View::composer('backpack::base.sidebar_content', SidebarComposer::class);
防 N+1 是最容易被忽略的性能雷区
视图合成器回调本质是“每个匹配视图渲染前自动执行一次”，一旦里面含循环查询或未预加载关联，性能会断崖下跌：
- 错误示范：
foreach ($users as $user) { $user->avatar; }→ 每次访问触发新查询 - 正确做法：提前查好数据，或用
with()预加载，例如User::with('avatar')->get() - 更推荐移至缓存层，比如
Cache::remember('nav_menu', 3600, fn() => ...) - 特别注意 Backpack 的
backpack::base.sidebar_content可能被多个页面共用，缓存键要唯一且带失效策略
真正难的不是注册语法，而是判断「这个数据是否真的只该在这个视图里查」——多数人卡在这一步，直接把控制器逻辑照搬进合成器，结果越用越慢。
