phpEnv是一款便捷的Windows平台PHP集成环境工具，支持快速切换PHP版本、管理各类PHP扩展，很多开发者会选择它来搭建本地开发环境。如果需要在phpEnv中使用Phalcon框架开发应用，就需要先完成Phalcon扩展的安装与配置。
准备工作
在开始配置之前，需要先确认两个关键信息，避免后续出现版本不匹配的问题：
- 当前phpEnv中使用的PHP版本，比如PHP 7.4、PHP 8.0等
- PHP的线程安全模式，phpEnv默认安装的PHP通常是线程安全版本，可在phpinfo页面中查看Thread Safety字段，值为enabled就是线程安全版本
下载对应版本的Phalcon扩展
Phalcon扩展需要根据PHP版本和线程安全模式选择对应的文件，下载步骤如下：
- 打开Phalcon官方扩展下载页面，找到对应PHP版本的扩展包
- 根据PHP的线程安全状态选择对应的文件，线程安全版本选择带ts标识的文件，非线程安全版本选择带nts标识的文件
- 下载完成后解压压缩包，会得到
php_phalcon.dll文件
将扩展文件放入phpEnv扩展目录
找到phpEnv当前使用的PHP版本的扩展目录，通常路径为phpEnv安装目录phpphp对应版本ext，将解压得到的php_phalcon.dll文件复制到这个ext目录下即可。
修改php.ini配置文件
接下来需要修改PHP的配置文件来启用Phalcon扩展：
- 打开phpEnv面板，点击对应PHP版本后面的配置按钮，选择编辑php.ini
- 在php.ini文件末尾添加如下配置：
; 启用Phalcon扩展 extension=php_phalcon.dll
如果php.ini中已经存在其他extension配置，直接加在同类配置下方即可，注意不要写错扩展文件名。
重启phpEnv服务
修改完php.ini配置后，需要重启PHP服务让配置生效：
- 在phpEnv面板中，先点击停止按钮，停止当前运行的Apache或者Nginx服务，以及PHP服务
- 等待所有服务停止后，再点击启动按钮，重新启动所有服务
验证Phalcon是否安装成功
可以通过两种方式验证Phalcon扩展是否成功加载：
方式一：查看phpinfo页面
在phpEnv面板中点击phpinfo按钮，打开php信息页面，在页面中搜索phalcon，如果能看到Phalcon相关的模块信息，说明扩展已经成功加载。
方式二：编写测试脚本验证
新建一个test.php文件，写入以下代码：
<?php
// 检查Phalcon扩展是否加载
if (extension_loaded('phalcon')) {
echo 'Phalcon扩展已成功安装，版本为：' . PhalconVersion::get();
} else {
echo 'Phalcon扩展未加载，请检查配置';
}
将test.php放到phpEnv的网站根目录，通过浏览器访问该文件，如果输出Phalcon版本信息，说明环境配置完成。
常见问题排查
- 如果扩展不生效，首先检查下载的Phalcon扩展版本是否和PHP版本、线程安全模式完全匹配
- 检查php.ini中extension配置的路径是否正确，如果扩展不在默认ext目录，需要写完整路径
- 重启服务后还是不生效，可以查看PHP错误日志，根据日志提示排查问题