Yii2框架如何渲染视图子文件夹内的视图文件？

刚上手Yii2遇到这种视图访问不了的情况太常见了，我帮你从几个核心点排查解决：

1. 匹配对应的控制器（最常规的做法） #

Yii2的MVC结构里，视图文件夹默认和控制器一一对应。你在views下建了blog文件夹，那得在controllers目录下创建对应的BlogController.php文件，代码示例如下：

<?php
namespace app\controllers;

use yii\web\Controller;

class BlogController extends Controller
{
    // 对应views/blog/index.php的action
    public function actionIndex()
    {
        // 如需传递数据到视图，可写成 return $this->render('index', ['data' => $data]);
        return $this->render('index');
    }
}

创建完成后，你可以通过你的域名/index.php?r=blog/index访问这个视图；如果已经配置了URL美化（去掉index.php），直接访问你的域名/blog/index即可。

2. 无需新增控制器，在现有控制器里渲染视图 #

如果不想单独创建BlogController，也可以在已有的控制器（比如SiteController）里新增一个action，指定渲染views/blog/index.php：

// 在app\controllers\SiteController.php里新增方法
public function actionBlog()
{
    // 使用@app别名指定视图的绝对路径
    return $this->render('@app/views/blog/index');
}

这时访问你的域名/index.php?r=site/blog就能看到这个视图了。

3. 检查URL路由配置（若开启了URL美化） #

如果你的项目已经配置了urlManager实现友好URL，记得在config/web.php里添加对应的路由规则，确保请求能正确映射到对应的action：

'components' => [
    // 其他组件配置...
    'urlManager' => [
        'enablePrettyUrl' => true,
        'showScriptName' => false,
        'rules' => [
            // 让访问/blog直接对应blog/index action
            'blog' => 'blog/index',
            // 其他已有的路由规则...
        ],
    ],
],

4. 排查视图文件本身的问题 #

最后别忘了检查：

• views/blog/index.php的文件权限，确保服务器有读取权限；
• 文件内容有没有语法错误，比如PHP标签是否正确、有没有未闭合的代码块，这些都会导致视图无法正常渲染。

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