Yii2 最低要求 PHP 7.4，但强烈建议使用 PHP 8.1 或 8.2；必须启用 mbstring、openssl、pdo（含驱动）、json、curl 扩展；Composer 版本不低于 2.2 且需卸载 fxp-asset 插件；Windows 下需正确配置 php.ini 中 extension_dir 和 date.timezone。
Yii2 运行最低 PHP 版本是 7.4，但实际建议用 8.0+
Yii2.0.x 系列（当前主流稳定版）官方文档明确要求 PHP ≥ 7.4，但 7.4 已于 2022 年 11 月停止安全支持。很多扩展（比如 symfony/polyfill 的新版本、guzzlehttp/guzzle 7+）在 7.4 下会触发弃用警告或运行时错误。
实操建议：
- 开发环境直接上
8.1或8.2——避免踩mbstring.func_overload被移除、mysql_*彻底消失等兼容性雷 - 别信“只要 composer install 成功就 OK”——有些扩展装得进去，但运行时调用
str_contains()这类8.0+函数会直接报Fatal error: Uncaught Error: Call to undefined function - 检查方式：终端执行
php -v，再确认php -m | grep -E 'mbstring|openssl|pdo|json|curl|gd|xml'输出是否全在
composer create-project 前必须确认的 5 个扩展
Yii2 安装过程不报错，不代表能跑起来。常见白屏或 Class not found 错误，90% 出在扩展缺失，而非 Composer 包没下全。
必须启用的 PHP 扩展（缺一不可）：
立即学习“PHP免费学习笔记（深入）”；
-
mbstring：Yii2 内部大量使用多字节字符串处理，没它连UrlManager解析路由都失败 -
openssl：Composer 安装依赖、yii\helpers\BaseStringHelper::base64UrlEncode都依赖它 -
pdo+ 对应驱动（如pdo_mysql或pdo_pgsql）：哪怕你暂时不用数据库，框架启动时也会尝试加载PDO类 -
json：配置文件解析、日志序列化、REST 接口响应都靠它，PHP 编译时禁用--disable-json就彻底废了 -
curl（非绝对必需但强烈建议）：调试时yii\debug\Module的 AJAX 加载、第三方 SDK（如微信、支付宝）集成基本都走它
验证命令：php -m 看列表，或写个 test.php 里放 var_dump(extension_loaded('mbstring'));
Composer 版本不能低于 2.2，且需关闭 fxp-asset
Yii2 官方模板（yii2-app-basic / yii2-app-advanced）从 2021 年起已弃用 fxp/composer-asset-plugin，改用 composer/installers + asset-packagist。但旧版 Composer（1.x 或 2.0～2.1）仍可能偷偷启用插件，导致安装卡死或报 Could not fetch https://asset-packagist.org。
实操步骤：
- 升级 Composer：
composer self-update→ 确认输出含Composer version 2.2.0或更高 - 删掉残留插件：
composer global remove fxp/composer-asset-plugin（如果之前装过） - 检查是否干净：
composer global list输出里不应出现fxp相关条目 - 安装命令统一用：
composer create-project --prefer-dist yiisoft/yii2-app-basic basic，别加-s dev（不稳定分支容易拉到不兼容的 dev-master）
Windows 下 php.ini 的两个隐藏陷阱
Windows 用户常遇到 require(): Failed opening required 'vendor/autoload.php' 或 ReflectionException: Class yii\web\Application does not exist，问题不在代码，而在 PHP 配置。
重点检查 php.ini 中这两项：
-
extension_dir必须指向真实扩展目录，例如C:\php\ext（注意路径分隔符是反斜杠，但值里写正斜杠也 OK）；若写成./ext或相对路径，extension=mbstring会静默失效 -
date.timezone必须显式设置（如date.timezone = "Asia/Shanghai"），否则 Yii2 启动时DateTimeZone::__construct()抛Warning，某些环境下会中断 autoloader 初始化 - 改完记得重启 Web 服务（Apache/Nginx）或 CLI 终端——Windows 下
php --ini显示的 ini 文件路径，和 Apache 加载的可能是两个不同文件
复杂点在于：WAMP/XAMPP 自带的 php.ini 可能被覆盖，而 Composer 调用的是 CLI 模式的 php.ini，Web 请求走的是 Apache 模块的 php.ini，两者要分别确认。
