直接在旧项目根目录运行 composer init 生成空 composer.json，用 classmap 加载现有类，部署时用 composer install --no-dev --optimize-autoloader，入口文件开头引入 vendor/autoload.php。
直接在旧项目根目录运行 composer init
不需要重写任何代码，也不用提前整理目录结构。进入项目根目录后执行该命令，按提示填入项目名、描述、作者等基本信息即可生成初始 composer.json。它默认不添加任何依赖，只生成一个合法的空配置文件——这意味着你随时可以开始加包，但不必立刻改代码。
常见错误是误以为必须一次性定义所有依赖或 autoload 规则。其实 composer.json 是渐进式配置文件，初期只写 "require": {} 和基础元数据就足够了。后续每加一个包、每配一条自动加载路径，都是独立生效的操作。
用 classmap 加载现有类，而不是强行改命名空间
老项目通常没有 PSR-4 命名规范，手动改类名和文件路径成本高、风险大。这时别硬推 psr-4，直接在 autoload 里用 classmap 指向原有目录：
"autoload": {
"classmap": ["./lib", "./models", "./includes"]
}
然后运行 composer dump-autoload。Composer 会扫描这些目录下所有 PHP 文件，生成类名到文件路径的映射表。之后你在新写的代码里 new SomeOldClass() 就能直接工作，无需 include 或 require。
- 注意：路径必须是相对项目根目录的，且不能带尾部斜杠
- 如果某些类文件含语法错误，
dump-autoload会静默跳过，不会报错——建议先用php -l批量检查 -
classmap是一次性扫描，新增类后需重新运行该命令
部署时坚持用 composer install --no-dev --optimize-autoloader
旧项目上线环境往往资源有限，而默认的 composer install 会装 require-dev 包、启用调试级自动加载，既慢又占内存。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
生产部署必须加这两个参数：
-
--no-dev：跳过开发依赖（如 PHPUnit、PHPStan），减小vendor/体积 -
--optimize-autoloader：生成扁平化映射，避免运行时动态解析命名空间——这对没有 PSR-4 的老项目尤其关键，能显著降低 autoloader 的文件系统开销
同时确保 composer.lock 已提交到 Git。它锁定的是实际安装的版本，不是 composer.json 里的模糊约束。没它，不同机器上 install 出来的依赖可能不一致。
vendor/autoload.php 怎么接入旧入口文件
不要动原有 index.php 或 bootstrap.php 的逻辑顺序。只需在最开头加一行：
require __DIR__ . '/vendor/autoload.php';
这行代码必须放在所有 include/require 之前，否则旧类已被加载，Composer 的 autoloader 就失效了。如果项目有多个入口（比如 CLI 脚本、后台定时任务），每个都要单独加上。
容易被忽略的是：有些旧项目会用 set_include_path() 或自定义 spl_autoload_register()，它们可能和 Composer 的加载器冲突。遇到类找不到，先检查是否已有其他 autoloader 提前触发并终止了加载链。
