ubuntu composer如何配置存储位置

Ubuntu 下 Composer 存储位置配置指南

一 核心概念与默认位置

• 配置分为两层：全局作用于当前用户的所有项目，项目级仅作用于当前项目根目录。项目级配置优先于全局配置。
• 全局配置路径在 Ubuntu 上常见为：~/.config/composer/config.json；同时存在旧路径 ~/.composer/config.json（部分环境仍在使用）。全局生效项包括镜像源、缓存目录、GitHub OAuth 等。项目级配置位于项目根目录的 composer.json。可通过命令查看与修改全局配置，例如：composer config -g --list、composer config -g home。

二 修改全局存储目录 COMPOSER_HOME

• 适用场景：将全局配置、缓存与全局包统一迁移到指定目录（如 /opt/composer）。
• 步骤：
  1. 在 shell 配置文件中导出环境变量（如 ~/.bashrc 或 ~/.zshrc）：

     export COMPOSER_HOME="/opt/composer"
     export PATH="$COMPOSER_HOME/vendor/bin:$PATH"
     

  2. 使配置生效：source ~/.bashrc（或 source ~/.zshrc）。
  3. 迁移旧数据（如有）：cp -r ~/.composer/* /opt/composer/（若旧目录存在）。
  4. 验证：echo $COMPOSER_HOME 与 composer config -g home 应返回新路径；测试全局包安装：composer global require phpunit/phpunit，并检查 $COMPOSER_HOME/vendor/bin 是否生成可执行文件。
  5. 注意：确保新目录具备读写权限，且 $COMPOSER_HOME/vendor/bin 已加入 PATH。

三 单独调整缓存 vendor 目录与全局 bin 路径

• 调整缓存目录（不影响全局配置目录）：

  composer config -g cache-dir /data/composer/cache
  

• 调整全局包安装目录（vendor）与全局可执行文件目录（vendor/bin）：

  composer config -g vendor-dir /data/composer/vendor
  composer config -g bin-dir /data/composer/vendor/bin
  

  提示：修改 vendor-dir 后，确保将新的 vendor/bin 加入 PATH，以便直接使用通过 composer global require 安装的工具。
• 生效与验证：
  • 涉及源或缓存变更时，建议执行：composer clear-cache。
  • 查看生效配置：composer config -g --list；查看目录：composer config -g home、composer config -g cache-dir、composer config -g bin-dir。

四 项目级存储位置与优先级

• 在项目根目录编辑 composer.json，可覆盖全局设置，例如自定义 vendor-dir：

  {
    "config": {
      "vendor-dir": "libs/vendor",
      "cache-dir": "tmp/composer-cache"
    }
  }
  

• 原则：项目级配置优先于全局配置；团队协作或 CI 建议将关键路径写入项目级 composer.json 以保证一致性。