Composer怎么搭建Satis私有源_Composer如何用Satis生成静态的私有Composer仓库【进阶】-composer-PHP中文网

satis包列表为空的主因是repositories中源未被识别为可抓取的composer包，需设type为"vcs"、url指向含composer.json的仓库根目录，并确保认证权限；私有包支持dev-main和v前缀tags需配"no-api":true、"branches"及"require-all":true；客户端拉不到包常因repositories配置错误或web服务器禁.json访问；构建慢可加--skip-errors、调内存、限git超时并定期清理dist旧文件。

composer怎么搭建satis私有源_composer如何用satis生成静态的私有composer仓库【进阶】

为什么 `satis` 生成的包列表总是空的

常见现象是运行 bin/satis build 后，packages.json 里 packages 字段为空，或者浏览器打开仓库首页只显示空数组。根本原因不是配置写错了，而是 satis.json 里 repositories 下的每个源没被正确识别为“可抓取的 Composer 包”。

必须确保每个 repository 的 type 是 "vcs"（支持 git、svn、hg），不能是 "package" 或漏写
url 必须指向一个含有效 composer.json 的仓库根目录（比如 https://gitlab.example.com/myorg/mylib.git），不能是 raw 文件链接或网页地址
如果用私有 Git 服务，satis 运行时需有对应 SSH key 或 HTTP 认证权限——它不会复用你本地 git clone 的凭据
运行前先手动 git ls-remote <your-url></your-url> 测试连通性，失败就别指望 satis 能扫描到 tag/branch

如何让私有包支持 `dev-main` 和带 `v` 前缀的 tag

satis 默认只认符合 semver 规范的 tag（如 1.2.3），但很多团队用 v1.2.3 或直接推 dev-main 分支。不配好，Composer 客户端就拉不到这些版本。

在 satis.json 的 repositories 每个项里加 "no-api": true，强制 satis 用 git 命令解析分支和 tag，绕过 GitHub/GitLab API 限制
加 "branches": ["main", "dev-*"] 显式声明要包含的分支（"branches": true 也行，但会变慢）
tag 名称过滤靠 "require-all": true + "archive": {"skip-dev": false}，否则 v* tag 会被忽略
注意：启用 "archive" 后，satis 会在输出目录生成 dist 子目录，客户端走 dist 下载更稳定，但构建时间明显增加

`composer require` 报 `Could not find package xxx at any version`

这通常不是包不存在，而是客户端根本没查你的私有源。Satis 生成的是静态文件，没有后台服务，所以 Composer 必须明确知道去哪找。

Academic Composer Upload

辅助学术写作，包括查找资料、生成大纲、引用扩写及润色风格，同时确保引用规范。

下载

确认项目 composer.json 里写了正确的 repositories，且 type 是 "composer"，url 指向你部署好的 packages.json 所在路径（例如 "https://satis.example.com/packages.json"）
不要把 url 写成 "https://satis.example.com/" —— Composer 不会自动拼 /packages.json
执行 composer clear-cache，再跑 composer require myorg/mylib:dev-main；如果还报错，用 composer -v require ... 看真实请求的 URL 是否 404
检查 Web 服务器是否允许 .json 文件被访问（Nginx/Apache 默认可能禁用，需显式放开）