phpEnv是一款常用的Windows本地集成开发环境工具，默认会预置部分主流PHP版本，但实际开发中经常会遇到项目需要特定PHP版本的情况，这时候就需要手动添加自定义PHP版本到phpEnv中。
准备工作
在手动添加PHP版本前，需要先完成以下准备操作：
- 确认当前phpEnv的版本，避免兼容问题
- 下载对应系统架构的PHP安装包，Windows系统建议选择Thread Safe（线程安全）版本，适配phpEnv的Apache服务
- 如果下载的PHP版本需要对应VC运行库，提前安装好对应版本的Visual C++ Redistributable
PHP安装包下载注意事项
访问PHP官方Windows下载页面，根据系统位数选择x64或者x86版本，注意要和phpEnv的系统架构保持一致。比如phpEnv是64位版本，就需要下载x64的PHP包。同时要注意PHP版本对应的VC依赖，比如PHP 7.4需要VC15运行库，PHP 8.1需要VS16运行库，缺少运行库会导致PHP无法正常运行。
手动添加PHP版本步骤
第一步：解压PHP安装包
将下载好的PHP压缩包解压，得到PHP程序文件夹，建议重命名为php+版本号的格式，比如php7.4.33，方便后续识别。然后将这个文件夹移动到phpEnv安装目录下的php文件夹中，默认路径一般是D:phpEnvphp，如果修改过安装路径则对应调整。
第二步：配置PHP基础文件
进入刚移动的PHP文件夹，找到php.ini-development文件，复制一份并重命名为php.ini，这是PHP的配置文件。打开php.ini文件，修改以下基础配置：
; 设置扩展文件目录，修改为当前PHP文件夹下的ext路径 extension_dir = "D:phpEnvphpphp7.4.33ext" ; 开启常用扩展，根据项目需求选择开启 extension=mysqli extension=pdo_mysql extension=gd extension=curl extension=mbstring extension=openssl ; 设置时区 date.timezone = PRC
第三步：修改phpEnv配置
打开phpEnv安装目录下的配置文件phpEnv.ini，如果是默认安装路径一般在D:phpEnvphpEnv.ini。在配置文件中找到PHP版本配置区域，按照已有版本的格式添加自定义PHP版本的信息：
; 已有版本示例 [php] php5.6.40 = D:phpEnvphpphp5.6.40php.exe php7.2.34 = D:phpEnvphpphp7.2.34php.exe php7.4.33 = D:phpEnvphpphp7.4.33php.exe php8.0.30 = D:phpEnvphpphp8.0.30php.exe ; 添加自己的自定义版本，比如要添加php8.1.23 php8.1.23 = D:phpEnvphpphp8.1.23php.exe
注意路径要填写到对应PHP文件夹下的php.exe可执行文件的完整路径，不要写错。
第四步：重启phpEnv服务
保存所有修改的配置文件，打开phpEnv面板，先点击停止所有服务，等待服务全部停止后，再点击启动所有服务。启动完成后，点击phpEnv面板上的PHP版本切换按钮，查看下拉列表中是否出现了刚添加的自定义PHP版本。
验证自定义PHP版本是否生效
在phpEnv的网站根目录下新建一个test.php文件，写入以下测试代码：
<?php // 输出当前PHP版本信息 echo "当前PHP版本：" . phpversion(); // 输出当前PHP配置文件路径 echo "<br>配置文件路径：" . php_ini_loaded_file(); ?>
在浏览器中访问http://127.0.0.1/test.php，如果页面显示的内容和添加的自定义PHP版本一致，说明自定义PHP版本已经成功添加到phpEnv中。
常见问题解决
- 如果切换版本后PHP无法运行，首先检查php.ini中extension_dir路径是否正确，再确认对应的VC运行库是否已经安装
- 如果phpEnv面板没有显示新添加的版本，检查phpEnv.ini中版本配置的路径是否有误，php.exe文件是否存在
- 如果部分扩展无法加载，确认对应扩展的dll文件是否在ext目录下，php.ini中是否开启了该扩展