Composer测试环境离线怎么配置？本地联调搭建步骤-composer-PHP中文网

离线安装必须禁用 packagist.org，执行 composer config --global repo.packagist false 并清除项目级 packagist 配置；artifact 类型实现零网络安装，要求压缩包命名、内容、目录结构严格匹配；path 类型用于本地联调，需用相对路径、显式设 "symlink": false、require 带 @dev，并正确配置 autoload-dev 与命名空间。

composer测试环境离线怎么配置？本地联调搭建步骤

离线安装必须禁用 packagist.org，否则一定连网

哪怕你已经加了 artifact 或 path 仓库，只要 repo.packagist 没彻底关掉，composer install 就会尝试向 https://packagist.org 发起 DNS 查询甚至 HTTP 请求。这不是“可能”，而是 Composer 2.5+ 的默认 fallback 行为。

必须执行两步：

composer config --global repo.packagist false（全局关掉）
composer config repo.packagist 在项目根目录下运行，确认输出为空；如果显示 composer https://packagist.org，说明项目级配置里还残留着旧源，要手动删掉 composer.json 中 repositories 数组里指向 packagist 的条目

验证是否生效：跑一次 composer install -v，全程不应出现 Downloading https://repo.packagist.org/ 或任何含 packagist.org 的日志行。

用 artifact 类型实现纯离线安装（适合打包部署）

artifact 是唯一真正“零网络”的类型——它只读本地 .tar.gz 文件，不校验远程、不查元数据、不发任何请求。

关键约束很硬，错一个就失败：

压缩包命名必须是 vendor-name/package-name-version.tar.gz，例如 monolog/monolog-2.13.0.tar.gz
包内 composer.json 的 name 和 version 必须与文件名完全一致（大小写、分隔符都不能差）
所有 .tar.gz 放进同一个平级目录，比如 /opt/artifacts/，不能有子目录嵌套
配置命令是：composer config repositories.offline '{"type":"artifact","url":"/opt/artifacts/"}'

注意：composer.lock 中的 dist.shasum 会被用来查找对应文件，校验失败直接报错，不会 fallback。

用 path 类型做本地联调（适合边写边测）

path 类型跳过所有网络交互，直接加载本地目录里的 composer.json，但仅适用于你手头已有完整源码的包。

Workflow Decomposer

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

下载

常见翻车点：

路径必须是相对路径，比如 ./packages/my-utils；绝对路径如 /home/user/my-utils 在 CI 或他人机器上必然失效
composer.json 中必须显式写 "options": {"symlink": false}，否则离线环境软链会断
require 时必须带 @dev，例如 composer require my-utils/my-utils:@dev；不加就匹配不到本地路径
包的 name 字段（如 "my-utils/my-utils"）必须和 require 写的一模一样，包括大小写

改完 composer.json 后，别只跑 composer install，建议补一句 composer dump-autoload，确保 autoloader 映射及时更新。

测试类找不到？autoload-dev 配置漏了或没生效

本地联调时，常遇到 Class not found 报错，但其实不是路径问题，而是测试类根本没进 autoloader。

必须用 autoload-dev，不能用 autoload：

autoload-dev 只在 composer install --no-dev 以外的场景生效，且不会打进生产包
psr-4 规则要严格配对，例如 "Tests\": "tests/" —— 注意结尾双反斜杠，少一个就是非法命名空间
测试文件 tests/Feature/AuthTest.php 对应的类必须声明 namespace TestsFeature;
改完后必须运行 composer dump-autoload；CI 环境中尤其不能依赖 composer install 自动触发

验证是否加载成功：composer show -s | grep Tests，能看到映射行才算到位。

离线配置最麻烦的不是步骤多，而是每个环节都拒绝“差不多”——命名、路径、斜杠、大小写、@dev、symlink: false、repo.packagist false，缺一不可。一旦出错，Composer 不报明确错误，只静默回退到网络源或抛出模糊异常，得靠 -v 日志逐行盯请求地址才能定位。