安装Yii2高级版后如何解决Class ‘Yii’ not found?【解答】

夏婷酱_2476

夏婷酱_2476

2026-06-02

373人浏览

原创

根本原因是未执行php init、web服务器根目录配置错误或php扩展缺失;需运行init生成入口和配置,将document_root设为frontend/web或backend/web,并确保mbstring、openssl等扩展已启用。

安装yii2高级版后如何解决class \'yii\' not found?【解答】

安装 Yii2 高级版后出现 Class 'Yii' not found,根本原因不是缺文件,而是环境没走通——没执行 init、没配好 Web 服务器入口、或自动加载机制被跳过。下面直击关键环节,逐项排查解决。

必须运行 php init 初始化

高级版的配置是“按需生成”的,不执行 init 就没有有效的 frontend/backend 入口文件、没有环境配置软链、vendor/autoload.php 也不会被正确引入。

  • 进入项目根目录(如 advanced/),执行:
    php init
  • 选择 Development 模式(开发环境)或 Production(上线前再切)
  • init 会生成 environments/ 下的配置,并自动创建软链接到 frontend/web/index.php 和 backend/web/index.php
  • 若跳过这步,直接访问 frontend/web/index.php,必然报 Class 'Yii' not found

Web 服务器 DOCUMENT_ROOT 必须指向子目录

高级版是多入口结构,不能把整个 advanced/ 当网站根目录,否则 PHP 找不到 vendor/autoload.php,也加载不了 Yii 类。

Yii Framework 2.0.51
Yii Framework 2.0.51

Yii Framework 2.0.51 官方 Basic 应用模板,适合旧项目兼容、升级验证和开发测试。

下载
  • Apache/Nginx 的根目录应设为:
    advanced/frontend/web/(前台)或 advanced/backend/web/(后台)
  • 确认 web/index.php 文件顶部有:
    require(__DIR__ . '/../../vendor/autoload.php');
    和
    require(__DIR__ . '/../../common/config/bootstrap.php');
  • 如果用本地 PHP 内置服务器测试,命令应为:
    php -S localhost:8000 -t frontend/web frontend/web/router.php

检查 PHP 环境与扩展是否就绪

即使 init 跑了、路径对了,PHP 缺关键扩展也会导致 autoload 失败,最终表现为类找不到。

  • 运行 php -v 确认版本在 7.4–8.1 区间(Yii2 不兼容 PHP 8.2+ 的只读类等变更)
  • 运行 php -m | grep -E "(mbstring|openssl|pdo|json)",确保以下扩展已启用:
    • mbstring
    • openssl
    • pdo(及对应数据库驱动,如 pdo_mysql)
    • json
  • 若用 XAMPP/MAMP/WAMP,请确认终端中 php -v 和 Web 服务器调用的是同一套 PHP

代码中引用 Yii 的写法要规范

这个错误有时也出现在控制器或视图里写错命名空间,尤其混用大小写或漏反斜杠。

  • 全局使用 \Yii(注意开头的反斜杠),例如:
    $id = \Yii::$app->request->get('id');
  • 不要写成 Yii 或 YII(大小写敏感)或 app\controllers\Yii(错误命名空间)
  • 在命名空间内(如 frontend\controllers),仍需用 \Yii 显式调用全局类,不能省略反斜杠

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2023.09.01

9824

6

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

5861

5

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

2075

5

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

2023.10.23

3648

4

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

2023.10.23

4354

6

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.03

3411

9

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.09

4857

8

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.13

3802

8

sprintf函数用法详解
sprintf函数用法详解

sprintf函数的用法:1、格式化字符串;2、指定输出宽度和精度;3、返回值。更多关于sprintf函数用法详解的内容,大家可以阅读下面的文章。

2023.11.27

11782

4

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Yii Framework 2.0 API 官方文档
Yii Framework 2.0 API 官方文档

共0课时 | 0人学习

Yii2.0框架开发实战视频教程
Yii2.0框架开发实战视频教程

共22课时 | 9.3万人学习