PHP 8 中 cURL 核心是用 CurlHandle 对象替代 resource，配合 curl_setopt() 设置参数、curl_exec() 发送请求；需设 CURLOPT_RETURNTRANSFER=true 获取返回值，注意超时、SSL 验证、协议限制及错误处理。
PHP 8 中用 cURL 请求接口，核心是使用 CurlHandle 对象替代旧版的 resource 类型，配合 curl_setopt() 设置请求参数，再用 curl_exec() 发送并获取响应。整个过程更类型安全、更清晰，也更符合现代 PHP 的设计风格。
基础 GET 请求（带错误处理）
这是最常用场景：获取远程数据。注意 PHP 8 要求显式检查返回值类型，并处理可能的 false。
- 调用
curl_init()返回CurlHandle实例，不再返回 resource - 必须设置
CURLOPT_RETURNTRANSFER => true，否则响应直接输出到标准输出 - 建议始终设置
CURLOPT_FOLLOWLOCATION => true和CURLOPT_SSL_VERIFYPEER => false（仅开发环境；生产环境应保留证书验证） - 执行后检查
curl_exec()是否返回 false，并用curl_error()获取失败原因
POST 请求（JSON 或表单数据）
向接口提交数据时，关键在于正确设置请求头和请求体。
CurlShip Directory Submission
下载
向CurlShip提交产品，这是一个对机器人友好的SaaS目录。只需一条curl命令即可发布产品，支持OG标签抓取、带徽章的dofollow链接及层级升级。
- 发送 JSON：设
CURLOPT_POSTFIELDS为json_encode($data)，并添加Content-Type: application/json - 发送表单：设
CURLOPT_POSTFIELDS为关联数组（cURL 自动编码为application/x-www-form-urlencoded） - 上传文件：用
CURLFile或CURLStringFile包装内容，避免直接传路径字符串 - 如需保留 Cookie 或复用连接，可搭配
curl_share_init_persistent()提升性能（尤其在高频请求场景）
获取完整响应信息（Header + Body + 状态码）
调试或签名验签时，常需原始响应头和状态码，不能只看 body。
立即学习“PHP免费学习笔记（深入）”；
- 启用
CURLOPT_HEADER => true可让响应体前附带响应头（需手动分离） - 更推荐方式：设
CURLOPT_HEADERFUNCTION回调函数，逐行捕获 header；同时用curl_getinfo($ch, CURLINFO_HTTP_CODE)获取状态码 - 用
curl_getinfo($ch)可拿到耗时、重定向次数、最终 URL 等调试关键字段
安全与健壮性要点
线上项目不能只关注“能通”，还要防异常、控超时、保兼容。
- 必须设置超时：
CURLOPT_TIMEOUT => 10（总超时），CURLOPT_CONNECTTIMEOUT => 3（连接超时） - 禁用危险选项：
CURLOPT_PROTOCOLS和CURLOPT_REDIR_PROTOCOLS限制协议为CURLPROTO_HTTP | CURLPROTO_HTTPS，防止 SSRF - PHP 8.4 要求 libcurl ≥ 7.61.0，部署前用
php -i | grep curl核对版本 - 敏感请求（如支付回调接收）建议关闭
CURLOPT_ENCODING，避免 gzip 解压异常导致验签失败
