yii2的main.php是应用主体配置文件，位于config/web.php（web应用）或config/main.php（控制台应用），在index.php中通过require加载并传入new yii\web\application()初始化。
main.php 配置文件位置和加载时机
Yii2 的 main.php 是应用主体（web/index.php 中创建的 yii\web\Application 实例）的配置文件，不是框架内置文件，而是你项目里自定义的 PHP 数组返回值。它通常放在 config/web.php（Web 应用）或 config/main.php（控制台应用），具体路径取决于你 index.php 里怎么写的 require。
关键点：它必须返回一个数组，且该数组最终被传给 new yii\web\Application($config)。写错格式（比如漏了 return、用了 echo、包含输出）会导致白屏或「Headers already sent」错误。
核心配置项不能少：id、basePath、components
最小可运行的 main.php（即 config/web.php）至少要包含这三个键：
-
id：字符串，唯一标识应用，不能为空或纯数字 -
basePath：指向应用根目录（通常是@app对应的路径），推荐用别名：'basePath' => dirname(__DIR__) -
components：必须是数组，哪怕只配一个request或response；空数组允许，但删掉整个键会报错「Invalid Configuration – yii\base\InvalidConfigException」
常见错误示例：'components' => [] ✅ 可运行'components' => null ❌ 报错// 忘了 return ❌ 白屏
数据库、URL 管理、调试模块这些怎么加
这些都属于 components 下的子配置，不是顶层字段。比如加数据库连接：
'components' => [
'db' => [
'class' => 'yii\db\Connection',
'dsn' => 'mysql:host=localhost;dbname=myapp',
'username' => 'root',
'password' => '',
'charset' => 'utf8mb4',
],
]
URL 美化要同时配 urlManager 和启用 mod_rewrite（Apache）或重写规则（Nginx）：
'components' => [
'urlManager' => [
'enablePrettyUrl' => true,
'showScriptName' => false, // 需 Web 服务器隐藏 index.php
'rules' => [
'<controller:>/<action:>>' => '<controller>/<action>',
],
],
]</action></controller></action:></controller:>
调试工具（yii\debug\Module）只应在开发环境启用，且必须在 modules 键下配置，不是 components：
'modules' => [
'debug' => 'yii\debug\Module',
],
并且确保 bootstrap 数组里有 'debug'，否则面板不加载。
环境判断和配置合并容易漏掉的细节
生产环境禁用调试、关闭错误显示，不能只靠注释掉 debug 模块——还要关 errorHandler 的 throwException 和 displayErrorDetails：
- 用
YII_ENV判断环境：defined('YII_ENV') && YII_ENV === 'dev' -
vendor/yiisoft/yii2/Yii.php会在入口文件自动定义YII_ENV，值来自index.php上方的define('YII_ENV', 'prod') - 配置合并建议用
yii\helpers\ArrayHelper::merge()，避免子数组被完全覆盖（比如components里只写'log' => [...]会丢掉默认的request、response）
最常被忽略的是：修改 main.php 后，如果开了配置缓存（php yii cache/flush-schema 或手动删 runtimes/cache/），必须清缓存，否则改了也不生效。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
