phpEnv环境搭建全过程 phpEnv下载安装手册-php教程-PHP中文网

phpenv（大写e）是windows专用图形化php集成环境，支持apache/nginx/mysql一键启停；phpenv（全小写）是linux/macos命令行php版本管理工具，仅切换php二进制，两者平台、架构、功能完全不兼容。

phpenv环境搭建全过程 phpenv下载安装手册

直接说结论：你看到的 phpEnv（带大写 E）和 phpenv（全小写）是两个完全不同的东西——前者是 Windows 上的图形化集成环境，后者是类 Unix 系统上的 Shell 版本管理工具。搞混它们，90% 的安装会失败或行为异常。

很多人搜“phpEnv 安装”，结果在 macOS 或 Ubuntu 上照着 Windows 教程敲命令，phpenv 报错、phpEnv 根本打不开。关键区别如下：

phpEnv：Windows 专用，官网是 phpenv.cn，带图形界面、Apache/MySQL/Nginx 一键启停，安装包约 200MB，双击安装即可
phpenv：Linux/macOS 专用，纯命令行，用 Git 克隆 + Shell 配置，不带 Web 服务，只管 PHP 二进制切换
两者配置文件、命令语法、路径结构、依赖项全部不通用——phpenv local 8.3.13 在 Windows phpEnv 下无效；phpEnv 的“软件商店”在终端里也不存在

如果你用的是 Windows，并且需要 Apache + PHP + MySQL 一起跑起来（比如本地调试 ThinkPHP、WordPress），就该用 phpEnv：

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

去 phpenv.cn/download.html 下载最新安装包（截至 2026 年 4 月是 v8.9.5），不要从 GitHub 手动 clone
右键以“管理员身份运行”安装程序，路径建议选 C:\phpEnv（避免中文或空格路径导致 Apache 启动失败）
安装完勾选“启动服务”，首次运行会自动弹出防火墙提示，点“允许访问”
浏览器打开 http://localhost，能看到 PHP 探针页，说明 Apache + PHP 已就绪；http://localhost/phpmyadmin 能进 MySQL 管理页，说明 MySQL 正常

如果你在终端里敲 phpenv --version 提示 command not found，不是没装对，而是你误用了 Windows 工具名。正确路径是：

克隆仓库：git clone https://github.com/phpenv/phpenv.git ~/.phpenv
配置 shell（以 zsh 为例）：echo 'export PATH="$HOME/.phpenv/bin:$PATH"' >> ~/.zshrc，再加一行 echo 'eval "$(phpenv init -)"' >> ~/.zshrc
重载：source ~/.zshrc，然后验证 phpenv --version 有输出
装插件才能编译 PHP：git clone https://github.com/php-build/php-build $(phpenv root)/plugins/php-build
装版本前先装系统依赖（Ubuntu）：sudo apt-get install -y autoconf bison build-essential libssl-dev libcurl4-openssl-dev libreadline-dev zlib1g-dev

即使 phpenv install 8.3.13 成功，php -v 还是显示系统自带的老版本？问题大概率出在这两处：

执行 which php，如果返回 /usr/bin/php 或 /opt/homebrew/bin/php，说明 phpenv 的 shim 没生效——检查 ~/.phpenv/shims 是否在 $PATH 最前面，且 eval "$(phpenv init -)" 确实执行了
每次 phpenv install 后必须手动 phpenv rehash，否则新版本的 php 命令不会出现在 shims 目录里，shell 就找不到它
项目级切换用 phpenv local 8.3.13，但当前目录下必须存在 .php-version 文件（它会自动生成），删掉这个文件就退回到全局版本

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！