PHP发送HTTP请求的方法及完整代码教程

在PHP开发中，与外部API交互、抓取网页内容或微服务通信都离不开HTTP请求。虽然PHP本身不直接包含像Python requests那样的一体化高级库，但提供了多种底层和第三方工具来实现这一功能。选择哪种方式取决于服务器环境配置、项目复杂度以及对错误处理的需求。

PHP中三种主流HTTP请求方式的对比示意图

关于 cURL 扩展

cURL 是PHP中最强大且最常用的HTTP客户端工具。它支持多种协议，能够精细控制请求头、超时时间、SSL验证等参数。大多数现代PHP环境默认启用了cURL扩展。

使用 cURL 发送 GET 请求时，核心步骤是初始化句柄、设置选项、执行请求并关闭句柄。以下是一个标准的 GET 请求示例，用于获取API返回的JSON数据：

$url = "https://api.example.com/data";

// 初始化 cURL 会话
$ch = curl_init();

// 设置 URL
curl_setopt($ch, CURLOPT_URL, $url);

// 设置返回传输流而不是直接输出
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

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

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

// 检查是否有错误
if (curl_errno($ch)) {
    echo 'Error:' . curl_error($ch);
} else {
    // 处理响应
    $data = json_decode($response, true);
    print_r($data);
}

// 关闭 cURL 会话
curl_close($ch);

对于 POST 请求，需要额外设置 CURLOPT_POST 为 true，并通过 CURLOPT_POSTFIELDS 传递数据。如果发送的是 JSON 格式数据，还需手动设置 Content-Type 请求头：

$url = "https://api.example.com/submit";
$postData = json_encode(["name" => "Test", "value" => 123]);

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $postData);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Content-Length: ' . strlen($postData)
]);

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

cURL 的优势在于可控性强，适合需要处理复杂认证、文件上传或调试网络问题的场景。缺点是代码较为冗长，每次请求都需要编写较多的样板代码。

使用cURL发送POST请求的代码示例

关于 file_get_contents 函数

如果只需要进行简单的 GET 请求，且服务器允许开启 allow_url_fopen 配置，file_get_contents 是最简洁的方案。它将 URL 视为文件路径，直接返回内容字符串。

基本的 GET 请求只需一行代码：

$url = "https://api.example.com/data";
$response = file_get_contents($url);

if ($response === false) {
    echo "请求失败";
} else {
    $data = json_decode($response, true);
}

要发送 POST 请求或自定义请求头，必须结合 stream_context_create 创建上下文流。这种方式比 cURL 简单，但灵活性较低，错误处理也不如 cURL 详细：

$url = "https://api.example.com/submit";
$data = http_build_query(["name" => "Test", "value" => 123]);

$options = [
    'http' => [
        'header'  => "Content-type: application/x-www-form-urlencoded\r\n",
        'method'  => 'POST',
        'content' => $data,
        'timeout' => 10
    ]
];

$context  = stream_context_create($options);
$result = file_get_contents($url, false, $context);

if ($result === false) {
    echo "请求失败";
}

注意，许多生产环境出于安全考虑会禁用 allow_url_fopen，因此在使用此方法前需确认 php.ini 配置。它适合快速原型开发或内部可信网络的简单调用。

通过stream_context_create配置POST请求参数

关于 Guzzle HTTP 客户端

Guzzle 是一个流行的 PHP HTTP 客户端，它提供了优雅的接口来发送请求并管理响应。虽然它是第三方库，需要通过 Composer 安装，但在大型项目中能显著减少代码量并提高可维护性。

首先通过 Composer 安装：

composer require guzzlehttp/guzzle

使用 Guzzle 发送 GET 请求非常直观，它自动处理了底层的 cURL 细节，并提供了丰富的异常处理机制：

require 'vendor/autoload.php';

use GuzzleHttp\Client;

$client = new Client(['base_uri' => 'https://api.example.com']);

try {
    $response = $client->request('GET', '/data', [
        'timeout' => 10,
        'headers' => [
            'Accept' => 'application/json'
        ]
    ]);

    $body = $response->getBody();
    $data = json_decode($body, true);
    
    echo $response->getStatusCode(); // 获取状态码
} catch (\GuzzleHttp\Exception\RequestException $e) {
    echo $e->getMessage();
}

发送 POST 请求时，Guzzle 允许直接传递数组作为 JSON 主体，它会自动序列化并设置正确的头部：

$response = $client->request('POST', '/submit', [
    'json' => [
        'name' => 'Test',
        'value' => 123
    ]
]);

Guzzle 的主要优势在于其中间件系统、并发请求支持以及统一的异常处理。如果项目已经使用了 Laravel 或其他现代框架，Guzzle 往往是首选，因为许多框架底层也依赖它或与其兼容。

Guzzle处理请求与响应的抽象层级

方法选择建议

在实际开发中，选择哪种方式主要看项目约束。如果服务器环境受限且不能安装第三方库，cURL 是最可靠的备选，尽管代码稍显繁琐。如果只是偶尔调用一个简单的公开 API，且确认配置允许，file_get_contents 足够轻量。

对于长期维护的商业项目或需要频繁与多个 API 交互的系统，引入 Guzzle 能带来更好的开发体验和代码整洁度。无论选择哪种方式，都应注意设置合理的超时时间，避免外部服务延迟导致当前脚本挂起，同时务必对网络错误进行捕获和处理，保证程序的健壮性。

方法选择建议