直接 require httplug/httplug 会报错是因为它仅提供接口定义，无实际发送能力，调用 sendrequest() 时抛出“no httplug client has been registered”；必须同时安装适配器（如 php-http/curl-client 或 php-http/guzzle6-adapter），并确保版本兼容、代码只依赖 httpclient 接口而非具体实现。
为什么直接 require httplug/httplug 会报错？
因为 httplug/httplug 只是接口定义（PSR-18 兼容的抽象层），不带任何实际 HTTP 发送能力。装完后调用 HttpClient::sendRequest() 会抛出 LogicException：“No HTTPlug client has been registered.”
必须同时选一个实现包，比如 php-http/curl-client 或 php-http/guzzle6-adapter，否则接口无法落地。
如何选对适配器并避免版本冲突？
HTTPlug 的适配器分两类：原生客户端（如 php-http/curl-client）和第三方库适配器（如 php-http/guzzle6-adapter）。关键看项目已依赖的 HTTP 库：
- 如果项目已用
guzzlehttp/guzzlev6，就装php-http/guzzle6-adapter，别装 v7 的适配器——两者不兼容 - 如果没引入 Guzzle，又想轻量，用
php-http/curl-client（注意它依赖ext-curl） -
php-http/socket-client是纯 PHP 实现，无扩展依赖，但不支持 HTTP/2 和某些高级特性
执行命令时务必指定版本约束：composer require php-http/guzzle6-adapter:^2.0，避免 Composer 自动拉取不兼容的 v1.x 或 v3.x。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
怎么写代码才能真正解耦？
核心是只依赖接口，不 new 具体类。不要写 new GuzzleHttp\Client()，也不直接 new 适配器。
- 通过 Composer 的自动发现机制加载客户端：安装适配器后，
Httplug\Discovery\HttpClientDiscovery::find()会自动找已注册的实现 - 或显式注入：在 DI 容器中把
Http\Client\HttpClient接口绑定到具体实现类（如Http\Adapter\Guzzle6\Client） - 业务代码里只 type-hint
Http\Client\HttpClient，例如：public function fetchUser(HttpClient $client): array<br>{<br> $request = new Request('GET', 'https://api.example.com/user');<br> $response = $client->sendRequest($request);<br> return json_decode((string) $response->getBody(), true);<br>}
为什么测试时 mock 不起作用？
常见错误是 mock 了具体实现类（如 Guzzle6\Client），但运行时实际被注入的是接口 HttpClient。Mock 必须针对接口：
- 用 PHPUnit mock
Http\Client\HttpClient接口，而不是某个适配器类 - 确保测试中传入的是 mock 对象，而非通过
HttpClientDiscovery::find()动态获取（后者会绕过 mock） - 若用 Prophecy，声明：
$mock = $this->prophesize(HttpClient::class);，再 stubsendRequest()方法
HTTPlug 的抽象价值只在接口稳定、实现可换时体现；一旦代码里出现具体类名或适配器专属方法（如 Guzzle 的 withOptions()），解耦就失效了。
