composer如何引用码云Gitee私有库依赖_composer配置Gitee凭据与访问【实操】

Composer引用Gitee私有库需解决认证问题：①配置Git凭据助手自动缓存Token；②在composer.json中用HTTPS+Token或环境变量注入；③改用SSH协议并配置密钥；④确保私有库根目录有正确name字段的composer.json。

Composer 能引用 Gitee 私有库，但默认走 HTTPS 协议时会卡在凭据认证环节——不是报 401 Unauthorized，就是提示 Could not authenticate against gitee.com。根本原因：Composer 本身不管理 Git 凭据，它依赖系统级的 Git 凭据助手或手动配置的 HTTP Basic Auth。

配置 Git 全局凭据助手（推荐 macOS / Linux）

让 Git 自动缓存 Gitee 账号密码（或更安全的 Personal Access Token），Composer 执行 git clone 时就能复用：

• 确保已安装 Git 2.11+（支持 manager-core）
• 运行：

  git config --global credential.helper manager-core

• 首次执行 composer install 时，系统弹窗会要求输入 Gitee 用户名和密码（或 Token）；填入后自动保存，后续不再提示
• 注意：Windows 用户若用 Git for Windows，默认已启用 manager-core；macOS 用户可能需先运行 git credential-osxkeychain erase 清旧凭据再试

在 composer.json 中显式配置 HTTP Basic Auth（兼容所有环境）

直接把认证信息嵌入仓库 URL，适合 CI/CD 或无法调用系统凭据助手的场景。Gitee 支持用 Personal Access Token 替代密码（更安全）：

• 去 Gitee 个人设置 → 私人令牌 创建一个 Token，勾选 repo 权限
• 在 composer.json 的 repositories 中写明带认证的 HTTPS 地址：

  {
    "repositories": [
      {
        "type": "vcs",
        "url": "https://your_token@gitee.com/your-username/your-private-repo.git"
      }
    ]
  }

• Token 暴露在 composer.json 中有泄露风险，CI 环境建议用环境变量替换：

  "url": "https://${GITEE_TOKEN}@gitee.com/your-username/your-private-repo.git"

  ，然后在 CI 配置中注入 GITEE_TOKEN

改用 SSH 协议并配置 SSH Key（适合长期开发）

避免密码/Token 管理，且无需每次输凭据。前提是已在 Gitee 账户添加了 SSH 公钥：

• 确认本地已有可用 SSH key（如 ~/.ssh/id_rsa.pub），并已添加到 Gitee SSH 公钥设置页
• 在 composer.json 中使用 SSH URL：

  "url": "git@gitee.com:your-username/your-private-repo.git"

• 确保 Composer 能调用 git 命令且 SSH agent 正常工作：终端执行 ssh -T git@gitee.com 应返回成功欢迎语
• 注意：某些容器环境（如 Alpine）默认没装 OpenSSH client，需先 apk add openssh-client

最易忽略的一点：Gitee 私有库的 composer.json 文件必须放在仓库根目录，且 name 字段需与你在项目中 require 的包名完全一致（如 "your-username/your-private-repo": "^1.0"）。否则 Composer 找不到可用版本，报错 Could not find package ... in a version installable using your PHP version。