如何将一个 Composer 项目及其依赖完整地迁移到另一台机器？-composer-PHP中文网

如何将一个 Composer 项目及其依赖完整地迁移到另一台机器？

尼克

发布： 2025-12-22 11:07:02

原创

810人浏览过

Composer 项目迁移需保留 composer.json、composer.lock 和源码等必要文件，删除 vendor 等生成物，在新环境运行 composer install 确保依赖一致；锁文件缺失将导致依赖版本不可控。

如何将一个 composer 项目及其依赖完整地迁移到另一台机器？

直接复制整个项目文件夹通常不行，关键在于只保留 源码和声明性配置，让 Composer 在新机器上重新解析、下载并安装依赖。

Composer 项目必须包含以下两个核心文件，缺一不可：

如果项目里没有 composer.lock，请先在原机器运行 composer install 或 composer update 生成它（推荐 install 以保持现有版本稳定）。

迁移时只需拷贝以下内容到新机器：

务必不要复制：vendor/ 目录、composer.phar、各类日志、缓存、IDE 配置（如 .idea/）、node_modules 等。这些都应在新环境重建。

进入项目根目录后，按顺序执行：

Motiff

Motiff是由猿辅导旗下的一款界面设计工具，定位为“AI时代设计工具”

148

确认已安装匹配版本的 PHP 和 Composer（建议使用与原环境一致的 PHP 版本，可通过 php -v 和 composer --version 检查）
运行 composer install —— 这会严格按 composer.lock 安装依赖，不更改版本
如有需要，再运行 composer dump-autoload（尤其启用 PSR-4 自动加载后）
根据项目需求，手动处理环境配置（如复制并编辑 .env，设置数据库连接、密钥等）

如果遇到扩展缺失（如 ext-pdo_mysql），需在新机器安装对应 PHP 扩展，不是靠复制解决。

快速检查三件事：

运行 composer show 查看已安装包列表，对比关键依赖版本是否与 composer.lock 一致
执行 php -m | grep your_extension 确认所需 PHP 扩展已启用
运行基础命令或测试，例如 php -r "echo 'OK';" 或 ./vendor/bin/phpunit --version（若项目含 PHPUnit）

能正常加载类、执行命令、跑通简单测试，基本就说明迁移完成。

不复杂但容易忽略：锁文件是灵魂，删了它或没传过去，就不是“完整迁移”，而是“重新猜依赖”。

以上就是如何将一个 Composer 项目及其依赖完整地迁移到另一台机器？的详细内容，更多请关注php中文网其它相关文章！