为局域网开发环境搭建Composer脱机镜像的完整方案-composer-PHP中文网

能搭，但“脱机镜像”必须同时满足三硬条件：所有依赖（含递归子依赖）元数据完整、所有dist zip包可本地http访问、composer客户端全程不发外网请求；缺一即导致composer install在resolving dependencies阶段卡死或报could not find package。

为局域网开发环境搭建composer脱机镜像的完整方案

能搭，但“脱机镜像”不是配个 URL 就完事——它必须同时满足三个硬条件：所有依赖（含递归子依赖）的元数据完整、所有 dist ZIP 包可本地 HTTP 访问、Composer 客户端全程不发任何外网请求。缺一不可，否则 composer install 会在 Resolving dependencies 阶段卡死或报 Could not find package。

确认 Satis 构建是否真正包含全部依赖

很多人用 satis build 后发现某些包还是拉不到，问题出在默认只同步顶层 require 列表，而 Composer 解析时会动态请求子依赖（比如 monolog/monolog 依赖的 psr/log）。Satis 不自动递归抓取这些间接依赖，除非你显式启用。

"require-all": true —— 全量同步 Packagist 所有公开包（慎用，首构建可能超 40GB）
"require-dependencies": true —— 必须开启，否则子依赖元数据缺失
"require-dev-dependencies": true —— 若项目含 require-dev，也需同步其依赖树
不要混用 require 和 require-all：二者冲突，Satis 会静默忽略 require

离线环境必须用 HTTP 服务托管，file:// 协议不可靠

file:// 看似最简单，但它在 Docker、CI runner、不同用户权限下极易失败：composer install 可能解析出错、跳过 ZIP 下载、或因路径空格/编码问题直接崩溃。真实可用的方案是让离线机器跑一个最小 HTTP 服务，把 Satis 输出目录挂为根路径。

Discussion Composer

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

下载

启动命令示例（Python 3）：python3 -m http.server 8000 --directory ./web
访问地址必须是 http://127.0.0.1:8000 或局域网 IP（如 http://192.168.1.100:8000），不能用 localhost（部分 PHP 环境 DNS 解析异常）
Satis 的 archive.prefix-url 必须与实际服务地址一致，否则生成的 ZIP 下载链接会 404
Nginx/Apache 更稳：配置 root /path/to/web; + index packages.json; 即可

客户端配置必须禁用 packagist.org 并验证生效路径

只改 composer.json 的 repositories 不够，因为 Composer 默认仍会 fallback 到官方源。必须双保险：项目级显式禁用 + 全局源指向内网地址，且两者 key 名和结构要严格匹配。

项目 composer.json 中写入（注意顺序和格式）：

{
  "repositories": [
    {
      "type": "composer",
      "url": "http://192.168.1.100:8000"
    },
    {
      "packagist.org": false
    }
  ]
}

全局配置命令必须带 -g 且三要素齐全：composer config -g repo.packagist composer http://192.168.1.100:8000/（末尾斜杠不能少）
验证是否生效：composer config -g repo.packagist 输出必须是 {"type": "composer", "url": "http://192.168.1.100:8000/"}，空值或报错说明没写对
执行 composer install -v 观察日志：若出现 Downloading https://repo.packagist.org/...，说明配置未生效或被覆盖

最关键的细节常被忽略：Satis 构建后，packages.json 里每个包的 dist.url 字段必须是绝对路径（如 "http://192.168.1.100:8000/dist/monolog/monolog/2.9.1.zip"），而不是相对路径；一旦这个 URL 返回 404，Composer 不会报错，只会跳过该包、继续尝试下一个——最终结果是 vendor 缺文件，但安装过程看似成功。