PHP怎么实现消费者驱动契约_PHP Pact工具使用指南【指南】-php教程-PHP中文网

php中用pact做cdc的核心是契约文件生成、验证及触发三步；需用pact-php显式调用pactbuilder生成json，确保路径/方法/头严格匹配，通过pact broker集成ci并精确实现provider state。

php怎么实现消费者驱动契约_php pact工具使用指南【指南】

PHP 项目里用 Pact 做消费者驱动契约（CDC），核心不是“能不能跑”，而是“契约文件怎么生成、怎么验证、谁来触发验证”——这三步错一步，契约就变成摆设。

PHP 本身不原生支持 Pact，得靠 pact-php（官方维护的绑定）或社区版 pact-net 的 PHP 封装。目前最稳定的是基于 pact-php + pact-cli 的组合。

必须在测试中显式调用 PactBuilder，不能只写 PHPUnit 断言——否则不会输出 .json 契约文件
每个测试方法对应一个独立的 interaction，given 描述提供方状态（如 “用户已存在”），uponReceiving 和 willRespondWith 定义请求与响应细节
生成的 pact 文件默认存到 tests/pacts/，路径需和后续验证阶段的 --pact-dir 一致，否则提供方找不到契约
别在 setUp() 里复用同一个 PactBuilder 实例——会导致多个 interaction 写进同一个 JSON 对象，验证时解析失败

这是最常卡住的环节：消费者生成了文件，但提供方验证时读不到 interaction。根本原因通常是契约内容与提供方实际接口行为不匹配，而非文件没找到。

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

检查 pact 文件里的 request.path 是否带前缀（比如消费者写了 /api/v1/users，但提供方路由是 /v1/users）——Pact 不做路径重写，必须完全一致
request.method 大小写敏感，GET 和 get 是两个东西；request.headers 中的 Content-Type 如果声明为 application/json，但提供方返回 text/plain，验证直接失败
提供方启动的 mock server 端口要和契约里 providerStatesSetupUrl 指向的地址一致；如果提供方用 Laravel，需确保 artisan serve 或 Swoole 进程在验证期间持续运行
执行 pact verify 时加 --log-level=DEBUG，看日志里是否加载了目标 .json 文件，以及是否成功发起对 provider state 接口的 POST 调用

把 Pact 验证塞进 CI 不是加一行 vendor/bin/pact-verify 就完事。关键在于隔离性与可重现性。

消费者侧上传 pact 到 Pact Broker 用 pact-broker publish，而不是直接 scp 到提供方机器——Broker 才能做版本关联和触发式验证
提供方 CI 中不要用本地 pact 文件路径验证，改用 --broker-base-url + --broker-username 拉取最新契约，避免本地缓存污染
CI 环境里提供方数据库必须清空或用 transaction rollback 模式初始化 provider state，否则上次测试残留数据会让本次验证结果不可靠
别让 Pact 验证和单元测试混在同一 job：Pact 验证耗时长、依赖外部服务，失败应单独告警，不影响主干构建通过率

契约不是文档，是可执行的接口协议。最容易被忽略的是 provider state 的实现粒度——写成 “用户存在” 这种模糊描述，不如明确成 “数据库 users 表中有 id=123 的记录且 status=active”。Pact 不会帮你查数据库，它只信你提供的 setup 接口返回的结果。