phpEnv全套安装教程 phpEnv从下载到运行指南-php教程-PHP中文网

phpenv是windows平台绿色php集成环境，支持apache/nginx、多php版本共存及gui操作；phpenv是linux/macos命令行php版本管理工具，仅管理php解释器，需手动配置web服务器和依赖。

phpenv全套安装教程 phpenv从下载到运行指南

别被“phpEnv”和“phpenv”搞混了——前者是 Windows 上开箱即用的集成环境（Apache + MySQL + PHP），后者是类 Unix 系统上管理多版本 PHP 的命令行工具。你如果在 Windows 上双击安装、想跑个 index.php 就看网页，那你要的是前者；如果你在 macOS 或 Linux 终端里敲 phpenv install，那才是后者。选错方向，后面全白忙。

Windows 用户：直接下载 phpEnv（带 GUI 的集成包）

这是最省事的路径，适合刚学 PHP、不想碰编译和 Shell 配置的人。官网最新版（2026 年仍维护）是 phpEnv-2.5.0.exe，不是 GitHub 上那个纯 CLI 工具。

下载后**不要放 C:\Program Files**，路径里不能有中文或空格，推荐 D:\phpEnv
安装时勾选“创建桌面快捷方式”，方便后续启停服务
首次运行会自动检测并安装 Apache/MySQL/PHP 组件，若卡在“正在下载组件”，关掉杀软重试，或手动下载对应 zip 包放进 D:\phpEnv\temp\ 目录再点“重试”
启动后如果 Apache 显示红色（未启动），大概率是 80 端口被 IIS、Skype 或其他程序占了——进控制面板 → “配置” → “端口检测”，把 Apache 改成 8080，然后访问 http://localhost:8080

macOS / Linux 用户：装的是 phpenv（命令行多版本管理器）

它不带 Web 服务器，也不含 MySQL，只管 PHP 解释器本身。你装完它，php -v 会变，但 http://localhost 不会自动出来——那是你自己的 Web 服务器（如 nginx、Valet、Laravel Sail）的事。

必须先装 php-build 插件，否则 phpenv install 命令根本不存在：

git clone https://github.com/php-build/php-build $(phpenv root)/plugins/php-build

Shell 配置文件要对：Bash 用 ~/.bash_profile 或 ~/.bashrc，Zsh 用 ~/.zshrc，别混着写
phpenv install 8.3.13 编译可能失败，常见原因是缺系统依赖：libxml2-dev、openssl-dev、autoconf（macOS 用 brew install autoconf openssl@3 libxml2）
装完版本后必须执行 phpenv rehash，否则 php 命令还是老版本——这是最容易漏的一步

.php-version 文件怎么生效？优先级你得清楚

phpenv 切换版本不是靠记忆，而是按固定顺序查三个地方，找到第一个就停：

btpanel phpsite 宝塔面板PHP网站

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

下载

当前 Shell 会话设的（phpenv shell 7.4.33）→ 最高优先级，退出终端即失效
当前目录下存在 .php-version 文件（内容就一行：8.3.13）→ 项目级锁定，进这个目录自动切
全局设置（phpenv global 8.1.27）→ 最低优先级，兜底用

注意：.php-version 必须是 UTF-8 无 BOM 格式，Windows 记事本保存会悄悄加 BOM，导致 phpenv 读取失败，报错 version not found——用 VS Code 或 Notepad++ 保存时选“UTF-8”而非“UTF-8 with BOM”。