Composer如何使用Satis_Composer私有仓库Satis搭建教程【精选】-composer-PHP中文网

satis不是服务，仅生成静态文件；配错repositories位置、漏禁packagist.org或web服务器未托管packages.json，就会导致composer install报404或“could not fetch”。

composer如何使用satis_composer私有仓库satis搭建教程【精选】

直接说结论：Satis 不是服务，它只生成静态文件；你配错 repositories 位置、漏掉 "packagist.org": false 或 Web 服务器没托管好 packages.json，composer install 就会报 404 或 “Could not fetch”。

为什么 `composer update` 报 `Could not fetch packages.json`，但 `curl` 能通

这不是网络不通，而是路径或 Web 服务器配置错位。常见原因有三个：

satis.json 中的 output-dir 是绝对路径（如 /var/www/satis），但 Nginx 的 root 没指向它，导致 https://satis.example.com/packages.json 实际返回 404
Web 服务器没把 packages.json 设为默认索引文件，而你访问的是根 URL（如 https://satis.example.com/），它试图找 index.html，但 Satis 默认不生成这个（除非你加了 "archive" 配置并启用了页面）
satis.json 里 homepage 值是 https://satis.example.com，但你实际部署在子路径（如 https://example.com/satis），所有 dist.url 和包元数据都会错乱

`composer.json` 里怎么写 `repositories` 才生效

客户端配置错一个字符，整个私有源就形同虚设。Satis 生成的是静态 JSON，不提供重定向或兜底逻辑，repositories 必须精准匹配生成路径。

Discussion Composer

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

下载

url 必须以 / 结尾：写成 "https://packages.internal" 会导致 Composer 拼出 https://packages.internal/packages.json（404）；正确写法是 "https://packages.internal/"
类型必须是 "type": "composer"：不能写成 "type": "vcs" 或漏掉 type 字段，否则 Composer 当作无效源直接跳过
不能依赖 packagist.org 回退：默认情况下 Composer 会同时查 packagist.org，如果你只想走私有源，得显式禁用：composer config --unset repos.packagist 或在 composer.json 里加 "packagist.org": false 到 repositories 数组最前面

`satis.json` 的 `require` 和 `require-all` 到底怎么选

这决定你仓库里到底有没有包，以及有多少版本。Satis 不做智能推断，它只按配置硬匹配。

"require-all": true 会拉所有 tag 和稳定分支（如 v1.2.0、1.2.x-dev），但也会把 dev-main 这类开发分支塞进去，除非你加 "minimum-stability": "stable"
"require" 是精确控制：比如 "acme/utils": "^2.0"，Satis 会去每个 repositories 里找 name 匹配的包，并只收录满足该版本约束的 tag；注意不支持通配符，"acme/*": "*" 完全无效
require 和 require-all 不能共存，混用会导致静默跳过部分包；想全量镜像就只留 "require-all": true，想精准控制就删掉这行，改用 "require": {"vendor/package": "dev-main"}

dist 包下载失败：`curl` 能通但 `composer install` 报 `file could not be downloaded`

这不是权限或网络问题，是 Web 服务器没正确暴露 dist 文件路径，或者 MIME 类型没配对。

Satis 默认把 ZIP 放在 dist/vendor-package/version-hash.zip，Nginx/Apache 必须能让这个路径被直接 GET 到，比如访问 https://pkgs.your.org/dist/acme-utils/1.0.0.0-abc123.zip 返回 200
Nginx 需加 types { application/json json; }，否则 packages.json 响应头是 text/plain，Composer 拒绝解析
Apache 要启用 mod_mime 并确保 .json 关联 application/json
检查 satis.json 是否启用了 archive：没配 "archive": {"format": "zip", "skip-dev": false}，Satis 就不会生成 ZIP，composer install --prefer-dist 只能退回到 clone，而内网往往禁了 Git 端口