phalcon框架不能通过composer安装，因其是c扩展而非php库；唯一有效配置是composer.json中声明"ext-phalcon": "*"用于环境校验，而phalcon/devtools、ide-stubs等辅助包才可正常通过composer安装。
Phalcon 框架本身没有 Composer 扩展镜像源——它压根不走 Packagist 发布流程，所有试图“换源加速安装 Phalcon”的操作都是无效的。你真正需要的不是镜像源，而是明确三件事：谁负责装扩展、谁负责校验环境、谁负责提供开发辅助代码。
composer require phalcon/phalcon 为什么必失败
这个命令在任何 Composer 版本下都会失败或引入废弃包，因为：
-
phalcon/phalcon从未在 Packagist 上发布过正式稳定版；v3.x 以前的非官方空包早已下线 - Phalcon 是 Zend 扩展（
phalcon.so或php_phalcon.dll），不是 PHP 类库，Composer 根本无法编译或加载它 - 即使强行
composer require phalcon/phalcon成功，项目运行时仍会报Class 'Phalcon\Di\FactoryDefault' not found——因为 PHP 进程根本没加载扩展
必须写进 composer.json 的唯一有效声明
只有一条配置能起实际作用：让 Composer 在 install 或 update 时检查扩展是否已启用。它不下载任何代码，但能防止部署到缺失扩展的服务器上静默崩溃。
- 必须写在
"require"（不是require-dev）里："ext-phalcon": "*" - CI/CD 流程中执行
composer install --no-dev时，这条声明会触发验证；若extension_loaded('phalcon')返回 false，直接报错退出 - 如果还依赖
pdo_mysql、openssl等扩展，也应一并列在这里，保持环境约束完整
哪些 Phalcon 相关包真能用 Composer 装
只有三类东西支持 Composer 安装，且全部是纯 PHP 代码，与扩展本身无关：
-
phalcon/devtools：仅命令行工具，需加--dev，运行phalcon create-project前必须确保phalcon.so已加载且proc_open开启 -
phalcon/ide-stubs：生成 PHP stub 文件，供 IDE 补全Phalcon\*类名，仅开发阶段需要 -
phalcon/common：Phalcon 4/5 官方推荐的辅助库（替代已停更的phalcon/incubator），含常用工具类，可放require
换国内镜像源对 Phalcon 项目有用吗
有用，但仅限于加速下载 phalcon/devtools、phalcon/ide-stubs 这类真实存在的 Packagist 包，以及你项目里其他 PHP 依赖（如 monolog/monolog）。它对 Phalcon 扩展安装零影响。
- 全局生效命令（注意三要素不缺）：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 项目级更可靠（自动写入
composer.json）：composer config repo.packagist composer https://mirrors.aliyun.com/composer/ - 验证是否生效：
composer config -g repo.packagist应输出带 URL 的 JSON 对象；若为空，说明命令写错了
最常被跳过的动作是：在运行任何 composer require 前，先执行 php -m | grep phalcon。没这行输出，后面所有操作都只是在堆错误日志。
