首先配置私有仓库地址并在composer.json中添加repositories字段，然后通过composer config命令设置认证信息，接着在require中声明私有包并执行install更新依赖，最后可选配置全局仓库以供多项目复用。
如果您尝试在项目中引入私有的 PHP 包，但 Composer 无法找到或下载该包，则可能是由于未正确配置私有仓库。以下是将 Composer 配置为使用私有 Packagist 仓库的详细步骤。
本文运行环境：MacBook Pro，macOS Sonoma
一、配置私有仓库地址
为了使 Composer 能够访问私有包，需要在项目的 composer.json 文件中声明私有仓库的地址。该仓库可以是自建的 Satis 服务器、私有 Packagist 实例，或 GitLab/Bitbucket 等支持 Composer 的托管服务。
1、打开项目根目录下的 composer.json 文件。
2、在文件顶部添加 repositories 字段，并指定仓库类型和 URL。
3、示例配置如下：
"repositories": [
{
"type": "composer",
"url": "https://packages.example.com"
}
]
二、设置认证信息以访问私有仓库
大多数私有仓库需要身份验证才能拉取包。Composer 支持通过 HTTP 基本认证或 OAuth Token 进行安全访问。认证信息不应直接写入 composer.json，而应存储在全局配置中。
1、运行命令 composer config --global http-basic.packages.example.com username password 来保存凭证。
2、系统会提示输入用户名和密码，这些信息将被加密保存至用户主目录的 auth.json 文件中。
3、确保域名与仓库 URL 中的主机名完全一致，避免因域名不匹配导致认证失败。
三、使用私有包作为项目依赖
一旦私有仓库被正确配置并完成认证，就可以像使用公共包一样在项目中引用私有包。
1、在 composer.json 的 require 字段中添加所需的私有包名称和版本约束。
2、例如：
"require": {
"private-vendor/private-package": "^1.0"
}
3、执行 composer install 或 composer update 命令来安装依赖。
四、配置全局私有仓库（适用于多项目）
若多个项目共享同一个私有仓库，可通过修改全局 composer.json 文件避免重复配置。
1、运行 composer config --global repositories.private-composer composer https://packages.example.com 将私有仓库添加到全局配置。
2、全局配置位于 ~/.composer/config.json，所有后续执行的 Composer 命令都将自动识别该仓库。
3、注意优先级：项目本地的 repositories 配置会覆盖全局设置。
