初始化Composer并创建composer.json；2. 整理代码至标准目录结构；3. 用Composer安装依赖替换手动引入的库；4. 配置自动加载现有类和函数文件；5. 在入口文件引入vendor/autoload.php；6. 逐步迁移验证，实现平滑升级。
很多老的PHP项目一开始没有使用Composer，所有类库和依赖都是手动引入或散落在项目中。随着项目变大，维护越来越困难。引入Composer是迈向现代化PHP开发的第一步。这个过程不需要一次性重写整个项目，可以逐步改造。
1. 初始化Composer环境
在项目根目录下打开终端，运行以下命令来创建composer.json文件：
- composer init：根据提示填写项目信息，比如名称、描述、作者等。
- 选择是否需要自动加载（必须选是）。
- 完成后会生成一个基础的composer.json文件。
也可以手动创建composer.json，内容如下：
{
"name": "your/project",
"description": "Legacy project with Composer",
"type": "project",
"autoload": {
"psr-4": {
"App\\": "src/"
},
"files": []
},
"require": {}
}
2. 规范项目目录结构
为了更好地使用Composer自动加载，建议将原有代码逐步整理到标准目录中。例如：
立即学习“PHP免费学习笔记（深入）”；
- 把自定义类移到src/目录，并按命名空间组织。
- 第三方库或函数文件可暂时保留在原位置，后续用
files方式加载。
如果暂时无法移动文件，可以通过调整autoload配置适配现有结构。
3. 引入常用依赖并替换旧代码
开始用Composer安装实际需要的组件，逐步替代手工维护的代码。例如：
- composer require monolog/monolog：添加日志功能。
- composer require guzzlehttp/guzzle：替换手写的HTTP请求。
- composer require symfony/var-dumper：增强调试输出。
安装后，只需要包含vendor/autoload.php一次，就能使用所有这些库。
4. 集成自动加载现有代码
老项目中的全局函数或工具类可以通过files方式加载：
"autoload": {
"files": [
"helpers.php",
"config/constants.php"
]
}
运行composer dump-autoload更新自动加载映射。
对于已有类但无命名空间的情况，可先用classmap：
"autoload": {
"classmap": [
"legacy_classes/",
"models/"
]
}
5. 修改入口文件引入Autoload
在项目的主入口文件（如index.php或bootstrap.php）顶部加入：
require_once __DIR__ . '/vendor/autoload.php';
这一步是关键，之后就可以直接使用Composer管理的类和自动加载的本地类。
6. 逐步重构与验证
不要试图一次性完成所有改造。建议：
- 每次只迁移一部分功能，比如先把数据库操作类移到src/并加命名空间。
- 测试功能是否正常，确保自动加载生效。
- 逐步删除手工
include或require语句。
基本上就这些。Composer的引入不复杂，但对老项目意义重大。它让依赖清晰、加载统一、扩展更容易。只要一步步来，即使最老的项目也能焕然一新。
