先初始化Composer并生成autoload，再逐步替换旧依赖。1. 创建composer.json并运行install生成vendor目录；2. 配置classmap自动加载旧类，引入autoload.php并移除手动引用；3. 将第三方库替换为Composer包并调整调用方式；4. 推荐将代码重构为PSR-4结构并配置命名空间；5. 通过files自动加载全局函数文件，保留必要配置引入。分步实施可确保平稳过渡。
为一个未使用 Composer 的旧 PHP 项目引入 Composer，关键在于逐步集成，避免破坏现有结构。核心思路是：先让 Composer 正常工作，再逐步迁移依赖和代码加载方式。
1. 初始化 Composer 环境
在项目根目录创建 composer.json 文件，定义基本配置和将来要管理的依赖：
{ "require": {}, "autoload": { "classmap": ["."] } }运行 composer install，会生成 vendor 目录和 composer.lock。这一步不会改动现有代码，只是建立基础。
2. 使用 classmap 自动加载旧代码
旧项目通常用 include/require 或自定义 autoloader。可先让 Composer 扫描整个项目目录自动识别类：
立即学习“PHP免费学习笔记（深入）”；
- 修改 composer.json 中的 autoload.classmap 指向包含旧类文件的目录（如 "lib/", "classes/"）
- 执行 composer dump-autoload 生成映射表
- 在入口文件（如 index.php）顶部引入 autoload：
require_once 'vendor/autoload.php'; - 逐步移除手动 include/require 语句
3. 替换第三方库为 Composer 包
检查项目中使用的第三方库（如 PHPMailer、PHPExcel、Guzzle 等）：
- 确认这些库是否在 Packagist 上有官方或社区维护的包
- 在 composer.json 的 require 中添加对应条目，例如：
"guzzlehttp/guzzle": "^7.0" - 删除旧的第三方库文件夹
- 调整代码使用 Composer 提供的命名空间和自动加载
4. 规范项目自身代码结构（可选但推荐）
长期来看，建议将项目代码组织成 PSR-4 结构：
- 创建 src/ 目录存放应用类
- 在 composer.json 中设置：
"autoload": { "psr-4": { "App\\": "src/" } } - 给类加上命名空间，如 namespace App;
- 再次运行 composer dump-autoload
5. 处理全局变量和函数
旧项目可能依赖全局函数或配置文件：
- 可将工具函数写入独立文件，并通过 files 类型自动加载：
"autoload": { "files": ["helpers.php"] } - 配置文件仍可用 require 引入，不必强行改为服务容器
基本上就这些。关键是分步走，每改一点测试一次，确保功能正常。Composer 不需要一次性接管所有代码，它可以从边缘开始逐步深入。只要入口文件加载了 vendor/autoload.php，你就可以灵活混合新旧加载方式，平稳过渡。
