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，两者要分别确认。
评论(0)