phpEnv官网文档在https://www.phpenv.cn/底部“文档”链接,为纯在线中文指南,含安装、版本切换等模块,无PDF或镜像;它非PHP官方项目,不提供API函数,仅作Windows集成环境管理工具。

phpEnv 官方文档不在 php.net 或 PHP 手册体系里,它不是 PHP 官方项目,而是 Windows 平台上的第三方集成环境工具 —— 所以你搜“PHP 中文手册”或访问 php.net/manual/zh/,根本找不到 phpEnv 的内容。
phpEnv 官网和文档入口在哪
官网地址是 https://www.phpenv.cn/,首页底部有「文档」链接,点进去就是它的中文使用指南。页面结构清晰,含安装、站点管理、PHP/MySQL 版本切换、软件商店、端口管理等模块。注意:这个文档没有 PDF 下载版,也没有 GitBook 或 ReadTheDocs 镜像,只在官网在线浏览。
- 别误入
phpenv(小写 p、无空格、GitHub 上的命令行版本管理工具),那是 Linux/macOS 用的,和 phpEnv 完全无关 - 搜索时加引号避免混淆:
"phpEnv 官网"或"phpenv.cn 文档",否则容易被 phpenv、PHP ENV、php-environment 等结果干扰 - 官网文档更新较及时,2025 年底已覆盖 Windows 11 兼容性说明和管理员模式端口释放流程
为什么查不到 phpEnv 的 API 或函数级文档
因为 phpEnv 是图形化桌面应用(基于 Electron + PHP 运行时封装),不提供编程接口,也没有 phpEnv::start() 这类函数。它不参与 PHP 代码执行,只负责启动服务、配置路径、托管 php-cgi.exe 和 mysqld.exe。你写的 PHP 代码里不会调用任何 phpEnv 相关函数 —— 它只是个“看门人”,不是“运行时”。
- 所有“phpEnv 配置项”都存在注册表或
%APPDATA%\phpEnv\config.json里,非开发者无需手动改 - 没有
phpenv.ini或类似配置文件;PHP 的实际配置仍走各版本下的php.ini - 如果你在 IDE 里看到“phpEnv 自动完成”提示,那其实是 IDE 误识别了环境变量 PATH,不是 phpEnv 提供的 SDK
遇到问题该去哪查,而不是翻手册
官网文档偏操作指引,不覆盖报错排查。真实开发中卡住,优先看三处:
- phpEnv 界面右下角的「日志」按钮 → 实时输出
nginx、php-cgi、mysql启动日志,80% 的“打不开网站”“502 Bad Gateway”问题靠这里定位 - 错误弹窗里的具体提示,例如
Failed to start MySQL: port 3306 occupied,直接对应到「端口管理」页一键杀进程 - 官网「支持」页提供的 QQ 群号(非论坛),官方维护者响应较快,比发邮件或 GitHub Issue 更有效
真正容易被忽略的是:phpEnv 启动后,它把当前站点的 php.ini 路径硬编码进 CGI 参数,但 IDE(如 PhpStorm)或命令行终端并不会自动继承这个路径。所以你在 phpEnv 里 phpinfo() 显示 upload_max_filesize = 64M,而终端执行 php -i | grep upload 却是默认值 —— 这不是 bug,是两个不同 PHP 实例。调试前务必确认你查的是哪个 php。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











