Laravel 配置双模板

2018-12-17 / PHP / Hoe

在开发过程中, 不时会遇到某些项目需要使用两套模板

如PC端和Mobile端使用不同的模板文件, 以达到最佳的用户体验

遇到这种情况我们应该如何配置Laravel的模板文件呢?

1. 安装`whichbrowser/parser` 传送门: WhichBrowser/Parser-PHP

用于判断PC或Mobile设备, 按需加载不同的模板

composer require whichbrowser/parser

2. 使用`artisan`命令新建一个`Middleware`(中间件)

执行后会在app/Http/Middleware目录生成中间件文件

php artisan make:middleware Template

3. 编辑`Template.php`文件

class Template
{
    protected $except = [];

    public function handle($request, Closure $next)
    {
        $result = new WhichBrowser\Parser(getallheaders());
        // 如果是桌面类型, 返回true
        $isDesktop = $result->isType('desktop');
        if ($isDesktop) {
            // 加载pc端的模板文件
            $path = resource_path('views/pc/');
        } else {
            // 加载mobile端的模板文件
            $path = resource_path('views/mobile/');
        }
        // 获取视图查找器实例
        $view = app('view')->getFinder();
        // 重新定义视图目录
        $view->prependLocation($path);
        // 返回请求
        return $next($request);
    }
}

4. 最后注册中间件

在app/Http/Kernel.php类中按需注册中间件

如注册全局中间件:

protected $middleware = [
    \App\Http\Middleware\Template::class,
];

搞定, 就可以根据不同的设备加载不同的模板文件了

在控制中只需这样, 就可以根据不同的设备来加载不同的模板了

return view('registration.index', $data);

如从PC设备打开网页: 加载 /resources/views/pc/registration/index.blade.php 模板

如从移动设备打开网页: 加载 /resources/views/mobile/registration/index.blade.php 模板

5.异常页面的处理

异常处理传送门 Laravel 的错误和日志记录

对于异常页面，我们自然也需要双模板进行展示

伪代码如下：

/**
 * Render an exception into an HTTP response.
 *
 * @param  \Illuminate\Http\Request  $request
 * @param  \Exception  $exception
 * @return \Illuminate\Http\Response
 */
public function render($request, Exception $exception)
{
    // 自定义HTTP错误页面
    if ($exception instanceof HttpException) { // HTTP异常
        $status = $exception->getStatusCode();
        $message = $exception->getMessage();
        $result  =  new  WhichBrowser\Parser(getallheaders());
        $isDesktop = $result->isType('desktop');
        if ($isDesktop) {
            $dir = 'pc';
        } else {
            $dir = 'mobile';
        }
        
        $view = $dir . '.error.' . $status;
        if (view()->exists($view)) {
            return response()->view($view, ['message'=>$message], $status);
        }
    }
    return parent::render($request, $exception);
}

移动端的错误页面：/resources/views/mobile/error/500.blade.php

PC端的错误页面：/resources/views/pc/error/404.blade.php

搞定！

已有 8 条评论

Laravel 配置双模板 R11; 前端开发，JQUERY特效，全栈开发，vue开发 2019-03-04 09:22 回复

[...]原文: Laravel 配置双模板[...]
楚狂人博客 2018-12-23 18:20 回复

一直用wordpress，但是佩服博主的专业
1. Hoe 2018-12-24 09:14 回复
  
  过奖了, 小小体验过wordpress, 很有魅力
张波博客 2018-12-22 16:13 回复

学习了，没有折腾过这个东西
。。。 2018-12-21 13:06 回复

解开了
小彦 2018-12-18 12:15 回复

学习了，好文章，方便了处理两种模板，不用自己写判断了…… 另外震动效果我眼花了😋
Quanyin 2018-12-17 20:27 回复

PC端和mobile端使用完全不同的模板现在很常见么？感觉好像用同一天模板然后通过css媒体查询实现自适应响应更多些？
1. Hoe 2018-12-17 20:32 回复
  
  现在都使用响应式布局了，这种模式已经不常见了。但是特殊情况下，还是需要用这种方式开发会比较方便些