PHP curl_setopt函数

封面图 • 2025-10-19 • PHP

`curl_setopt` 是 PHP 中用于设置 cURL 会话选项的函数，它是 cURL 扩展中非常重要的一个函数。通过这个函数，你可以配置请求的各种参数，如 URL、HTTP 方法、头信息、超时时间等。

---

## ✅ 基本语法：

```php
bool curl_setopt ( resource $ch, int $option, mixed $value )
```

- `$ch`：由 `curl_init()` 创建的 cURL 句柄。
- `$option`：要设置的选项常量（例如 `CURLOPT_URL`）。
- `$value`：该选项对应的值。

---

## 📌 常用选项示例：

| 选项 | 说明 |
|------|------|
| `CURLOPT_URL` | 设置请求的 URL |
| `CURLOPT_RETURNTRANSFER` | 设置是否将响应返回为字符串（而不是直接输出） |
| `CURLOPT_POST` | 设置是否使用 POST 方法 |
| `CURLOPT_POSTFIELDS` | 设置 POST 请求的数据 |
| `CURLOPT_HEADER` | 是否包含响应头 |
| `CURLOPT_TIMEOUT` | 设置最大等待时间（秒） |
| `CURLOPT_HTTPHEADER` | 设置自定义 HTTP 头 |
| `CURLOPT_USERAGENT` | 设置 User-Agent |
| `CURLOPT_FOLLOWLOCATION` | 跟随重定向 |
| `CURLOPT_SSL_VERIFYPEER` | 验证 SSL 证书（生产环境建议设为 true） |

---

## 💡 示例代码：

### 1. 发起 GET 请求：

```php
$ch = curl_init();

curl_setopt($ch, CURLOPT_URL, "https://example.com");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
```

---

### 2. 发起 POST 请求：

```php
$ch = curl_init();

$data = [
    'username' => 'test',
    'password' => '123456'
];

curl_setopt($ch, CURLOPT_URL, "https://example.com/login");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));

$response = curl_exec($ch);
curl_close($ch);

echo $response;
```

---

### 3. 自定义 HTTP 头：

```php
$ch = curl_init();

$headers = [
    'Authorization: Bearer YOUR_TOKEN',
    'Content-Type: application/json'
];

curl_setopt($ch, CURLOPT_URL, "https://api.example.com/data");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);

$response = curl_exec($ch);
curl_close($ch);

echo $response;
```

---

## ⚠️ 注意事项：

- 使用完 cURL 后务必调用 `curl_close($ch)` 来释放资源。
- 如果需要处理 HTTPS 请求，确保服务器支持 SSL，并且 `CURLOPT_SSL_VERIFYPEER` 设置为 `true`（生产环境推荐）。
- `CURLOPT_RETURNTRANSFER` 设置为 `true` 可以避免直接输出内容，便于后续处理。

---

## 🧠 小贴士：

你可以使用 `curl_getinfo()` 获取请求的信息（如 HTTP 状态码、响应时间等），例如：

```php
$http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
```

---

如果你有具体的使用场景或遇到问题，欢迎继续提问！