如何将一个未使用Composer的旧PHP项目迁移到Composer管理？（重构步骤）

迁移旧PHP项目到Composer需分四步：先初始化并梳理依赖，再配置PSR-4自动加载并迁移类，接着替换硬编码引入统一走Autoload，最后拆分环境配置并规范部署流程，确保每步可测试、可回滚。

将未使用Composer的旧PHP项目迁移到Composer管理，核心是逐步引入依赖管理、规范自动加载、清理手动require逻辑。不是一次性重写，而是分阶段替换，确保每次改动可测试、可回滚。

第一步：初始化Composer并梳理现有依赖

在项目根目录运行 composer init，按提示填写包名、描述、作者等基本信息（可暂用占位值）。关键动作是识别当前项目实际使用的第三方库（如PHPExcel、Smarty、自定义工具类等），对照Packagist搜索对应稳定版的Composer包名（例如 phpoffice/phpexcel 已废弃，应改用 phpoffice/phpspreadsheet）。对找不到对应包的私有类或老旧库，先打包为本地路径仓库或临时用 repositories 配置指向本地目录。

• 检查 include/、lib/、classes/ 等目录，列出所有外部引入文件
• 搜索代码中类似 require 'lib/SomeClass.php' 或 include_once 'vendor/autoload.php'（若已有残留）的语句，记下路径和用途
• 运行 composer require --dev phpunit/phpunit ^9 等常用开发依赖，为后续测试铺路

第二步：建立PSR-4自动加载并迁移核心类

修改 composer.json 的 autoload 段，映射项目命名空间到源码目录。例如旧项目所有类都在 includes/ 下且无命名空间，可先统一加一个根命名空间（如 App\），再把文件移入 src/ 并调整目录结构：

• 创建 src/ 目录，将原 includes/Database.php 移为 src/Database.php，顶部加上 namespace App;
• 在 composer.json 中添加：

  "autoload": { "psr-4": { "App\\": "src/" } }

• 执行 composer dump-autoload，验证 new App\Database() 能正常实例化
• 对尚不能加命名空间的老旧文件（如全局函数文件），用 files 加载方式：

  "autoload": { "files": ["includes/functions.php"] }

第三步：替换硬编码引入，统一走Autoload

逐个扫描 .php 文件，将 require、include、require_once 等语句删除或重构。原则是：类实例化改用 new Namespace\Class()；函数调用确保已在 autoload.files 中声明；配置文件、模板等非PHP资源保留原引入方式（Composer不负责加载它们）。

• 用IDE全局搜索 require.*[\'\"]lib/、include_once.*[\'\"]classes/ 等模式，批量处理
• 遇到循环依赖或条件引入（如 if ($mode === 'dev') require 'debug.php'），先提取为独立服务类，再通过容器或工厂注入
• 删除所有 vendor/autoload.php 的手动引入——Composer会自动处理

第四步：拆分环境配置与构建部署流程

旧项目常把数据库配置、API密钥直接写在PHP文件里。迁移后应改用环境变量 + .env 文件，并借助 vonage/nexmo-php 或 vlucas/phpdotenv 加载（后者需 composer require vlucas/phpdotenv）。同时编写最小化启动脚本（如 public/index.php）只做两件事：加载 vendor/autoload.php 和启动主应用逻辑。

• 创建 .env 存放敏感配置，.env.example 提供模板
• public/index.php 开头仅保留：

  require __DIR__.'/../vendor/autoload.php'; (new App\App())->run();

• 删除所有 config/ 下的 database.php 类文件，改为运行时读取 $_ENV['DB_HOST']
• 提交 composer.lock 和 vendor/ 到 .gitignore，确保部署时运行 composer install --no-dev

基本上就这些。重点不在一步到位，而在每次提交都保持功能完整。迁移完成后，你会获得可复现的依赖、清晰的类加载路径、以及未来升级扩展的基础能力。