核心是三步：装对PHP版本（推荐7.4.33或8.0.28）、配好扩展（openssl/mbstring/pdo_mysql/curl/xml）、改对Web路径（DocumentRoot须指向basic/web）；避开PHP 8.3及根目录误配等坑即可顺利部署。
在 Windows 下用 phpEnv 搭建 Yii2 开发环境，核心不是“一键”，而是理清三步：装对 PHP 版本、配好扩展、改对 Web 服务器路径。只要避开几个常见坑，整个过程很顺。
确认 phpEnv 的 PHP 版本兼容 Yii2
Yii2.0.x 要求 PHP ≥ 5.4.0（推荐 7.2–7.4），Yii2.1+ 最低需 PHP 7.4，官方已不支持 PHP 8.2+ 的部分特性（如某些反射行为）。phpEnv 默认带多个 PHP 版本包，安装前先打开 phpEnv 控制面板 → “PHP 版本”页，勾选 PHP 7.4.33 或 PHP 8.0.28（稳定且广泛验证过）。别选最新版 PHP 8.3——Yii2 当前主干尚未完全适配。
启用 Yii2 必需的 PHP 扩展
Yii2 运行依赖几个关键扩展，phpEnv 安装后默认可能未开启：
- openssl：处理 HTTPS 请求、密码加密（如用户登录）
- mbstring：多字节字符串处理（中文路由、表单验证必需）
- pdo_mysql（或 pdo_sqlite）：数据库连接基础
- curl：调用外部 API（如微信登录、支付回调）
- xml：部分扩展（如 SOAP、sitemap 生成）会用到
操作方式：在 phpEnv 主界面 → 点击对应 PHP 版本右侧的“配置”按钮 → 勾选上述扩展 → 点击“保存并重启服务”。完成后可在浏览器访问 http://localhost/phpinfo.php 查看是否生效。
Windows TTS (WSL2)
下载
在 Windows 11 上"直接发声"的 TTS（从 WSL2/TUI 调用 powershell.exe + System.Speech）。适用于用户说"说出来/读出来/语音播报/用TTS"，或反馈"没声音/tts 生成的 mp3 是空的/播不出来"，以及需要中文语音但 OpenClaw 内置 tts 不可用时。
立即学习“PHP免费学习笔记（深入）”；
把 Yii2 项目放进 phpEnv 的 Web 根目录
phpEnv 默认 Web 根路径是 C:\phpEnv\www（不是 Apache 或 Nginx 自带的 htdocs）。部署 Yii2 时：
- 用 Composer 创建项目：
cd C:\phpEnv\www<br>composer create-project --prefer-dist yiisoft/yii2-app-basic basic
- 确保 Web 服务器指向的是
basic/web目录，不是项目根目录。phpEnv 的 Apache/Nginx 配置默认已映射/到C:\phpEnv\www，所以访问http://localhost/basic/web/即可运行；如想用http://localhost/basic/，需在 phpEnv 的“网站管理”中新增虚拟主机，DocumentRoot 设为C:\phpEnv\www\basic\web。 - 首次访问若报错“Setting timezone is not supported”，编辑
C:\phpEnv\php\php74\php.ini，取消注释并修改：date.timezone = Asia/Shanghai
可选但推荐：开启 Yii2 调试工具条
开发阶段建议启用 Debug Toolbar：
- 确保
basic/web/index.php中的YII_DEBUG和YII_ENV为 true 和 dev： - 检查
basic/config/web.php是否包含'debug' => 'yii\debug\Module'（默认已有） - 若仍不显示，确认
vendor/bin/yii可执行（需 phpEnv 的 CLI PHP 路径加入系统环境变量，或直接用C:\phpEnv\php\php74\php.exe vendor/bin/yii启动）
