Phalcon 5 起，Phalcon\Loader 已被移除，取而代之的是新命名空间 Phalcon\Autoload\Loader；若沿用旧写法将触发类未找到错误，需同步更新 use 声明与实例化方式。
phalcon 5 起，`phalcon\loader` 已被移除，取而代之的是新命名空间 `phalcon\autoload\loader`；若沿用旧写法将触发类未找到错误，需同步更新 `use` 声明与实例化方式。
在 Phalcon 5 及更高版本中，框架对命名空间进行了系统性重构，其中最常被忽略的变更之一就是自动加载器类的迁移：原 Phalcon\Loader 已完全废弃，其功能由全新设计的 Phalcon\Autoload\Loader 承接。这意味着即使 Phalcon 扩展已正确安装（phpinfo() 和 php -m 均可见），只要代码中仍使用 use Phalcon\Loader 或 new Phalcon\Loader()，PHP 就会抛出 Class 'Phalcon\Loader' not found 的致命错误——因为该类在 Phalcon 5 的源码中已不存在。
✅ 正确写法如下（适配 Phalcon 5+）：
<?php use Phalcon\Di\FactoryDefault;
use Phalcon\Autoload\Loader; // ✅ 注意命名空间变更
use Phalcon\Mvc\View;
use Phalcon\Mvc\Application;
use Phalcon\Url;
define('BASE_PATH', dirname(__DIR__));
define('APP_PATH', BASE_PATH . '/app');
// 实例化新版 Autoload\Loader
$loader = new Loader();
$loader->addDirectories([
APP_PATH . '/controllers/',
APP_PATH . '/models/',
]);
$loader->register(); // 自动注册到 SPL autoload stack
$container = new FactoryDefault();
$container->set('view', function () use (APP_PATH) {
$view = new View();
$view->setViewsDir(APP_PATH . '/views/');
return $view;
});
$container->set('url', function () {
$url = new Url();
$url->setBaseUri('/');
return $url;
});
$application = new Application($container);
try {
$response = $application->handle($_SERVER['REQUEST_URI']);
$response->send();
} catch (\Exception $e) {
echo 'Exception: ', $e->getMessage();
}
⚠️ 注意事项：
-
Phalcon\Autoload\Loader不再提供registerDirs()方法（已废弃），应改用addDirectories()（支持链式调用）或addDirectory()； - 若需更精细控制（如命名空间映射），可结合
addNamespaces()或addFiles()使用； - 确保项目使用的 Phalcon 版本与文档严格匹配：可通过
Phalcon\Version::get()验证，或运行php --ri phalcon查看详细版本信息； - 迁移时建议同步查阅 Phalcon 5 升级指南 获取完整 BC Break 列表。
简言之：不是安装问题，而是 API 演进所致。只需修正命名空间与方法名，即可无缝启用 Phalcon 5 的现代化自动加载机制。
