phpEnv启动失败主因是端口冲突或权限问题：Apache/MySQL显示红色多因80/3306端口被Skype、IIS等占用，应通过控制面板端口检测定位并修改为8080/3307；hosts文件需手动添加127.0.0.1域名映射且重启浏览器生效；php-v显示旧版本系环境变量未指向phpEnv内置PHP，其不自动注入PATH，终端使用需手动配置路径。
phpEnv 启动失败：Apache 或 MySQL 显示红色，点启动没反应
多数情况不是软件坏了，而是端口被占或权限卡住。Windows 下 80（Apache）和 3306（MySQL）端口常被 Skype、IIS、其他开发工具（如 XAMPP、WAMP）或系统服务抢占。
先做两件事：
- 打开 phpEnv 控制面板 → 点击「配置」→「端口检测」，它会自动扫描并高亮冲突端口
- 如果 Apache 显示“启动失败：无法绑定到 80 端口”，不要硬改代码，直接在「配置」→「Apache 配置」里把
Listen改成8080，同时把站点域名后的端口也补上（比如访问http://test.local:8080） - MySQL 同理，可改为
3307，但注意后续用命令行连数据库时要显式加-P 3307 - 装在 C:\Program Files\ 下容易因 UAC 权限导致写入配置失败——重装到
D:\phpEnv是最快解法
添加站点后浏览器打不开，提示“无法访问此网站”或 DNS 错误
phpEnv 本身不改系统 hosts，这步必须手动补全，否则域名根本解析不到本地。
操作路径固定：
立即学习“PHP免费学习笔记（深入）”；
- 用管理员权限打开
C:\Windows\System32\drivers\etc\hosts（推荐用 VS Code 或 Notepad++，别用记事本，容易编码错乱） - 末尾新增一行：
127.0.0.1 test.local（把test.local换成你在 phpEnv 站点管理里填的域名） - 保存后，**必须关闭所有浏览器窗口再重开**，Chrome/Firefox 会缓存 DNS，仅刷新无效
- 如果仍不行，试试用
ping test.local看是否返回127.0.0.1；返回超时说明 hosts 没生效或拼写不一致
php -v 显示旧版本或报 command not found，但 phpEnv 里 PHP 是绿色运行状态
这是典型环境变量混淆：你正在终端里执行的是系统全局 PHP（比如之前装过的 XAMPP 或手动编译版），不是 phpEnv 自带的。
关键判断方式：
- 在命令行运行
which php（Linux/macOS）或where php（Windows CMD）——如果路径指向C:\xampp\php\php.exe或/usr/bin/php，那它就和 phpEnv 无关 - phpEnv 是图形化集成包，它的 PHP 只在内部 Apache 模块里生效，**不自动注入系统 PATH**；想在终端用它的 PHP，得手动加路径，比如 Windows 下把
D:\phpEnv\php\php.exe所在目录加进系统环境变量 - 更稳妥的做法是：别依赖终端
php命令，直接把文件放站点目录，用浏览器访问验证逻辑
安装插件或扩展时报错：“找不到 phpize” 或 “configure: error: Cannot find OpenSSL’s <openssl></openssl>”
phpEnv 自带的 PHP 是预编译二进制，不附带开发头文件（.h）和构建工具（phpize, php-config），所以不能直接编译扩展。
如果你真需要手动装扩展（比如 redis.so 或 grpc）：
- 先确认 phpEnv 版本是否带对应扩展：打开
D:\phpEnv\php\ext\目录，看有没有现成的php_redis.dll（Windows）或redis.so（Linux/macOS） - 有就直接在
php.ini里加extension=redis，然后重启 Apache - 没有且必须自己编译？放弃 phpEnv，改用
phpenv+php-build组合——那是为编译场景设计的，phpEnv 不是 - 常见错误如
Cannot find OpenSSL's <openssl></openssl>，本质是缺少 OpenSSL 开发包，而 phpEnv 没提供安装入口，硬搞只会失败
