bitrix-http-client

HttpClient

ベースライン：main 23.0+・検証済み：main 26.800.0

タスク	参照先
GET/POST/JSON/ダウンロード、PSR-18 リクエスト、マルチパート、非同期	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 秒と 60 秒です。
• ユーザー、Webhook、インポートから取得した URL には、'privateIp' => false を設定します（デフォルトの true では内部アドレスへのアクセスが許可されます）。
• デコードする前にステータスを確認します。レガシー呼び出しでは、トランスポートエラー時に false が返され（getError()）、PSR-18 では ClientException がスローされます。
• 大きなボディはファイルにストリーミングします（download()）。メモリに保持しないでください。