如何将一个非Composer管理的旧项目平滑迁移到Composer？

迁移旧项目到Composer需分四步：先初始化composer.json并手动引入现有依赖；再通过require vendor/autoload.php切换自动加载，配置PSR-4；接着替换硬编码路径为命名空间调用或服务封装；最后清理旧目录和加载语句，规范composer.json与.gitignore。

将非Composer管理的旧项目迁移到Composer，核心是分阶段替换依赖管理方式，避免一次性大改导致项目崩溃。重点在于先让Composer共存，再逐步接管，最后清理旧逻辑。

第一步：初始化Composer并引入现有依赖

在项目根目录运行 composer init，按提示填写包名、描述等基础信息（可暂用占位值）。关键不是填得完美，而是生成 composer.json 文件。接着，手动将当前项目实际使用的第三方库（如 PHPMailer、Monolog、Smarty 等）以对应版本号写入 require 字段。不确定版本？查 vendor/ 或 lib/ 目录下的文件注释、README 或 Git 提交记录。示例：

• "phpmailer/phpmailer": "^6.8"
• "monolog/monolog": "2.9.*"
• "smarty/smarty": "~4.3.0"

运行 composer install，确认依赖被正确下载到 vendor/。此时不急着删旧文件，只验证新路径能加载。

第二步：统一自动加载机制

旧项目通常靠一堆 require_once 或自定义 __autoload 加载类。迁移关键一步是切换到 Composer 的自动加载。在入口文件（如 index.php 或 bootstrap.php）顶部添加：

然后逐个检查旧的 require/require_once 语句：如果加载的是 Composer 已管理的包，直接删除；如果是项目自己的类，把它们归入 PSR-4 命名空间，并在 composer.json 中配置 autoload：

• "autoload": { "psr-4": { "App\": "src/" } }
• 执行 composer dump-autoload 生效

确保所有类可通过命名空间 new 出来，不再依赖物理路径包含。

标签： php js bootstrap git json composer 编码 app 工具 ai