phpEnv仅提供本地PHP+MySQL+Nginx环境,WordPress需手动解压至www目录并重命名为域名(如wp.test),修改hosts添加127.0.0.1 wp.test,数据库主机必须填127.0.0.1而非localhost,且需确保wp-config.php配置正确、PHP版本兼容。

phpEnv 本身不“安装” WordPress,它只是提供一个开箱即用的 Windows 本地 PHP+MySQL+Nginx 环境;WordPress 是你手动解压、配置数据库、再通过浏览器访问完成初始化的独立程序。关键不是 phpEnv 能不能装,而是路径、数据库连接、hosts 这三处最容易卡住。
把 WordPress 放进 www 目录并重命名成域名对应名
phpEnv 默认的 Web 根目录是 phpEnv\www,Nginx 配置里写死只认这个路径下的子目录作为站点。如果你直接把解压后的 wordpress 文件夹丢进去,访问 localhost/wordpress 会报 404 或跳转失败——因为 phpEnv 的默认配置不支持子路径式部署。
实操建议:
- 下载 WordPress 中文版(如
latest-zh_CN.zip),解压出wordpress文件夹 - 把它整个重命名为你要访问的域名,比如
wp.test(注意:不能带空格、下划线或中文) - 拖进
phpEnv\www目录下,最终路径是phpEnv\www\wp.test - 确保该目录里有
wp-config.php、index.php和wp-admin等核心文件
必须改 hosts 并确认 Nginx 已加载该域名
phpEnv 启动后,默认只响应 localhost。你想用 wp.test 访问,就必须让系统知道这个域名指向本机,否则浏览器根本不会把请求发给 phpEnv 的 Nginx。
常见错误现象:输入 wp.test 浏览器显示“无法访问此网站”或直接跳转到搜索引擎。
实操建议:
- 用管理员权限打开记事本,打开
C:\Windows\System32\drivers\etc\hosts - 在末尾新增一行:
127.0.0.1 wp.test(不要加http://,也不要漏空格) - 保存前若提示“无权限”,就把 hosts 拖到桌面修改,再拖回去覆盖
- 回到 phpEnv 主界面,点击右上角“站点管理” → 确认
wp.test已出现在列表中;如果没有,点“添加站点”,根目录选phpEnv\www\wp.test,端口保持 80
wp-config.php 手动配置数据库时别填 localhost
很多教程说数据库主机填 localhost,但在 phpEnv 的 MySQL 实例里,PHP 进程通过 socket 连接更稳;填 localhost 反而可能触发 DNS 解析延迟,导致安装页面卡在“正在连接数据库”或报错 mysqli_real_connect(): (HY000/2002): No such file or directory。
实操建议:
- 安装前先用 phpEnv 自带的 phpMyAdmin(地址通常是
http://localhost/phpmyadmin)创建好数据库,字符集选utf8mb4_unicode_ci - 在
phpEnv\www\wp.test目录下复制wp-config-sample.php,重命名为wp-config.php - 编辑该文件,把这三行改成实际值:
define('DB_NAME', 'wp_test');
define('DB_USER', 'root');
define('DB_PASSWORD', '');
define('DB_HOST', '127.0.0.1'); // 关键:这里必须写 127.0.0.1,不是 localhost
表前缀 $table_prefix 可以保留默认 wp_,但如果你以后要共用一个数据库跑多个站,就得改成唯一前缀,比如 wp2_。
安装过程中遇到白屏或 500 错误怎么办
phpEnv 默认开启的 PHP 版本可能是 7.4 或 8.0+,而某些老版本 WordPress(比如 5.8 之前)在 PHP 8.0+ 下会因函数弃用直接白屏,连错误提示都不输出。
实操建议:
- 先确认你下载的 WordPress 版本是否支持当前 phpEnv 的 PHP 版本(查官网系统要求);推荐用 WordPress 6.5+ 配 PHP 8.1+
- 打开 phpEnv 主界面 → “PHP 版本” → 切换到 PHP 7.4(最兼容)再试一次
- 如果还是白屏,临时开启 PHP 错误显示:编辑
phpEnv\php\php.ini,找到display_errors = Off改为On,再重启服务 - 检查
wp.test目录权限:确保 Windows 用户对该文件夹有“完全控制”权,否则wp-content下无法自动生成插件/主题目录
真正麻烦的从来不是点击“安装 WordPress”那一下,而是 wp-config.php 里 DB_HOST 填错、hosts 没生效、或者目录名和域名不一致——这三个点漏掉任何一个,整个流程就会静默失败,没有任何明确报错。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











