phpEnv当前默认仅支持PHP 8.0及以下，无法直接运行Phalcon 5.0（需PHP 8.1+），务实方案是选用兼容PHP 8.0的Phalcon 4.1.4，需手动下载对应DLL、配置php.ini、启用Apache重写模块并正确设置DocumentRoot与.htaccess规则。
phpEnv 是 Windows 下轻量级 PHP 环境管理工具（类似 phpstudy，但更简洁），它不自带 Phalcon 扩展，必须手动集成。Phalcon 5.0 要求 PHP 8.1+，而目前 phpEnv 官方最新版（截至 2026 年 4 月）默认仅提供 PHP 8.0 及以下版本 —— 直接在 phpEnv 中启用 Phalcon 5.0 几乎不可行，除非你自行编译或降级使用 Phalcon 4.1.4（兼容 PHP 8.0）。
确认 phpEnv 当前 PHP 版本与扩展目录位置
打开 phpEnv 主界面 → 查看右上角显示的 PHP 版本（如 PHP 8.0.30）。若版本低于 8.1，Phalcon 5.0 将无法加载，强行复制 phalcon.so 或 php_phalcon.dll 会触发 PHP Warning: PHP Startup: Unable to load dynamic library 'phalcon'。
扩展目录路径通常为：phpEnv\php\{版本号}\ext\（例如 phpEnv\php\8.0.30\ext\）。务必用资源管理器确认该路径真实存在且可写。
- 用记事本打开对应
php.ini（路径一般为phpEnv\php\{版本号}\php.ini） - 检查
extension_dir是否指向上述ext目录，例如：extension_dir = "D:/phpEnv/php/8.0.30/ext" - 确保
enable_dl = On（虽然现代 PHP 默认禁用dl()，但扩展加载不依赖它；此项可忽略）
下载并放置 Phalcon 4.1.4（适配 PHP 8.0）
Phalcon 5.0 不支持 PHP 8.0，但 phpEnv 当前无官方 PHP 8.1+ 版本包。务实做法是选用 Phalcon 4.1.4（最后兼容 PHP 8.0 的稳定版）。
立即学习“PHP免费学习笔记（深入）”；
- 前往 GitHub v4.1.4 发布页 → 下载
php_phalcon-4.1.4-8.0-nts-vs16-x64.zip（根据你的 phpEnv 是 NTS 还是 TS、x64 还是 x86 选对） - 解压后取出
php_phalcon.dll，放入phpEnv\php\{版本号}\ext\ - 在
php.ini末尾添加：extension=php_phalcon.dll - 重启
phpEnv的 Apache/Nginx 服务（不是只重启 PHP，要重启整个 Web 服务）
验证方式：新建 info.php，内容为 <?php phpinfo(); ?>，浏览器访问，搜索 phalcon —— 应看到模块版本、编译时间等信息，而非空白或报错。
Apache 配置需开启 rewrite 和 AllowOverride
phpEnv 默认 Apache 配置未启用重写模块，而 Phalcon 必须靠 URL 重写把请求统一交给 public/index.php 处理。否则所有路由（如 /api/users）都会 404。
- 打开
phpEnv\apache\conf\httpd.conf - 取消注释这一行：
LoadModule rewrite_module modules/mod_rewrite.so - 找到
<directory></directory>块（或你实际的网站根目录），将其中的AllowOverride None改为AllowOverride All - 保存后重启 Apache
如果你用的是 public/ 作为 Web 根目录（推荐），还需在 httpd.conf 中修改 DocumentRoot 和 <directory></directory> 路径指向 D:/phpEnv/www/public，否则 .htaccess 不生效。
运行 Micro 应用时注意入口文件权限与 _url 参数
Phalcon Micro 的 index.php 依赖 $_SERVER['REQUEST_URI'] 或 $_GET['_url'] 解析路由。在 phpEnv + Apache 下，.htaccess 重写规则必须正确传递 _url，否则 $app->handle() 会收不到路径信息。
确保 public/.htaccess 内容为：
RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule ^(.*)$ index.php?_url=/$1 [QSA,L]- 不要漏掉
[QSA,L]——QSA（Query String Append）保证原始 GET 参数不丢失，L（Last）防止后续规则干扰 - 如果项目放在子目录（如
localhost/phalcon-api），需在RewriteRule前加RewriteBase /phalcon-api/ - Windows 下路径分隔符敏感，
index.php?_url=/$1中的/不能省略，否则$app->get('/')匹配失败
部署后访问首页仍 404？先检查 Apache 错误日志（phpEnv\apache\logs\error.log），常见报错如 Request exceeded the limit of 10 internal redirects，说明重写规则陷入死循环，大概率是 RewriteCond 判断失效或 DocumentRoot 配置错误。
