Phalcon 项目需通过 Composer 管理依赖与自动加载：声明 ext-phalcon 平台依赖，引入 phalcon/php 接口包，配置 PSR-4 映射命名空间，集成 Monolog、Phinx 等通用组件，并避免使用已废弃的 phalcon/phalcon 包。
Phalcon 本身是 C 扩展，不依赖 Composer 运行，但现代 Phalcon 项目（尤其是 4.x/5.x）已全面拥抱 Composer —— 它负责自动加载、依赖管理、扩展包集成和开发工具链统一。关键在于正确配置 composer.json、启用 PSR-4 自动加载，并让 Phalcon 的核心类与第三方包共存无冲突。
安装 Phalcon 扩展并声明 Composer 依赖
Phalcon 不通过 Composer 下载源码（它是编译型扩展），但必须在 composer.json 中声明 ext-phalcon 作为平台扩展依赖，确保环境检查和部署一致性：
- 运行
composer require phalcon/php:~5.0（官方推荐的轻量 PHP 包，仅含接口定义和辅助类，不包含扩展本身） - 在
composer.json的"require"下添加："ext-phalcon": "*"—— 这样composer install会校验 Phalcon 扩展是否已启用 - 若使用 Phalcon 4.x，对应用
phalcon/php:~4.1，并确认 PHP 版本匹配（如 4.1 要求 PHP 7.4+）
配置 PSR-4 自动加载以支持模块化结构
Phalcon 项目不再靠手工 require，而是靠 Composer 自动加载应用代码。在 composer.json 中定义命名空间映射：
- 例如项目根目录为
app/，控制器放在app/Controllers/，对应命名空间AppControllers，则添加："autoload": { "psr-4": { "App\": "app/" } } - 执行
composer dump-autoload生效；之后new AppControllersIndexController()可直接实例化 - 若沿用 Phalcon 3.x 的
app/controllers目录风格，可配合 classmap："autoload": { "classmap": ["app/controllers/", "app/models/"] }
集成常用组件与开发工具
Composer 让 Phalcon 项目能无缝使用 Laravel/Symfony 生态中的通用包（如日志、缓存、HTTP 客户端），无需重造轮子：
- 日志：运行
composer require monolog/monolog，在 DI 容器中注册：$di->set('logger', fn() => new Logger('app')); - 数据库迁移：用
robmorgan/phinx管理 SQL 迁移，与 Phalcon 的PhalconDb兼容 - 开发辅助：添加
phpunit/phpunit和friendsofphp/php-cs-fixer，并通过composer.json的"scripts"定义快捷命令，如："test": "phpunit", "cs-fix": "php-cs-fixer fix"
避免常见陷阱
Composer 与 Phalcon 协同时易出问题的几个点：
-
不要用
composer require phalcon/phalcon—— 这是旧版（3.x）的错误包，已废弃且不兼容 4+/5+ - Phalcon 5.x 默认关闭
PhalconDiFactoryDefault的自动服务注册，需手动注册db、modelsManager等服务，否则 Composer 加载的类无法访问这些依赖 - 若使用 OpCache，更新
composer.json后记得清空 OPcache（opcache_reset()或重启 Web 服务），否则自动加载可能失效
