Composer怎么用自定义Packagist_Composer自定义Packagist教程【简明】-composer-PHP中文网

composer 认出私有 packagist 需在 composer.json 的 repositories 数组首位配置 type 为 composer、url 以 / 结尾的源，并禁用 packagist.org；认证需正确放置 auth.json（含 http-basic 凭据）；本地开发可用 path 类型仓库快速测试。

composer怎么用自定义packagist_composer自定义packagist教程【简明】

怎么让 Composer 认出你的私有 Packagist

Composer 不会自动信任任意 URL，必须显式声明源类型为 composer，且 URL 必须以 / 结尾——否则它会拼成 https://pkgs.example.com/packages.json（正确）变成 https://pkgs.example.compackages.json（404）。

在项目根目录的 composer.json 中，把私有源放在 repositories 数组**第一位**

写法必须是：

{ "type": "composer", "url": "https://packagist.myorg.com/" }

（注意末尾斜杠）

务必加上 "packagist.org": false，否则同名包可能从官方源“偷偷”装进来，覆盖你本意要拉的私有版本
执行 composer clear-cache 再 composer install，不然缓存里还是旧元数据

为什么 curl 能通但 Composer 报 401 或 Authentication required

不是服务没开，是认证凭据根本没送到请求头里。Composer 查 auth.json 的路径有固定顺序：当前目录/auth.json → $COMPOSER_HOME/auth.json → $HOME/.composer/auth.json（旧版），漏掉任何一个环节都会失败。

别把 token 硬编码进 composer.json，那是安全红线
CI 环境中 $COMPOSER_HOME 常为空，结果它去读了空的全局 auth.json，而不是你传进去的临时文件

正确的 auth.json 格式：

{ "http-basic": { "packagist.myorg.com": { "username": "", "password": "your-api-token" } } }

如果用的是 GitHub Packages / GitLab Registry 这类平台，用户名通常填 token，密码填实际 token 字符串

自建镜像该选 Satis 还是 packagist-private

除非你真需要 Web 界面、用户登录、包审核流程，否则直接上 Satis。它不跑 PHP-FPM、不连数据库、不处理 CSRF，只生成静态 packages.json 和 ZIP 包，配个 Nginx 就能当源用，运维成本低一个数量级。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

Satis 最低要求 PHP 7.4，推荐用官方 satis:latest Docker 镜像
satis.json 中必须有 name 和 homepage 字段，否则 Composer 直接拒绝加载该源
若要包含 dev- 分支，得显式设 "require-dependencies": true，不然依赖树不全
常见报错 Skipping package myorg/utils, no suitable releases found，八成是 Git 权限问题或 tag 没推上去，Satis 不会帮你 clone 私有仓库

本地开发时怎么跳过 Packagist 直接试包

别等提交、打标、同步、再安装——太慢，也容易掩盖 autoload 或命名空间问题。用 path 类型仓库，让 Composer 直接 symlink 本地目录，改完立刻生效。

在测试项目的 composer.json 里加：

"repositories": [{ "type": "path", "url": "../my-awesome-package" }]

然后运行 composer require myvendor/awesome-package:dev-main（dev-main 指向分支，不是 tag）
这个方式绕过所有网络、认证、tag 解析环节，专治“装得上但类找不到”这类 autoload 错误
注意：path 源不能用于生产环境，发布前必须切回真实私有源或 Packagist

最常被忽略的点是：URL 末尾斜杠、auth.json 放错位置、以及以为打完 tag 就万事大吉——其实 Packagist 只认 v1.0.0 这种带 v 前缀的语义化标签，1.0.0 或 release-1.0 都无效。