phpEnv是一款操作简便的PHP集成开发环境，能够帮助开发者快速搭建本地PHP运行环境，而Yaf是PHP官方推出的用C语言编写的轻量级框架，运行效率远高于普通PHP框架。在phpEnv中安装Yaf框架可以充分发挥两者的优势，提升开发效率。
安装前准备
在开始安装之前，需要确认已经完成了以下准备工作：
- 已经在本地电脑成功安装phpEnv集成环境，并且能够正常启动Apache或Nginx服务
- 明确当前phpEnv使用的PHP版本，比如PHP7.4、PHP8.0等，后续下载Yaf扩展需要匹配对应版本
- 确认PHP是线程安全版本还是非线程安全版本，可以通过phpEnv的PHP信息页面查看
下载对应版本的Yaf扩展
Yaf扩展需要根据PHP版本和系统架构选择对应的文件，具体操作步骤如下：
- 打开浏览器访问PECL官方扩展库，找到Yaf扩展的下载页面
- 选择与当前phpEnv中PHP版本完全匹配的Yaf扩展版本，比如PHP7.4就选择支持7.4的Yaf版本
- 根据系统类型选择Windows版本的DLL文件，同时匹配线程安全（TS）或非线程安全（NTS）版本，以及x64或x86架构
- 下载完成后解压压缩包，找到其中的php_yaf.dll文件
将Yaf扩展放入phpEnv扩展目录
接下来需要将下载好的扩展文件放到phpEnv对应的扩展目录中：
- 打开phpEnv的安装目录，找到对应PHP版本的ext文件夹，比如phpEnv安装目录下的php/php7.4/ext
- 将之前解压得到的php_yaf.dll文件复制到这个ext目录中
修改php.ini配置文件
需要修改PHP的配置文件来启用Yaf扩展：
- 在phpEnv的管理面板中找到对应PHP版本的php.ini配置文件，点击打开编辑
- 在配置文件的末尾添加以下配置内容：
; 启用Yaf扩展 extension=php_yaf.dll ; Yaf框架基础配置 yaf.use_namespace=1 yaf.use_spl_autoload=1
添加完成后保存php.ini文件，然后重启phpEnv中的Web服务和PHP服务。
验证Yaf框架是否安装成功
可以通过以下两种方式验证Yaf是否安装成功：
方式一：查看PHP信息
在phpEnv管理面板中打开PHP信息页面，搜索yaf关键词，如果能看到Yaf相关的配置信息，说明扩展已经成功加载。
方式二：编写测试代码
创建一个test.php文件，写入以下代码：
<?php
// 查看Yaf扩展是否加载
if (extension_loaded('yaf')) {
echo 'Yaf框架扩展已经成功安装';
} else {
echo 'Yaf框架扩展安装失败';
}
// 查看Yaf版本
echo '<br/>Yaf版本：' . YafVERSION;
将test.php放到phpEnv的网站根目录，通过浏览器访问该文件，如果输出Yaf安装成功的信息和版本号，说明Yaf框架已经可以在phpEnv环境中正常使用。
常见问题排查
- 如果重启服务后没有加载Yaf扩展，检查php_yaf.dll的版本是否和PHP版本、线程安全类型完全匹配
- 如果提示找不到扩展文件，检查php.ini中extension_dir配置是否指向了正确的ext目录
- 如果运行Yaf项目时报类找不到的错误，检查yaf.use_namespace配置是否为1，根据项目需求调整配置