关于 bitrix-http-client
面向 Bitrix 开发者的 HttpClient 技能,说明 HTTP 请求、配置与安全处理方式,并强调大响应应流式下载及请求超时设置。
主要功能
- 01发送 GET、POST 和 JSON 请求
- 02处理 multipart 与异步请求
- 03配置默认选项和日志
- 04检查 SSRF 风险
- 05下载大响应到文件
适用场景
- 01通过 PSR-18 发起请求
- 02安全处理用户提供的 URL
- 03下载大型响应内容
安装
复制下面的命令,在终端中运行。
$
npx skills add https:/ / github.com/ bxmaximum/ bitrix-framework-skills --skill bitrix-http-client安装后在 Claude Code 中输入/bitrix-http-client确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
rules/config-security.mdgeoip.mdrequests.md详细介绍
HttpClient
基线版本:main 23.0+ · 已验证版本:main 26.800.0
| 任务 | 阅读 |
|---|---|
| GET/POST/JSON/下载、PSR-18 请求、multipart、异步 | rules/requests.md |
选项、全局默认值、日志记录、SSRF、CHTTP 替代方案 | rules/config-security.md |
| 根据 IP 查询国家/城市/时区 | rules/geoip.md |
不变量
- 仅使用
Bitrix\Main\Web\HttpClient;CHTTP和原始的curl_*/file_get_contents($url)仅用于兼容。 - 显式设置
socketTimeout和streamTimeout:默认值分别为 30 s 和 60 s。 - 对于来自用户、webhook 或导入的数据的 URL:设置
'privateIp' => false(默认值true会允许内部地址)。 - 解码前检查状态;旧版调用在传输错误时返回
false(getError()),PSR-18 则会抛出ClientException。 - 将大型响应体流式写入文件(
download()),不要将其保存在内存中。
评论
支持 Markdown