Phalcon 无法通过 XAMPP 自带扩展管理器安装，须手动下载与 PHP 版本、线程安全（TS/NTS）、架构（x86/x64）完全匹配的预编译 DLL 文件，放入 ext 目录并配置 php.ini，重启 Apache 后用 class_exists 验证是否真正加载成功。
Phalcon 不能直接通过 XAMPP 自带的 PHP 扩展管理器安装，必须手动编译或下载预编译的 .dll（Windows）或 .so（Linux/macOS），且版本必须与 XAMPP 内嵌的 PHP 版本、线程安全（TS/NTS）、架构（x86/x64）完全匹配——不匹配会导致 Apache 启动失败或 Class 'Phalcon' not found。
确认 XAMPP 中 PHP 的准确版本和构建类型
Phalcon 是 C 扩展，对 PHP 运行时环境极其敏感。不能只看 php -v 输出的主版本号。
- 在 XAMPP 控制面板点击 Shell，执行：
php -i | findstr "PHP Version Thread Safety Architecture"
（Windows）或php -i | grep -E "(PHP Version|Thread Safety|Architecture)"
（Linux/macOS） - 关键字段必须全部匹配：
PHP Version（如 8.2.12）、Thread Safety（enabled= TS，disabled= NTS）、Architecture（x86或x64） - XAMPP for Windows 默认使用 TS + x64；但旧版（如 XAMPP 7.4）可能为 TS + x86 —— 下载错一个维度，
extension=phalcon就会静默失效
下载并安装匹配的 Phalcon DLL 文件（Windows）
官方不再提供全版本预编译包，需从第三方可信源获取，或自行编译（不推荐新手）。
XAMPP 8.0.30
下载
XAMPP 8.0.30 是一款免费、开源的跨平台 Web 服务器集成包，专为快速搭建本地 PHP 开发环境而设计。该版本核心组件包括：Apache 2.4.56、MySQL 8.0.33、PHP 8.0.30、phpMyAdmin 5.2.1 等。它支持 Windows、Linux 和 macOS 系统，可让开发者在个人电脑上轻松模拟服务器环境，无需复杂配置即可运行 WordPress、Thin
- 访问 Phalcon GitHub Releases，找对应标签（如
v5.9.0），进入Assets区域 - 下载形如
phalcon_php82_ts_x64.dll的文件（命名规则：phalcon_php{主次版本}_ts|nts_{架构}.dll） - 将该 DLL 复制到 XAMPP 的 PHP 扩展目录：
C: mppphpext - 编辑
C: mppphpphp.ini，在;extension=区块末尾添加：extension=phalcon
（注意：不要写.dll后缀） - 重启 Apache —— 若失败，检查 Windows 事件查看器中
Application日志，常见错误是The specified module could not be found，说明 DLL 依赖缺失（如 VC++ 运行库）或架构不匹配
验证 Phalcon 是否加载成功
仅靠 php -m | findstr phalcon 不可靠，因模块可能加载但类未注册。
- 新建
C: mpphtdocsphalcon-test.php，内容为：<?php var_dump(class_exists('Phalcon\Mvc\Application')); - 浏览器访问
http://localhost/phalcon-test.php，输出bool(true)才算真正就绪 - 若报
Class 'PhalconMvcApplication' not found，优先检查：php.ini是否改了正确文件（XAMPP 可能有多个php.ini，Apache 使用的是C: mpppacheinphp.ini？不，它读的是C: mppphpphp.ini，但需确认Loaded Configuration File路径） - 用
php --ini和phpinfo()双重确认实际生效的配置路径
最常被跳过的一步：XAMPP 的 Apache 和 CLI PHP 可能使用不同 php.ini，而 Phalcon 扩展只对其中一个生效。部署前务必用 phpinfo() 页面确认 extension_dir 和 Loaded Configuration File，再核对 Phalcon 是否出现在 Registered PHP Streams 或扩展列表里——漏掉这个，后面所有框架初始化都会卡在类找不到。
