phpEnv是Windows下最省事的本地WordPress开发环境，但默认PHP版本（如7.4）不兼容WordPress 6.4+的PHP 8.1+要求，需手动切换至PHP 8.2+、将DB_HOST设为“127.0.0.1:3306”、启用mysqli和pdo_mysql扩展，并重启所有服务。
直接说结论：phpEnv 是 Windows 下最省事的本地 WordPress 开发环境，但默认配置不兼容 WordPress 6.4+ 的 PHP 8.2+ 要求，必须手动切换 PHP 版本并修正 wp-config.php 中的数据库连接方式，否则安装页卡在「建立数据库连接时出错」。
phpEnv 启动后 nginx 和 MySQL 绿了，但访问 localhost 白屏或 500 错误
这是最常见的启动即失败场景。原因不是服务没起来，而是 phpEnv 默认启用的 PHP 版本（如 7.4）与 WordPress 6.4+ 的最低要求（PHP 8.1+）不匹配，导致 index.php 解析失败。
- 打开 phpEnv 主界面 → 点击右上角「设置」→ 「PHP 版本」→ 选择
php-8.2.22或更高（WordPress 官方明确要求 PHP ≥8.1） - 切换后务必点击「重启所有服务」，不能只点「重启 PHP」
- 确认
www目录下没有残留的旧版 WordPress 文件夹（比如wordpress-old），避免 nginx 自动索引到错误入口 - 如果仍白屏，检查浏览器开发者工具 Network 标签页，看是否返回 500 且响应体含
PHP Parse error—— 这是版本不兼容的铁证
填写数据库信息后提示「建立数据库连接时出错」
这个错误看起来是数据库问题，实际 90% 出在 wp-config.php 自动生成逻辑和 phpEnv 的 MySQL 配置差异上。phpEnv 的 MySQL 默认监听 127.0.0.1:3306，但 WordPress 安装脚本常把 localhost 解析为 Unix socket，而 phpEnv 并未启用 socket 支持。
- 安装页面填库名、用户名、密码时，主机地址必须写成
127.0.0.1，不能写localhost - 如果已失败，进入
www/wordpress/目录，手动编辑wp-config.php，找到DB_HOST行，改为：define('DB_HOST', '127.0.0.1:3306'); - 确保 MySQL 服务确实在运行：phpEnv 界面中 MySQL 右侧红点变绿；或者命令行执行
mysql -h 127.0.0.1 -u root -proot能直接登录（默认密码是root） - 不要用 Navicat 创建数据库时勾选「Collation」为
utf8mb4_0900_ai_ci（MySQL 8.0+ 默认），WordPress 6.4 兼容性更好是utf8mb4_unicode_ci
安装完成后访问首页显示「致命错误：Uncaught Error: Call to undefined function mysql_connect()」
这是典型的 PHP 扩展缺失错误。WordPress 6.4 已彻底移除对旧式 mysql_* 函数的支持，转而强制使用 mysqli 或 pdo_mysql。phpEnv 的 PHP 8.2 默认不启用这些扩展。
立即学习“PHP免费学习笔记（深入）”；
- 进入 phpEnv 安装目录 → 找到
php/php-8.2.22/ext/，确认存在php_mysqli.dll和php_pdo_mysql.dll - 编辑对应 PHP 版本的
php.ini（路径如php/php-8.2.22/php.ini），取消以下两行前的分号：extension=mysqliextension=pdo_mysql - 保存后，回到 phpEnv 界面 → 「重启所有服务」→ 再刷新 WordPress 后台
- 验证是否生效：新建一个
phpinfo.php放在www/下，内容为<?php phpinfo(); ?>，浏览器访问，搜索mysqli，看到「enabled」即成功
真正麻烦的从来不是步骤多，而是 phpEnv 的图形界面掩盖了底层配置的耦合关系——比如切换 PHP 版本不重启 nginx，fastcgi_pass 依然指向旧版 sock 文件；又比如 MySQL 密码改过但没同步到 wp-config.php。动手前先看一眼 phpEnv/logs/ 下的 nginx-error.log 和 php-error.log，比猜错误类型快十倍。
