PHP CURL CURLOPT参数说明(curl_setopt)

封面图 • 2025-10-11 • PHP

在 PHP 中，`curl_setopt()` 是用于设置 cURL 会话选项的函数。它允许你配置请求的各种参数，如 URL、HTTP 方法、头信息、超时时间等。以下是一些常用的 `CURLOPT_` 参数及其说明：

---

## ✅ 常用 `CURLOPT_` 参数说明

| 参数名 | 说明 |
|--------|------|
| `CURLOPT_URL` | 设置要请求的 URL 地址（必填） |
| `CURLOPT_RETURNTRANSFER` | 如果设为 `true`，cURL 函数将返回响应内容而不是直接输出 |
| `CURLOPT_POST` | 设置为 `true` 表示使用 POST 方法发送数据 |
| `CURLOPT_POSTFIELDS` | 设置 POST 请求的数据（可以是字符串或数组） |
| `CURLOPT_HEADER` | 是否包含响应头（`true` 或 `false`） |
| `CURLOPT_HTTPHEADER` | 设置自定义 HTTP 头（例如：`array('Content-Type: application/json')`） |
| `CURLOPT_TIMEOUT` | 设置最大等待时间（秒） |
| `CURLOPT_CONNECTTIMEOUT` | 设置连接超时时间（秒） |
| `CURLOPT_SSL_VERIFYPEER` | 是否验证 SSL 证书（`false` 可禁用验证） |
| `CURLOPT_FOLLOWLOCATION` | 是否跟随重定向（`true`） |
| `CURLOPT_USERAGENT` | 设置用户代理（User-Agent） |
| `CURLOPT_COOKIE` | 设置 cookie 数据 |
| `CURLOPT_REFERER` | 设置 HTTP Referer 字段 |
| `CURLOPT_HTTPGET` | 设置为 `true` 表示使用 GET 方法（默认） |
| `CURLOPT_CUSTOMREQUEST` | 设置自定义的 HTTP 请求方法（如 PUT, DELETE 等） |
| `CURLOPT_WRITEFUNCTION` | 自定义写入响应数据的回调函数（需配合 `CURLOPT_WRITEDATA` 使用） |
| `CURLOPT_READFUNCTION` | 自定义读取请求数据的回调函数 |

---

## 🔁 示例代码

```php
<?php
$ch = curl_init();

// 设置 URL
curl_setopt($ch, CURLOPT_URL, "https://example.com");

// 返回响应内容而不是直接输出
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

// 设置 User-Agent
curl_setopt($ch, CURLOPT_USERAGENT, "Mozilla/5.0");

// 不验证 SSL 证书（不推荐生产环境使用）
curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);

// 设置超时时间（单位：秒）
curl_setopt($ch, CURLOPT_TIMEOUT, 10);

// 执行请求
$response = curl_exec($ch);

// 检查是否有错误
if ($response === false) {
    echo 'Curl error: ' . curl_error($ch);
} else {
    echo $response;
}

// 关闭句柄
curl_close($ch);
?>
```

---

## 📌 注意事项

- `CURLOPT_POSTFIELDS` 可以是字符串（如 `"name=John"`）或者数组（如 `array("name" => "John")`）。
- 对于 POST 请求，需要设置 `CURLOPT_POST` 为 `true`。
- 使用 HTTPS 时，如果遇到 SSL 验证问题，可以暂时关闭验证（但不推荐在生产环境中这么做）。

---

## 🧠 更多高级选项（可选）

| 参数名 | 说明 |
|--------|------|
| `CURLOPT_PROXY` | 设置代理服务器地址 |
| `CURLOPT_PROXYPORT` | 设置代理端口 |
| `CURLOPT_PROXYUSERPWD` | 设置代理认证用户名和密码 |
| `CURLOPT_REFERER` | 设置 HTTP Referer |
| `CURLOPT_MAXREDIRS` | 最大重定向次数 |
| `CURLOPT_FTP_USE_EPSV` | FTP 使用 EPSV 模式 |
| `CURLOPT_DNS_CACHE_TIMEOUT` | DNS 缓存超时时间（秒） |

---

如果你有具体的使用场景（如发送 JSON 数据、上传文件、处理 cookies 等），我可以提供更详细的示例和参数说明。