应复用单例或静态 HttpClient 实例并设置 PooledConnectionLifetime（如 2 分钟），以避免端口耗尽和 DNS 更新失效；高并发下禁用 using 声明。
怎么让变量在多个请求间复用且不报错
变量必须先定义、后引用，且命名只允许字母数字下划线——@api_host 可以，@api.host 或 @auth-token 会直接触发 Cannot resolve variable。定义位置决定作用域：顶部全局定义（文件开头）对全文件生效；### 块内定义仅对该块及之后的请求有效。
推荐写法：
@api_host = http://localhost:8000
@auth_token = abc123def456
<p>GET {{api_host}}/users
Authorization: Bearer {{auth_token}}</p><h3>@env prod</h3><p>@api_host = <a href="https://www.php.cn/link/710ba53b0d353329706ee1bedf4b9b39">https://www.php.cn/link/710ba53b0d353329706ee1bedf4b9b39</a>
GET {{api_host}}/status- 环境切换靠右上角下拉菜单，不是改变量名或删块
-
http-client.env.json必须放在项目根目录，字段名如"base_url"就得严格写成{{base_url}}，大小写和下划线都不能错 - 变量值为空时，请求根本不会发出去，控制台只显示“Variable 'xxx' is not defined”
POST JSON 请求为什么总卡在 400 或无响应
HTTP Client 对空行、缩进、JSON 合法性极其敏感。它不校验语义，只按字面解析格式——少一个空行、多一个空格、JSON key 没引号，就直接返回 400 或静默失败。
正确结构只有三段：请求行 → 空行 → Header → 空行 → Body（顶格）：
立即学习“PHP免费学习笔记（深入）”；
POST http://localhost:8000/api/users
Content-Type: application/json
<p>{"name": "Alice", "email": "alice@example.com"}- Body 必须顶格，不能有缩进，不能换行后空行
-
Content-Type: application/json这一行不能带前导空格，也不能写成content-type（大小写敏感） - 中文或特殊字符在 URL 参数里必须手动 URL 编码，比如
?q=%E4%BD%A0%E5%A5%BD，不能写?q=你好
调试 PHP 接口时断点不命中，XDEBUG_SESSION_START 够了吗
够了，但只是必要条件之一。光加 XDEBUG_SESSION_START: PHPSTORM 头，不代表 Xdebug 就真连上了——它还依赖 CLI 和 Web SAPI 的配置一致、xdebug.client_host 指向正确 IP、以及脚本实际被加载执行。
关键检查点：
- 运行
php -v确认 CLI 加载了 Xdebug；访问phpinfo()页面确认xdebug.mode=debug且xdebug.client_host是宿主机 IP（Docker 下别设成localhost） - 断点打在
index.php入口第一行，能停住才说明通道通；否则看xdebug.log里有没有Connection to client successfully established - 框架路由（如 Laravel）下，实际执行的是
public/index.php，你却在app/Http/Controllers/UserController.php打断点——得确保 PhpStorm 的路径映射已包含vendor和源码目录，否则断点位置错位
响应太大或含二进制内容时怎么避免卡死
HTTP Client 默认把整个响应体读入内存并尝试渲染，遇到大文件（如 Excel 导出流）、图片或未声明编码的中文，就会卡住或显示乱码。
两个实用办法：
- 加
Accept: text/plain头强制服务端返回纯文本，避免富格式干扰 - 对二进制响应（如
Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet），在请求末尾加> /tmp/export.xlsx直接保存到磁盘，不走渲染流程 - 响应里想快速查状态码或字段？用 JavaScript 断言：
GET https://www.php.cn/link/710ba53b0d353329706ee1bedf4b9b39/user > {% console.log(response.status, response.body.id) %}
最常被忽略的是路径——.http 文件必须在项目内，变量定义不能跨文件隐式继承，Xdebug 的 client_host 在 Docker 场景下几乎总是填错。这些地方一错，前面所有操作都白搭。
