Laravel如何配置自定义视图目录 用getAppTheme()返回视图

1. 配置非默认目录作为视图存放路径 #

Laravel的视图查找路径由ViewFinder服务管理，直接在服务提供者中修改/追加视图路径即可，不需要改动框架核心代码。

操作步骤： #

• 打开app/Providers/AppServiceProvider.php文件，先引入View门面：

use Illuminate\Support\Facades\View;

• 根据实际需求选择对应配置方式，写在boot()方法中：
  • 如果完全不需要默认的resources/views目录，直接替换全局视图路径为自定义路径：

    public function boot()
    {
        // 视图路径指向项目根目录下的 themes/app/views
        View::getFinder()->setPaths([
            base_path('themes/app/views')
        ]);
    }
    

  • 如果要保留默认视图目录，额外新增自定义目录作为优先查找项：

    public function boot()
    {
        // 自定义路径优先级高于默认路径，视图会先从自定义目录查找
        View::addLocation(base_path('themes'));
    }
    

配置完成后，Laravel查找视图时就会扫描你指定的自定义目录。 #

2. 实现getAppTheme()动态加载主题视图 #

这个方法的核心逻辑是动态拼接当前启用主题的视图路径，实现不改控制器代码即可切换前台主题的效果，一般封装为全局辅助函数使用。

操作步骤： #

1. 新建全局辅助函数文件：在app目录下创建helpers.php，用来存放自定义全局函数。
2. 打开项目根目录的composer.json，在autoload配置项中增加files配置，加载刚才新建的辅助函数文件：

"autoload": {
    "psr-4": {
        "App\\": "app/",
        "Database\\Factories\\": "database/factories/",
        "Database\\Seeders\\": "database/seeders/"
    },
    "files": ["app/helpers.php"]
}

3. 命令行执行composer dump-autoload，让自动加载识别新增的辅助函数文件。
4. 在app/helpers.php中编写getAppTheme()函数逻辑：

<?php

if (!function_exists('getAppTheme')) {
    /**
     * 加载当前启用主题下的视图文件
     * @param string $view 视图名称，无需加主题、目录前缀
     * @param array $data 传递给视图的变量数据
     * @param array $mergeData 额外合并的视图数据
     * @return \Illuminate\Contracts\View\View
     */
    function getAppTheme(string $view, array $data = [], array $mergeData = [])
    {
        // 读取当前启用的主题名，默认值为app
        // 后续可以替换为从配置文件、.env、数据库后台配置读取，实现动态切换主题
        $activeTheme = env('APP_THEME', 'app');
        // 拼接完整视图路径，对应 themes/[主题名]/views/[视图路径].blade.php
        $fullViewPath = sprintf('%s.views.%s', $activeTheme, $view);

        return view($fullViewPath, $data, $mergeData);
    }
}

使用方式 #

控制器中直接调用即可，和原生view()方法用法一致：

// 对应加载 themes/app/views/index.blade.php
return getAppTheme('index', ['title' => '首页']);

// 对应加载 themes/app/views/user/profile.blade.php
return getAppTheme('user.profile', ['user' => auth()->user()]);

如果需要切换主题，只要修改.env中APP_THEME的值为新主题目录名，在themes目录下新建对应主题的views目录放视图文件，就可以完成整站主题切换，不需要修改业务控制器代码。 #

注意事项 #

• 自定义目录下的视图文件仍需遵守Laravel视图命名规则，Blade模板后缀为.blade.php，普通PHP模板后缀为.php
• 如果用多主题模式，建议把themes目录作为一级视图路径，不要直接把themes/app/views设为全局路径，否则切换主题时需要重新修改服务提供者配置
• 主题视图如果存在和默认视图同名的文件，因为自定义路径优先级更高，会优先加载主题目录下的视图

参考截图 #

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