初始化 Composer 环境并生成 composer.json；2. 分析旧依赖并用 composer require 替换第三方库；3. 对无法通过 Composer 安装的代码配置 files 或 classmap 自动加载；4. 删除手动引入语句，改用 vendor/autoload.php 统一加载；5. 全面测试功能确保无类找不到或函数调用错误。迁移后依赖清晰，维护更便捷。
将一个非 Composer 管理的旧 PHP 项目迁移到使用 Composer，能显著提升依赖管理的清晰度和项目的可维护性。整个过程并不复杂，关键是逐步替换原有方式，避免引入不可控的错误。
1. 初始化 Composer 环境
在项目根目录下创建 composer.json 文件，这是 Composer 的核心配置文件。你可以手动创建，也可以运行：
composer init根据提示填写项目信息，如名称、描述、作者、最低稳定版本等。不需要一次性填完，后续可以修改。
初始化完成后，会生成一个基础的 composer.json，接下来就可以添加依赖了。
2. 分析并迁移现有依赖
检查项目中手动引入的第三方库（比如放在 vendor/ 或 libs/ 目录下的类库），逐一查找它们是否在 Packagist 上可用。
常见情况举例：
- 使用了 monolog/monolog 日志库？直接添加：composer require monolog/monolog
- 自己放了一个 smarty 模板引擎？改为：composer require smarty/smarty
- 用了 Guzzle 发 HTTP 请求？用：composer require guzzlehttp/guzzle
把所有能找到 Composer 包的第三方库都通过 composer require 安装，并删除本地对应的旧文件。
3. 处理无法通过 Composer 安装的代码
有些老项目包含自研公共库或已停止维护的组件，不在 Packagist 上。这时可以通过 files 或 classmap 自动加载机制整合进 Composer。
例如，项目中有个 lib/Utils.php，里面定义了一些函数：
{
"autoload": {
"files": ["lib/Utils.php"]
}
}
如果有多个类文件散落在 classes/ 目录：
{
"autoload": {
"classmap": ["classes/"]
}
}
配置完成后运行：
composer dump-autoload让自动加载生效。
4. 替换原有的 include/require 调用
删除所有手动包含第三方库的 require 'vendor/lib/some-lib.php'; 这类语句。
在入口文件（如 index.php、bootstrap.php）中加入：
require_once __DIR__ . '/vendor/autoload.php';之后所有 Composer 管理的类和自动加载的文件都可以直接使用，无需再手动引入。
对于仍保留的自定义类或函数，确保它们被正确包含在 autoload 配置中，并测试调用是否正常。
5. 验证与测试
迁移完成后，运行项目所有功能，重点检查：
- 是否有“Class not found”错误
- 日志、数据库、HTTP 请求等功能是否正常
- 自定义函数是否还能调用
如有问题，查看是否遗漏了 classmap 或 files 配置，或命名空间使用不正确。
基本上就这些。迁移后，项目结构更清晰，后续升级依赖也只需一行命令。不复杂但容易忽略细节，建议先在开发环境操作，确认无误后再同步到生产。
