Composer不能安装Phalcon框架本身，它只校验ext-phalcon是否启用，必须在require中声明"ext-phalcon": "*"，否则部署时可能静默失败；devtools和ide-stubs需用--dev安装；autoload路径须与实际目录一致；扩展须手动安装并用php -m | grep phalcon验证。
Composer 不能安装 Phalcon 框架本身，它只负责检查扩展是否已加载、管理开发工具和 IDE 补全，这点必须先明确。强行 composer require phalcon/phalcon 会失败或引入废弃包。
composer.json 中必须写 "ext-phalcon": "*"
这是最常被忽略的一步。Phalcon 是 C 扩展，不是 PHP 包，Composer 唯一能做的“依赖校验”就是靠这个声明。不加它，composer install 不报错，但部署到新环境时可能静默失败——因为没人检查 phalcon.so 是否真在 php.ini 里启用。
-
"require": { "ext-phalcon": "*" }放在生产依赖里，CI/CD 流程中会自动验证 PHP 环境是否就绪 - 不要写成
"require-dev"，否则线上部署时不会触发检查 - 如果项目还依赖其他扩展（如
ext-pdo_mysql），也应一并列在这里，保持环境约束完整
devtools 和 ide-stubs 要用 --dev 安装
phalcon/devtools 是命令行脚手架，phalcon/ide-stubs 是给编辑器生成类定义的 stub 文件，二者都不参与运行时，必须限定在开发阶段。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 执行
composer require phalcon/devtools --dev，之后就能用phalcon命令创建项目 - 执行
composer require phalcon/ide-stubs --dev，VSCode 或 PhpStorm 就能识别PhalconMvcController这类类名和方法签名 - 注意：这两个包都发布在 Packagist，但它们和框架运行时完全解耦；删掉它们，Phalcon 应用照样跑
autoload 配置要匹配实际目录结构
Phalcon 项目没有强制目录规范，但 composer.json 里的 autoload 必须和你代码物理路径一致，否则 vendor/autoload.php 加载不到控制器、模型等类。
- 典型配置是
"psr-4": { "App\": "app/" }，意味着所有App命名空间的类都在app/目录下 - 如果你用的是
src/目录，就得改成"App\": "src/"，否则new AppControllersIndexController()会报 class not found - 别漏掉
classmap或files类型的 autoload（比如全局函数文件），Phalcon 的Loader类有时会和 Composer 自动加载共存，冲突时优先看composer dump-autoload -o是否生效
手动安装扩展后，php -m | grep phalcon 必须有输出
这是整个流程的起点，也是绝大多数问题的根源。Composer 做不了这件事，你必须亲手完成：
- Linux/macOS：编译
cphalcon/build/php8/64bits/下对应 PHP 版本的.so，写入php.ini并确认extension_dir路径正确 - Windows：下载匹配 PHP TS/NTS 和版本的
php_phalcon.dll，放进ext/目录，再改php.ini - 验证命令必须是
php --ri phalcon或php -m | grep phalcon，不能只靠浏览器访问phpinfo()—— CLI 和 FPM 的php.ini可能不同
真正容易卡住的地方，从来不是 composer install 报错，而是扩展没装对、CLI 和 Web SAPI 加载了不同的 php.ini、或者 autoload 路径和实际文件位置对不上。每一步都得用命令行直接验证，别跳过。
