ubuntu composer如何备份和恢复

Ubuntu 下 Composer 的备份与恢复

一 核心备份清单

• 项目依赖清单：备份 composer.json 与 composer.lock（锁定版本，保证恢复一致性）。
• 依赖代码：可选备份 vendor/（体积大，通常不建议纳入版本控制，但在离线/快速迁移时可一并备份）。
• 全局配置：备份 ~/.composer/config.json（包含镜像源、认证、插件策略等全局设置）。
• 建议纳入版本控制：至少将 composer.json 与 composer.lock 提交到 Git；不建议提交 vendor/，以减小仓库体积并避免平台差异带来的问题。

二 备份与恢复步骤

• 备份
  1. 项目文件
  • 复制依赖清单：cp composer.json composer.lock /path/to/backup/
  • 可选复制依赖：cp -r vendor /path/to/backup/
  2. 全局配置
  • 复制配置：cp ~/.composer/config.json /path/to/backup/
• 恢复
  1. 项目文件
  • 还原清单：cp /path/to/backup/composer.json /path/to/backup/composer.lock /path/to/project/
  • 可选还原依赖：cp -r /path/to/backup/vendor /path/to/project/
  2. 全局配置
  • 还原配置：cp /path/to/backup/config.json ~/.composer/
• 使用 Git 进行版本化备份与恢复（推荐）
  • 备份：git add composer.json composer.lock && git commit -m “Backup dependencies”
  • 恢复：git checkout HEAD – composer.json composer.lock（如需 vendor 历史版本也可一并检出）

三 无 composer.json 时从 vendor 重建

• 进入项目根目录，确认 vendor/composer/installed.json 存在。
• 列出已安装包：composer show --installed，整理出包名与版本，手动写入 composer.json 的 require（或 require-dev）。
• 执行 composer install 生成 vendor/autoload.php 等自动加载文件。
• 若 installed.json 缺失，只能依据现有代码与历史记录逐个补齐依赖与版本。

四 自动化与注意事项

• 使用脚本打包备份（示例）
  • 备份：tar czf composer-backup-$(date +%F).tar.gz -C /path/to/project composer.json composer.lock vendor ~/.composer/config.json
  • 恢复：tar xzf composer-backup-2025-12-22.tar.gz -C /restore/dir
• 注意事项
  • 不建议将 vendor/ 纳入 Git；使用 composer.lock 保证一致性，恢复时优先使用 lock 文件安装。
  • 跨机器/CI 环境恢复时，优先执行 composer install（而非 update），避免意外升级。
  • 若更换了 Packagist 镜像或代理，恢复后执行 composer clear-cache 确保配置生效。
  • 全局配置包含敏感信息（如 github-oauth、私有仓库凭据），备份与传输时注意权限与保密。