Legacy系统迁移时必须降级Composer或锁定版本，因2.x不兼容fxp插件、HTTP私仓、^7.4平台配置及1.x生成的lock文件；老类需用classmap映射、全局函数用files加载；降级后Class not found主因是autoload引入位置错误、老autoload未卸载或OPcache未清理。
Legacy 系统迁移时，Composer 降级不是“选配”，而是加载链不崩的必要条件——Class not found 和 Cannot redeclare class 90% 都源于 autoload 加载时机错位或版本冲突，不是代码写错了，是 Composer 没被正确驯服。
为什么 legacy 项目必须用 Composer 1.x 或严格锁定包版本
Composer 2.x 默认启用 allow-plugins、强制 HTTPS 元数据拉取、解析 composer.lock 格式更严，而老系统常依赖：
• fxp/composer-asset-plugin 等已停更插件（仅兼容 1.x）
• 私有仓库使用 HTTP + 自签名证书（2.x 默认拒绝）
• config.platform.php 写成 "^7.4"（1.x 不识别，会跳过平台模拟）
• composer.lock 由 2.x 生成后，1.x 直接报 Invalid argument supplied for foreach()
composer self-update --version 在中文环境大概率失败的真正原因
不是命令写错了，是默认访问 https://getcomposer.org 在国内 DNS 和 TLS 层不稳定。PowerShell 下还额外踩坑：
• 错误写法：composer self-update --version 2.2.22 → PowerShell 把点号当属性访问，报 Cannot index into a null array
• 正确写法：composer self-update "2.2.22"（引号必须）
• 更稳路径：手动下载校验 SHA384 后替换 PHAR
• 替换前先确认路径：which composer，常见为 /usr/local/bin/composer
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
legacy 类和函数文件怎么让 Composer 正确加载（不改代码）
PSR-4 对无命名空间的老类（如 class User_model {}）完全无效，硬套只会扫不到。全局函数文件（如 helpers.php）也不能塞进 PSR-4。
• 老类用 classmap：
"autoload": {<br> "classmap": ["models/", "libraries/", "includes/"]<br>}路径相对于 composer.json，别加 ./• 全局函数/常量用
files："autoload": {<br> "files": ["helpers.php", "constants.php"]<br>}• 修改后必须执行：
composer dump-autoload -o（-o 生成优化映射表，否则每次扫描慢且易漏）• 迁移后删掉所有
require_once 'models/User_model.php'，否则运行时报 Cannot redeclare class
降级后 Class not found 依然存在？先查这三件事
不是 Composer 没装对，是加载链断在了看不见的地方：
• config.php 或 bootstrap.php 里提前 require vendor/autoload.php → 必须删掉，只保留在真实入口第一行（index.php、api.php）
• 老代码定义了 __autoload() 或 spl_autoload_register() → 执行前加 spl_autoload_unregister('__autoload'); 显式卸载
• OPcache 没清干净 → 重启 php-fpm 或执行 opcache_reset()，否则旧类名缓存残留
