phpEnv搭建PHP环境关键在路径、权限和端口:安装路径须无中文空格,需关闭杀软,80/3306端口易被IIS等占用;官网为phpenv.cn,新增站点后须重启服务才生效。

Windows 上用 phpEnv 搭建 PHP 开发环境,不是“装完就能跑”,关键在路径、权限和端口三处——装错位置会写不了配置,不关杀软会卡在组件安装,80 端口被 IIS 或 Skype 占着就启动失败。
怎么下载和避开安装坑
官网地址是 https://www.phpenv.cn/(注意不是 .org 或 .com),别从第三方论坛下“精简版”或“绿色版”,那些常删了 MySQL 服务注册表项,后续连不上数据库。
- 下载后双击安装,**路径必须不含中文、空格、括号**,推荐
D:\phpEnv - 安装时勾选“创建桌面快捷方式”,否则后续找控制面板很麻烦
- 安装前手动关闭 Windows Defender 实时防护,或临时禁用 360/火绒——它们常把
mysqld.exe当可疑进程拦截 - 如果安装完打不开主界面,右键快捷方式 → “以管理员身份运行”,首次启动需要提权写入服务
启动 Apache 和 MySQL 总失败?先查端口
点击控制面板上的“启动”按钮后仍是红色,大概率是端口冲突。Apache 默认用 80,MySQL 用 3306,这两个端口 Windows 自带的 IIS、Skype、甚至某些打印机软件都会抢。
- 点“配置” → “端口检测”,它会自动扫描并标红被占用的端口
- 改 Apache 端口:进
D:\phpEnv\Apache\conf\httpd.conf,搜Listen 80,改成Listen 8080;再搜ServerName localhost:80,改成ServerName localhost:8080 - 改 MySQL 端口:进
D:\phpEnv\MySQL\my.ini,搜port=3306,改成port=3307 - 改完重启 phpEnv 控制面板,再点启动
怎么让浏览器访问到你的 PHP 项目
phpEnv 不是装完就自动把项目挂到 http://localhost 的,得手动“新增站点”并配 hosts。
立即学习“PHP免费学习笔记(深入)”;
- 点控制面板左上角“新增站点”,填域名(如
test.local)、根目录(如D:\projects\myapp)、PHP 版本(下拉选) - 勾选“自动写入 hosts”,它会在
C:\Windows\System32\drivers\etc\hosts末尾加一行:127.0.0.1 test.local - 如果没勾选或失败,手动用记事本(**右键→以管理员身份运行**)打开 hosts 文件,添加上面那行,保存
- 项目里放个
index.php,内容写<?php echo 'OK'; ?>,然后浏览器访问http://test.local(不是http://localhost)
为什么 php -v 还是旧版本或报 command not found
这是混淆了两个工具:phpEnv(Windows 图形化集成环境)和 phpenv(类 Unix 下的命令行多版本管理器)。前者不修改系统 PATH,后者才管 php 命令行。
- 你在 cmd 或 PowerShell 里敲
php -v,调用的是系统 PATH 里的 PHP,跟 phpEnv 控制面板里启的 Apache 无关 - 想在命令行用 phpEnv 自带的 PHP,得去
D:\phpEnv\php\php-8.3.13\这类路径下找真实二进制,或者手动把该路径加进系统环境变量 PATH - 如果真要命令行多版本切换,应该装的是
phpenv(GitHub 上那个),不是这个phpEnv—— 名字差一个字母,但完全不是一回事
最常被忽略的一点:phpEnv 新增站点后,必须点一下控制面板右上角的“重启服务”(不是单启 Apache/MySQL),否则新域名不会生效,test.local 会直接跳转到 Apache 默认页或 404。



















