Composer怎么共享私有包？搭建局域网私有源步骤-composer-PHP中文网

composer全局配置repo.packagist仅替换元数据源（packages.json），不重写包的dist.url（如github zip链接），故内网部署需确保dist目录可直连访问、nginx正确暴露satis output-dir、url末尾带/、mime类型设为application/json，且项目级repositories数组中私有源配置须完整准确。

composer怎么共享私有包？搭建局域网私有源步骤

不能只改 composer config -g repo.packagist，那只是换元数据入口，ZIP 包仍会去 GitHub 下载——局域网根本打不开。

为什么全局 config 不生效

执行 composer config -g repo.packagist composer https://pkgs.internal/ 后，packages.json 确实会从内网地址拉，但每个包的 dist.url（比如 https://github.com/monolog/monolog/releases/download/2.10.0/monolog-2.10.0.zip）仍保持原始值。Composer 不会重写 dist 地址，它只认你给它的 URL 路径。

验证方式：运行 composer show monolog/monolog --verbose，盯着输出里的 dist.url 字段——如果还是 GitHub 或其他外网地址，说明 ZIP 根本下不来。

国内镜像（阿里云、腾讯云）只缓存 packages.json 和 provider-*.json，不托管 ZIP
dist/ 目录必须能被 HTTP 直连 GET，例如 https://pkgs.internal/dist/monolog/monolog/2.10.0/xxx.zip
SELinux、文件权限、Nginx root 配置错误，都会导致 404 ——不是网络不通，是路径没暴露对

Satis 生成的静态文件怎么让 Composer 认得

Satis 不是服务，只是个文件生成器。它不监听端口，也不处理请求，所有东西都写进 output-dir 目录（比如 /var/www/satis/web），靠 Nginx 暴露出去。

Workflow Decomposer

工作流任务拆解与模型编排技能。使用场景：(1) 收到复杂工作任务需要拆解为可执行步骤，(2) 需要为不同步骤选择最合适的模型，(3) 需要跟踪工作流进度和模型使用情况，(4) 长时间任务卡住需要问题诊断和解决方案。

下载

Nginx 的 root 必须精确指向 Satis 的 output-dir，不能多一层或少一层
必须显式声明 JSON MIME 类型：types { application/json json; }，否则返回 text/plain，Composer 拒绝解析
镜像 URL 必须以 / 结尾，比如 "url": "https://pkgs.internal/"；少一个斜杠，Composer 会拼成 https://pkgs.internalpackages.json
检查 dist/ 下 ZIP 文件是否真实可访问，用 curl -I https://pkgs.internal/dist/xxx.zip 看 HTTP 状态码

项目级 composer.json 的 repositories 怎么写才对

私有源配置必须写在你要 require 包的那个项目的根目录 composer.json 里，不是 Satis 自己的配置文件，也不是私有包自己的 composer.json。

repositories 必须是 JSON 数组，不能是对象（{"my-repo": {...}} 是错的）
每项必须含 "type": "composer" 和 "url"，且 url 值末尾带 /
多个源按顺序匹配，第一个命中就停，同名包后面的会被忽略
如果用了 HTTPS 私有源，凭据只能走 auth.json，且权限必须是 600：chmod 600 auth.json，否则 Composer 静默忽略