迁移旧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不负责加载它们）。
立即学习“PHP免费学习笔记（深入）”；
- 用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
基本上就这些。重点不在一步到位，而在每次提交都保持功能完整。迁移完成后，你会获得可复现的依赖、清晰的类加载路径、以及未来升级扩展的基础能力。
