Composer怎么导出项目依赖 Composer项目备份与迁移技巧

composer.json 和 composer.lock 必须一起备份，缺一不可

只备份 composer.json 是危险操作——它只是“想装什么”的声明，不是“实际装了什么”的记录。composer.lock 才是关键：它锁定了每个包的确切版本、哈希值、下载源和完整依赖树。Git 提交时漏掉 composer.lock，等于没备份。

常见错误现象：composer install 在新机器上装出不同版本的包，结果运行时报 Class not found 或方法不存在；CI 构建通过但线上报错，根源往往就是 lock 文件没提交或被意外修改。

备份前先运行 git status，确认 composer.lock 是 clean 状态（未被修改）若项目用了 "config": {"platform": {…}}（比如锁定 PHP 或扩展版本），这些配置也得记下来，还原时可能需手动调整或加 –ignore-platform-reqs（仅临时应急）别用 composer install –dry-run 试图“导出依赖列表”——它不输出任何内容，纯属无效操作

不要复制 vendor 目录，重装才是唯一可靠方式

直接 cp -r vendor/ 到新服务器或新项目，99% 会失败。vendor 不是静态资源，它含绝对路径硬编码、平台相关构建产物（如 ext-gd 的 .so）、post-install-cmd 脚本生成的文件，以及与当前 PHP ABI 绑定的 opcache 字节码。

典型报错包括：Failed to open stream: No such file or directory（因 vendor/bin 脚本头行写了旧 PHP 路径）、undefined symbol（扩展 ABI 不兼容）、Class not found（autoload.php 路径缓存失效）。

迁移前删掉目标目录下的 vendor/，哪怕它看起来“已经存在”只传 composer.json 和 composer.lock 过去，然后运行 composer install –no-dev –optimize-autoloader若新环境 PHP 版本略高（如锁文件要求 ^8.0，当前是 8.2），可加 –ignore-platform-req=php 强制过检，但务必确认代码真能跑通

全局配置和全局安装的包怎么备份

Composer 全局配置（如镜像源、认证信息）不走 composer.json，它就存在一个 JSON 文件里，没有“导出命令”。composer config –global –list 只是只读快照，不能拿来还原。

真正要备份的，是 composer config –global –list 第一行显示的 “Global configuration file” 路径，比如 ~/.composer/config.json 或 %APPDATA%\Composer\config.json。复制这个文件最稳。

备份命令示例：cp ~/.composer/config.json ~/.composer/config.json.backup-$(date +%Y%m%d)全局安装的插件（如 laravel/installer）不被项目 lock 文件记录，用 composer global show –direct –format=plain 导出包名+版本，用于人工核对或 CI 检查composer install 对全局环境完全无效——它只处理当前目录下的 composer.json，别指望靠它恢复全局状态

新环境还原前必须检查的三件事

很多 composer install 表面成功，但后续运行就崩，问题出在环境前提没对齐。不是 Composer 不报错，而是它不负责验证 runtime 是否可用。

用 php -v 核对 PHP 版本 ≥ composer.json 中 "php" 字段声明的最低版本；更准的是在旧环境跑 composer show php 查解析出的实际版本用 composer check-platform-reqs 列出缺失的扩展（如 mbstring、xml、zip），CentOS 用 yum install php-mbstring，Ubuntu/Debian 用 apt install php-mbstring私有包（如 GitLab 私仓）需提前配置认证：composer config -g http-basic.gitlab.example.com token username，否则 install 会卡在下载阶段

最容易被忽略的是权限问题：vendor/autoload.php 若对 Web 用户（如 www-data）不可读，就会报 Class not found——装完记得 chgrp -R www-data vendor && chmod -R g+r vendor。