composer如何在没有互联网的环境中部署？（satis私有仓库搭建）

私有仓库离线部署需提前镜像全部依赖，包括递归依赖、dev分支及dist/source包；Satis仅生成静态索引，必须联网时全量构建，禁用packagist并精确配置satis.json require列表，确保PHP环境与离线机完全一致。 私有仓库必须提前镜像所有依赖 离线环境部署 的核心不是“装上就能用”，而是把项目依赖链上所有包（包括递归依赖、 分支、 和 两种分发方式）完整拉下来，存成可离线访问的静态索引。Satis 本身不代理请求，它只生成一个静态 和一堆压缩包快照——所以镜像动作必须在有网时完成，且要覆盖全。 常见错误是只跑一次 ，结果发现某个 包没进仓库，或者用了 却漏了 分支的 commit。 运行 前，确保 配置里包含所有上游源（如 packagist.org、GitHub、GitLab 私有实例），否则 Satis 不知道去哪抓 显式指定 很危险：它会让构建跳过失败包，但你根本不会意识到缺了啥；建议先不加，逐个修通再批量跑 必须设为 ，否则开发用的 包不会被打包 composer .json 里不能写 packagist.org 离线环境最常踩的坑：项目 还保留着默认的 配置，导致 一启动就报 ，哪怕本地仓库地址已配好。 必须彻底禁用默认源，只留私有仓库。这不是“加一个”而是“换一个”。 执行 ，全局关掉 packagist 在项目根目录下运行 ，地址必须能被离线机器解析和访问（建议用内网 DNS 或 hosts 绑定） 检查生效：运行 ，确认输出里只有你的私有仓库，没有 相关行 satis.json 的 require 必须穷举所有用到的包 Satis 不会自动分析你的项目 ，它只按你写的 中 字段去拉取。漏写一个包，离线安装时就会卡在 然后报 。 Composer 2.9.6 Composer 2.9.6 是 PHP 生态中高效、稳定的依赖管理工具。此版本在性能与兼容性上进一步优化，改进了依赖解析算法，提升大型项目中的安装与更新速度。它支持并行下载任务，显著减少等待时间，并增强了与私有仓库及镜像源的交互稳定性。同时修复了多项命令行交互与内存使用相关的缺陷，确保在复杂依赖关系下依然可靠运行。无论是新项目初始化还是现有系统维护，Composer 2.9.6 都能为开发者提供流畅、精准的依赖管理体验。 下载 尤其注意那些间接依赖：比如你只写了 ，但实际项目用了 ，而它又依赖 ——如果 没列在 里，Satis 就不会镜像它。 用 在联网机器上展开完整依赖树，复制所有顶层 + 二级包名到 的 别信 ：Satis 不支持通配符， 会被忽略 版本写法尽量宽泛但可控，例如 比死锁 更稳妥，避免频繁重镜像 离线机器上的 PHP 环境必须匹配构建环境 Satis 生成的 zip 包本身不带 PHP 版本逻辑，但 Composer 安装时会校验 平台约束（如 ）。如果离线机器是 PHP 7.4，而镜像时用了 PHP 8.2 构建，某些包的 里写了 ，安装就会直接拒绝，报错 。 更隐蔽的问题是扩展依赖：比如某包声明 ，但离线机器没装 gd 扩展，Composer 不会提前报错，直到运行时才崩。 镜像前，在联网机器上用和离线环境**完全一致**的 PHP 版本、扩展、 设置跑 离线机器执行 前，先跑 ，它会列出所有缺失的 PHP 版本或扩展 不要依赖 ：这能绕过检查，但运行时报错更难排查 事情说清了就结束。真正麻烦的从来不是搭起 Satis，而是确认那几百个包的每一个版本、分支、平台约束，都在离线前被真实拉下来、解压验证过、且路径权限没出问题。