如何将一个未使用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 AppDatabase() 能正常实例化
• 对尚不能加命名空间的老旧文件（如全局函数文件），用 files 加载方式：

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

  登录后复制

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

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

标签： php excel js git json composer 编码 app 工具 office 环境变量 配置文件 一加