Laravel如何添加额外的视图组件类命名空间加载路径

一、原生支持的自定义组件命名空间注册（无需修改核心类） #

Laravel 8及以上版本原生提供Blade::componentNamespace()方法，可直接注册多个自定义视图组件命名空间，完全满足你的两个需求，操作步骤如下：

• 在任意服务提供者（推荐自定义ViewServiceProvider或直接用App\Providers\AppServiceProvider）的boot方法中添加注册代码：

<?php

namespace App\Providers;

use Illuminate\Support\Facades\Blade;
use Illuminate\Support\ServiceProvider;

class AppServiceProvider extends ServiceProvider
{
    public function boot()
    {
        // 注册公共共享组件命名空间，调用前缀为 common
        Blade::componentNamespace('App\\ViewComponents', 'common');
        // 注册各子应用独立组件命名空间，分别对应不同前缀
        Blade::componentNamespace('App\\Blog\\ViewComponents', 'blog');
        Blade::componentNamespace('App\\Admin\\ViewComponents', 'admin');
        Blade::componentNamespace('App\\Website\\ViewComponents', 'website');
    }
}

• 调用规则：
  • 公共组件App\ViewComponents\Alert.php对应Blade标签：<x-common::alert />
  • Blog子应用组件App\Blog\ViewComponents\ArticleCard.php对应Blade标签：<x-blog::article-card />
  • 组件类名遵循驼峰转短横线分隔的Laravel默认规则即可。

二、多子应用动态切换默认组件路径 #

如果需要对应子应用下可直接使用无前缀的标签（如Blog下直接用<x-article-card />调用自身的组件），可添加动态判断逻辑：

public function boot()
{
    Blade::componentNamespace('App\\ViewComponents', 'common');

    // 自定义逻辑获取当前所属子应用，示例为根据路由前缀判断
    $currentSubApp = request()->route()?->getPrefix();
    $validSubApps = ['admin', 'blog', 'website'];
    if (in_array($currentSubApp, $validSubApps)) {
        // 将当前子应用的组件命名空间注册为无前缀默认路径，优先级高于系统默认路径
        Blade::componentNamespace("App\\".ucfirst($currentSubApp)."\\ViewComponents", '');
    }
}

三、可选配置：移除默认组件命名空间 #

如果不需要再使用Laravel默认的App\View\Components路径，可添加如下代码移除扫描：

Blade::forgetComponentNamespace('App\\View\\Components');

内容的提问来源于stack exchange，提问作者LeonardChallis