Yii 2.0.49+ 和 Yii 3.0.10+ 支持 PHP 8.2，安装需确认 PHP 版本精确匹配、扩展启用及依赖版本锁定；推荐使用 composer create-project 拉取兼容版本，并通过测试脚本验证 __toString() 行为。
在PHP 8.2环境下安装Yii框架时，必须确认所选版本支持该PHP版本，否则composer install会因依赖冲突失败或运行时报Fatal error。
确认Yii版本兼容性
Yii 2.0.49+ 和 Yii 3.0.10+ 已正式支持PHP 8.2，但Yii 2.0.48及更早版本会因mbstring.func_overload弃用、__toString()严格性增强等问题报错。访问Yii 2发布页或Yii 3核心库发布页，核对最新稳定版的PHP要求说明。
执行php -v确认当前CLI PHP版本确为8.2.x（非8.1或8.3），【PHP版本必须精确匹配，Yii 2.0.49不兼容PHP 8.2.0-beta】。
安装Yii 2.0（推荐稳定项目）
方法一：使用Composer创建新项目
立即学习“PHP免费学习笔记（深入）”；
运行命令：composer create-project --prefer-dist yiisoft/yii2-app-basic basic。Composer将自动解析并锁定兼容PHP 8.2的最高可用Yii 2版本（≥2.0.49）。
方法二：手动指定版本安装
若需精确控制版本，执行：composer create-project --prefer-dist yiisoft/yii2-app-basic basic 2.0.49。这能避免因全局Composer配置缓存导致拉取旧版。
方法三：升级现有Yii 2项目
进入项目根目录→执行composer require yiisoft/yii2:"^2.0.49"→运行composer update yiisoft/yii2。升级后务必检查vendor/yiisoft/yii2/CHANGELOG.md中关于PHP 8.2的修复项。
安装Yii 3.0（现代架构首选）
第一步：确保已启用PHP 8.2的ext-json、ext-pdo、ext-mbstring扩展——缺一不可，否则composer create-project会中断并提示“requirement not met”。
第二步：执行composer create-project --prefer-dist yiisoft/app myapp。该命令默认拉取Yii 3最新稳定版（≥3.0.10），并自动配置PSR-4自动加载与DI容器基础结构。
第三步：进入myapp目录→运行php serve启动内置服务器。浏览器访问http://localhost:8080，页面显示“Hello, world!”即表示PHP 8.2与Yii 3运行链路通畅。
注意：Yii 3不再提供index-test.php，单元测试需通过./vendor/bin/phpunit直接触发，且测试套件必须使用PHPUnit 10+（Yii 3.0.10已适配）。
验证PHP 8.2兼容性关键点
在项目根目录新建test-php82.php，写入以下代码：
<?php<br>class Test { public function __toString() { return 'ok'; } }<br>echo (string)(new Test());<br>?>
执行php test-php82.php，输出ok说明__toString()隐式调用正常——这是Yii 2.0.49修复的核心PHP 8.2行为之一。
删除test-php82.php文件。
