直接用CodeIgniter\HTTP\CURLRequest类发POST请求，传数组自动处理表单，JSON需手动设头并调setBody()，用getRawBody()获取非JSON响应，配置存.env文件，调试开启debug选项。
CI4里怎么发一个最简POST请求？
直接用CodeIgniter\HTTP\CURLRequest类就行，不用自己封装cURL——CI4自带的这个类已经处理了重定向、超时、SSL验证、自动JSON解析等细节。它比裸cURL更安全、更可维护。
常见错误是手动拼接http_build_query()再塞进curl_setopt($ch, CURLOPT_POSTFIELDS, ...)，结果Content-Type没同步改，导致API返回400或空响应。
- 发送表单数据：传数组给
post()方法，它会自动设Content-Type: application/x-www-form-urlencoded并编码 - 发送JSON：先
json_encode($data)，再手动设setHeader('Content-Type', 'application/json')，然后传字符串给setBody() - 别漏掉
setHTTPClient(['timeout' => 10])，否则默认5秒超时太短，尤其调用微信/支付宝接口容易失败
为什么$response->getBody()返回空但状态码是200？
不是接口没返回，而是CI4默认把响应体当JSON解析了——如果API返回的是纯文本、XML或HTML，getBody()会尝试json_decode()失败后返回null。
解决办法是绕过自动解析，直接取原始内容：
- 用
$response->getRawBody()拿到未处理的原始字符串（推荐） - 或者初始化请求时加
->setOption('return_type', 'string')，强制不解析 - 检查
$response->getHeaderLine('Content-Type')确认实际返回类型，避免硬编码假设
在控制器里调第三方API，配置怎么管才不乱？
别把API地址、密钥写死在控制器里。CI4的.env文件就是干这事的——它比config文件更安全，且能随环境自动切换。
向CurlShip提交产品，这是一个对机器人友好的SaaS目录。只需一条curl命令即可发布产品，支持OG标签抓取、带徽章的dofollow链接及层级升级。
示例：.env里写：
API_PAYMENT_URL = "https://api.pay.example.com/v1" API_PAYMENT_KEY = "sk_test_abc123"
控制器中用env('API_PAYMENT_URL')和env('API_PAYMENT_KEY')读取。注意：env()只在development或testing环境下生效；生产环境需确保Web服务器已设置对应系统环境变量。
- 密钥类配置项绝不能放进Git——
.env必须在.gitignore里 - 不要用
$this->config->item()读.env值，那是CI3的老方式，CI4已废弃 - 如果多个API共用一套认证逻辑，抽成
app/Services/PaymentApiClient.php，构造函数里注入env()值，比到处写env()更易测试
cURL超时或连接被拒绝，怎么快速定位？
CI4的CURLRequest默认不抛异常，$response->isOK()为false时，得看$response->getReason()和$response->getStatusCode()才能知道是DNS失败、连接超时还是对方返回了503。
调试建议：
- 加
->setOption('debug', true)，输出完整cURL日志到writable/logs/（需确保目录可写） - 本地测试时用
curl -v https://api.example.com对比，排除CI4层干扰 - 如果报
Connection refused，先确认allow_url_fopen和curl扩展已启用（php -m | grep curl） - 内网调用时注意CI4默认禁用
gopher://等协议，若需支持得显式配置setOption('allowed_redirects', ['http', 'https'])
CI4的HTTP客户端封装得很稳，但“稳”的前提是别跳过.env配置、别忽略getRawBody()和debug选项——这些点不处理，问题就卡在看不见的地方。
