Phalcon 5 起，PhalconLoader 已被移除并重构为 PhalconAutoloadLoader，这是框架重大命名空间调整的一部分；若沿用旧写法将触发类未找到错误，需同步更新 use 声明与实例化代码。
phalcon 5 起，`phalconloader` 已被移除并重构为 `phalconutoloadloader`，这是框架重大命名空间调整的一部分；若沿用旧写法将触发类未找到错误，需同步更新 `use` 声明与实例化代码。
在 Phalcon 5 及更高版本中，原有的 PhalconLoader 类已被彻底弃用，取而代之的是位于新命名空间下的 PhalconAutoloadLoader。这一变更属于 Phalcon 5 全面模块化与命名空间规范化的重要一环——所有与自动加载相关的组件均统一归入 PhalconAutoload 子命名空间。因此，即使 Phalcon 扩展已正确安装（phpinfo() 和 php -m 显示正常），且其他核心类（如 PhalconDiFactoryDefault、PhalconUrl）可正常加载，new Loader() 仍会抛出 Class 'Phalcon\Loader' not found 的致命错误。
✅ 正确的迁移方式如下：
-
更新
use声明：将use PhalconLoader;替换为：use PhalconAutoloadLoader;
-
保持实例化语法不变（构造函数与方法签名兼容）：
$loader = new Loader(); $loader->registerDirs([ APP_PATH . '/controllers/', APP_PATH . '/models/', ]); $loader->register();
⚠️ 注意事项：
- 不要尝试使用
PhalconAutoload（该类不存在）或PhalconLoaderLoader（错误路径）； - 若项目同时兼容 Phalcon 4 与 5，建议通过版本检测动态加载，但生产环境强烈推荐统一升级并适配 v5+ 规范；
-
PhalconAutoloadLoader支持全部原有功能（registerDirs、registerNamespaces、registerFiles等），API 层面完全向后兼容，仅命名空间变更。
? 补充说明：除 Loader 外，Phalcon 5 还调整了多个关键类的命名空间，例如：
-
PhalconMvcModel→ 保留（未变） -
PhalconHttpResponse→ 保留 -
PhalconLoggerAdapterStream→ 移至PhalconLoggerAdapterStreamAdapter
完整变更列表请参考官方升级指南：Phalcon 5 Upgrade Guide。
完成上述修改后，自动加载逻辑即可恢复正常，应用可顺利启动并加载控制器与模型。
