SuperAPI AI 工具集

bitrix-http-client

编程与开发

查看项目

更新于 10-16 00:24

技能介绍

用途:该技能包介绍 Bitrix 框架中的 Bitrix\Main\Web\HttpClient,用于发起 HTTP 请求,包括 GET/POST/JSON 与文件下载、PSR-18 的 sendRequest、multipart 及异步请求,也涉及通过 IP 查询国家/城市/时区。资料基线为 main 23.0+,已验证 main 26.800.0。

主要能力与组织:rules/requests.md 覆盖 GET/POST/JSON/download、PSR-18 请求、multipart 与异步;rules/config-security.md 覆盖选项、全局默认、日志、SSRF 防护与 CHTTP 迁移;rules/geoip.md 覆盖按 IP 查询国家/城市/时区。

必要用法与约束:只使用 Bitrix\Main\Web\HttpClient;CHTTP 以及裸用 curl_* 或 file_get_contents($url) 仅供兼容用途。需显式设置 socketTimeout 与 streamTimeout,默认分别为 30 秒与 60 秒。对于来自用户、webhook 或导入的 URL,应设 'privateIp' => false,因为默认 true 会允许内网地址。解码前先检查状态:旧式调用在传输错误时返回 false(可通过 getError() 获取错误),PSR-18 会抛出 ClientException。大响应体应通过 download() 流式写入文件,不要在内存中保存。

适用场景:在 Bitrix 项目中替代 CHTTP 与直接 curl/file_get_contents,统一处理同步、异步、多部分上传与下载请求,并配合超时、SSRF 与日志策略使用。

限制:资料未提供具体安装命令、完整代码示例、价格或平台差异信息,暂未提供。