php CURL介绍

封面图 • 2025-12-24 • PHP

PHP 中的 `cURL` 是一个非常强大的库，用于在 PHP 脚本中与各种服务器进行通信。它支持多种协议（如 HTTP、HTTPS、FTP、SMTP 等），可以发送 HTTP 请求（GET、POST、PUT、DELETE 等）、处理 cookies、设置 headers、上传文件等。

---

## 一、什么是 cURL？

cURL（Client URL）是一个开源工具和库，最初由 Daniel Stenberg 开发，现在由 cURL 项目维护。PHP 提供了对 cURL 的封装，使得开发者可以在 PHP 中轻松地使用 cURL 功能。

---

## 二、cURL 的主要功能

- 发送 HTTP 请求（GET、POST、PUT、DELETE 等）
- 设置请求头（Headers）
- 处理 Cookies
- 支持 HTTPS 和 SSL/TLS
- 上传/下载文件
- 代理服务器支持
- 超时设置
- 错误处理

---

## 三、PHP cURL 基本使用流程

```php
<?php
// 1. 初始化 cURL 会话
$ch = curl_init();

// 2. 设置选项
curl_setopt($ch, CURLOPT_URL, "https://example.com"); // 设置目标 URL
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); // 返回结果不直接输出
curl_setopt($ch, CURLOPT_HEADER, false); // 不包含响应头
curl_setopt($ch, CURLOPT_TIMEOUT, 10); // 设置超时时间（秒）

// 如果是 POST 请求，需要设置以下参数
// curl_setopt($ch, CURLOPT_POST, true);
// curl_setopt($ch, CURLOPT_POSTFIELDS, "key1=value1&key2=value2");

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

// 4. 检查是否成功
if ($response === false) {
    $error = curl_error($ch);
    echo "cURL Error: " . $error;
} else {
    echo "Response: " . $response;
}

// 5. 关闭会话
curl_close($ch);
?>
```

---

## 四、常见 cURL 选项说明

| 选项 | 说明 |
|------|------|
| `CURLOPT_URL` | 设置请求的 URL |
| `CURLOPT_RETURNTRANSFER` | 是否将结果返回为字符串（true/false） |
| `CURLOPT_HEADER` | 是否返回响应头（true/false） |
| `CURLOPT_POST` | 是否使用 POST 方法（true/false） |
| `CURLOPT_POSTFIELDS` | POST 数据（字符串或数组） |
| `CURLOPT_HTTPHEADER` | 设置自定义 HTTP 头（数组） |
| `CURLOPT_TIMEOUT` | 设置最大等待时间（秒） |
| `CURLOPT_SSL_VERIFYPEER` | 是否验证 SSL 证书（true/false） |
| `CURLOPT_FOLLOWLOCATION` | 是否跟随重定向（true/false） |

---

## 五、示例：发送 GET 请求

```php
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.example.com/data");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
echo $response;
?>
```

---

## 六、示例：发送 POST 请求

```php
<?php
$data = array("username" => "user1", "password" => "123456");

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://api.example.com/login");
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);

echo $response;
?>
```

---

## 七、示例：发送带 Headers 的请求

```php
<?php
$headers = array(
    'Content-Type: application/json',
    'Authorization: Bearer your_token_here'
);

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

echo $response;
?>
```

---

## 八、错误处理

```php
<?php
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, "https://invalid-url.com");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);

if ($response === false) {
    $error = curl_error($ch);
    echo "cURL Error: " . $error;
}

curl_close($ch);
?>
```

---

## 九、cURL 与 Guzzle 的区别

虽然 cURL 是 PHP 内置的函数库，但很多现代 PHP 项目使用 **Guzzle** 这个基于 cURL 的高级 HTTP 客户端库，它提供了更简洁、面向对象的 API，更适合大型项目。

---

## 十、总结

- cURL 是 PHP 中最常用的 HTTP 客户端库之一。
- 支持多种协议和方法，适合做 API 调用、数据抓取、接口测试等。
- 使用 `curl_init()`、`curl_setopt()`、`curl_exec()`、`curl_close()` 来控制请求流程。
- 推荐配合 `curl_error()` 和 `curl_errno()` 进行错误处理。

如果你有具体的使用场景（比如登录、上传文件、API 调用等），我可以提供更详细的代码示例。