Phalcon 5.0 RC4 起，原 Phalcon\Loader\Loader 已被移除，统一重构为 Phalcon\Autoload\Loader，需同步更新命名空间引用与实例化方式，否则将触发“Class not found”致命错误。
phalcon 5.0 rc4 起，原 `phalcon\loader\loader` 已被移除，统一重构为 `phalcon\autoload\loader`，需同步更新命名空间引用与实例化方式，否则将触发“class not found”致命错误。
在 Phalcon 5.0（包括 RC4 版本）中，框架对自动加载器模块进行了重大重构：原有的 Phalcon\Loader\Loader 类已被彻底弃用，取而代之的是位于新命名空间下的 Phalcon\Autoload\Loader。这一变更属于 Phalcon 5 架构现代化的一部分，旨在统一自动加载逻辑、提升性能并简化扩展机制。
因此，若你正在基于 Phalcon 5.0 基础教程 搭建应用，但使用的是最新 RC 版本，需主动适配以下关键改动：
✅ 正确引入与实例化方式：
<?php
use Phalcon\Autoload\Loader;
// 实例化新 Loader
$loader = new Loader();
// 注册命名空间或目录（示例）
$loader->addNamespace('App', __DIR__ . '/../app/');
$loader->register();⚠️ 常见错误写法（将导致 Fatal Error）：
// ❌ 错误：旧版命名空间（Phalcon 3/4 兼容写法，Phalcon 5 不再存在） use Phalcon\Loader\Loader; $loader = new Loader(); // → Class "Phalcon\Loader\Loader" not found // ❌ 错误：仅 use Phalcon\Loader（该类已不存在） use Phalcon\Loader; // → Class "Phalcon\Loader" not found
? 验证是否生效：
确保 PHP 扩展已正确加载（可通过 php -m | grep phalcon 或 phpinfo() 确认），且项目未缓存旧版 autoloader（如 Composer 的 vendor/autoload.php 未意外覆盖 Phalcon 内置加载器）。Phalcon 5 的 Autoload\Loader 是轻量级、零依赖的内置加载器，无需 Composer 协助即可工作——但前提是代码中调用路径完全匹配。
? 额外提示：
- Phalcon 5.0 文档尚处于持续更新中，当前 RC 阶段建议以 官方 CHANGELOG-5.0.md 为权威参考；
- 从 Phalcon 4 迁移时，除
Loader外，还需关注Phalcon\Mvc\Application初始化、事件管理器（EventManager）、以及 DI 容器注册方式的变化； - 若使用 Zephir 编译自定义扩展，请确认编译目标为
phalcon.so（PHP 8.1 兼容版本），并检查extension=phalcon.so已启用于php.ini。
完成上述调整后，重启 PHP 内置服务器（如 php -S localhost:8000 -t public .htrouter.php），即可正常加载应用——不再出现 Class not found 错误。
