内网开发Composer怎么配置离线仓库-composer-PHP中文网

离线仓库必须用 artifact 或 path：artifact 要求规范命名的压缩包且 name/version 严格匹配；path 要求相对目录可移植并禁用软链；必须全局禁用 packagist、显式配置 cache-files-dir（末尾为 /files）、避免 create-project，新增依赖仅支持 path 方式且需带 @dev。

内网开发composer怎么配置离线仓库

离线仓库必须用 `artifact` 或 `path`，不能靠改 `repo.packagist.org` 地址

很多人以为把 composer.json 里的 repositories 改成 https://192.168.1.100/packages.json 就算离线了——其实只要没禁用默认源，Composer 仍会尝试连 repo.packagist.org 做 fallback。真正有效的离线方式只有两种：artifact（适合部署）和 path（适合本地开发联调），其他类型（如 composer 类型的本地镜像）仍需元数据解析，容易漏配。

artifact 要求所有包是命名规范的 .tar.gz 或 .zip，文件名必须为 vendor/name-version.tar.gz，且包内 composer.json 的 name 和 version 必须与文件名完全一致
path 要求包目录在项目内可移植（如 ./packages/my-lib），不能写绝对路径；composer.json 中必须带 "options": {"symlink": false}，否则离线机上软链失效
无论哪种，都必须全局关闭 Packagist：composer config --global repo.packagist false；再检查项目级配置是否残留：composer config repo.packagist 输出应为空，不是 composer https://packagist.org

`cache-files-dir` 必须显式配置，`cache-dir` 配了也白配

离线时 Composer 只认 cache-files-dir 下的 ZIP 包，cache-dir 只是父目录，不控制 ZIP 存放位置。未设 cache-files-dir 时，它会回退到默认的 ~/.composer/cache/files，而离线机上这个路径通常为空或不可写，导致静默重下。

Workflow Decomposer

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

下载

正确做法：在线机先清旧配置 composer config --global --unset cache-dir，再设 composer config --global cache-files-dir /opt/composer-cache/files（注意末尾必须是 /files）
验证是否生效：运行 composer install --prefer-dist 后，检查 /opt/composer-cache/files/vendor/name/version-hash/name-version-hash.zip 是否真实存在
离线机上要完整复制整个 /opt/composer-cache/files 目录（保留层级），再执行 composer config --global cache-files-dir /your/copied/path/files
常见失败点：目录权限不对（如 PHP 进程用户无法 stat() 文件）、路径少写了 /files、或 cache-read-only 设为 true 但目录实际不可读

别碰 `create-project`，它离线必挂

create-project 是个黑盒命令，第一步就强制联网请求 packages.json 解析模板元数据，COMPOSER_DISABLE_NETWORK=1 对它无效，--offline 参数根本不存在。哪怕你把 composer.lock 和 composer.phar 全拷过去，它照样报 Could not fetch https://repo.packagist.org/packages.json。

可行替代路径：在联网机用 git clone 或解压官方 ZIP 拿到骨架，删掉原有 composer.lock，再执行 composer install --no-dev --prefer-dist --no-scripts --no-plugins --optimize-autoloader
打包整个项目（含 vendor/、composer.lock、composer.json）传到离线机
离线机执行：composer config --global cache-dir /dev/null → COMPOSER_DISABLE_NETWORK=1 composer install --no-plugins --no-scripts --no-autoloader → 最后补 composer dump-autoload -o

新增依赖只能靠 `path`，`require` 默认不离线

离线环境下，composer require monolog/monolog 一定会失败，因为它默认要查 Packagist。唯一能离线加新包的方式是提前配置好 path 仓库，并确保包目录已存在、composer.json 有效、且 name/version 完全匹配。

项目 composer.json 中添加："repositories": [{"type": "path", "url": "./packages/monolog"}]
包目录结构必须是：./packages/monolog/composer.json，其中 "name": "monolog/monolog"，"version": "2.13.0"（版本号要和你想 require 的一致）
执行 composer require monolog/monolog:@dev —— 注意必须带 @dev，否则 Composer 不启用 path 查找逻辑
如果包本身还有依赖，这些依赖也得是 path 或已存在于 vendor/ 中，否则会卡住

离线配置最易被忽略的点：所有路径都必须是**绝对路径**（cache-files-dir、artifact url、path url），相对路径在跨机器迁移或不同工作目录下极易失效；同时，PHP 进程用户对这些路径要有完整读权限，stat() 失败不会报错，只会静默 fallback 到联网。