PHP如何发送HTTP请求_PHP发送HTTP请求方法与代码解析-php教程-PHP中文网

PHP发送HTTP请求的核心方法包括file_get_contents()、cURL扩展和Guzzle库。file_get_contents()适用于简单GET请求，代码简洁但功能有限；cURL支持各类HTTP方法、自定义头部及详细错误处理，适合复杂场景；Guzzle基于PSR-7标准，提供优雅的面向对象API，支持同步异步请求与中间件，是现代PHP项目的首选方案。

php如何发送http请求_php发送http请求方法与代码解析

PHP发送HTTP请求，核心方法主要围绕着file_get_contents()、cURL扩展，以及更现代、更强大的HTTP客户端库，比如Guzzle。选择哪种方式，往往取决于你的项目需求、对性能和灵活性的考量，以及你对代码可维护性的偏好。

解决方案

在PHP中发起HTTP请求，其实就是让你的PHP脚本像一个浏览器一样，向远程服务器发出数据请求并接收响应。这听起来简单，但实际操作起来，根据具体场景，选择合适的工具和策略至关重要。

1. file_get_contents()：快速但有限

这是最简单、最直接的方式，适合处理一些轻量级的GET请求。

立即学习“PHP免费学习笔记（深入）”；

<?php
// 发送GET请求
$response = file_get_contents('https://api.example.com/data');

if ($response === false) {
    // 处理错误，例如网络不通或服务器无响应
    echo "请求失败: " . error_get_last()['message'];
} else {
    echo "GET响应:\n" . $response;
}

// 发送POST请求（需要上下文流）
$postData = http_build_query([
    'param1' => 'value1',
    'param2' => 'value2',
]);

$options = [
    'http' => [
        'method'  => 'POST',
        'header'  => 'Content-type: application/x-www-form-urlencoded',
        'content' => $postData,
        'timeout' => 5, // 5秒超时
    ],
];
$context  = stream_context_create($options);
$response = file_get_contents('https://api.example.com/submit', false, $context);

if ($response === false) {
    echo "POST请求失败: " . error_get_last()['message'];
} else {
    echo "POST响应:\n" . $response;
}
?>

登录后复制

个人看法： file_get_contents() 的优点是不用引入额外库，代码简洁。但它在处理复杂请求（如自定义头部、认证、文件上传、错误详细信息）时显得力不从心，尤其是超时控制和错误报告，有时候会让人抓狂。对于生产环境，我个人很少直接用它来做关键的API交互。

2. cURL：PHP的瑞士军刀

cURL是PHP内置的一个强大扩展，几乎可以处理所有你能想到的HTTP请求场景。它提供了细粒度的控制，但代价是代码量会相对多一些。

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

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

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

// 设置GET请求的例子
// curl_setopt($ch, CURLOPT_HTTPGET, true); // 默认就是GET

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

// 禁用SSL证书验证（在开发环境可能需要，生产环境强烈不建议）
// curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
// curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);

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

// 检查是否有错误发生
if (curl_errno($ch)) {
    echo 'cURL错误: ' . curl_error($ch);
} else {
    echo "GET响应:\n" . $response;
    // 获取HTTP状态码
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    echo "\nHTTP状态码: " . $httpCode;
}

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

// --- POST请求示例 ---
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.example.com/post_data');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POST, true); // 设置为POST请求
curl_setopt($ch, CURLOPT_POSTFIELDS, [ // POST数据
    'key1' => 'valueA',
    'key2' => 'valueB',
]);
// 或者发送JSON数据
/*
$jsonData = json_encode(['key1' => 'valueA', 'key2' => 'valueB']);
curl_setopt($ch, CURLOPT_POSTFIELDS, $jsonData);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Content-Length: ' . strlen($jsonData),
]);
*/
curl_setopt($ch, CURLOPT_TIMEOUT, 10);
$response = curl_exec($ch);

if (curl_errno($ch)) {
    echo 'cURL POST错误: ' . curl_error($ch);
} else {
    echo "POST响应:\n" . $response;
}
curl_close($ch);
?>

登录后复制

个人看法： cURL是我的主力工具，尤其是在没有Composer的项目里。它虽然配置项繁多，但一旦熟悉了，就能灵活应对各种场景。从HTTP代理到文件上传，再到复杂的认证机制，cURL都能胜任。不过，它的API风格确实有点“老派”，参数都是常量，对于初学者来说可能有点陡峭的学习曲线。

3. Guzzle HTTP Client：现代PHP的优雅选择

Guzzle是一个流行的PHP HTTP客户端库，通过Composer安装。它基于PSR-7（HTTP消息接口），提供了简洁、现代的API，支持同步和异步请求，以及中间件等高级功能。

首先，通过Composer安装Guzzle： composer require guzzlehttp/guzzle

<?php
require 'vendor/autoload.php'; // 引入Composer自动加载文件

use GuzzleHttp\Client;
use GuzzleHttp\Exception\RequestException; // 引入Guzzle的异常类

$client = new Client([
    'base_uri' => 'https://api.example.com/', // 定义基础URL
    'timeout'  => 5.0, // 全局超时设置
]);

try {
    // GET请求
    $response = $client->request('GET', 'get_info', [
        'query' => ['param' => 'test'] // GET参数
    ]);
    echo "Guzzle GET响应状态码: " . $response->getStatusCode() . "\n";
    echo "Guzzle GET响应体:\n" . $response->getBody()->getContents();

    // POST请求 (表单数据)
    $response = $client->post('post_data', [
        'form_params' => [ // 表单数据
            'key1' => 'valueA',
            'key2' => 'valueB',
        ],
        'headers' => [ // 自定义头部
            'X-Custom-Header' => 'MyValue',
        ],
    ]);
    echo "\nGuzzle POST响应状态码: " . $response->getStatusCode() . "\n";
    echo "Guzzle POST响应体:\n" . $response->getBody()->getContents();

    // POST请求 (JSON数据)
    $response = $client->post('json_data', [
        'json' => [ // JSON数据
            'item1' => 'data1',
            'item2' => 'data2',
        ],
    ]);
    echo "\nGuzzle JSON POST响应状态码: " . $response->getStatusCode() . "\n";
    echo "Guzzle JSON POST响应体:\n" . $response->getBody()->getContents();

} catch (RequestException $e) {
    // 处理请求异常 (连接错误、HTTP错误等)
    echo "Guzzle请求错误: " . $e->getMessage() . "\n";
    if ($e->hasResponse()) {
        echo "响应状态码: " . $e->getResponse()->getStatusCode() . "\n";
        echo "响应体: " . $e->getResponse()->getBody()->getContents() . "\n";
    }
} catch (Exception $e) {
    // 其他未知异常
    echo "未知错误: " . $e->getMessage() . "\n";
}
?>

登录后复制

个人看法： 在现代PHP项目里，Guzzle几乎是发送HTTP请求的首选。它的API设计直观，错误处理机制完善，并且支持PSR-7标准，与其他PHP组件的兼容性很好。对于需要高可维护性、复杂交互或异步请求的场景，Guzzle能大大提升开发效率和代码质量。

代码小浣熊

代码小浣熊是基于商汤大语言模型的软件智能研发助手，覆盖软件需求分析、架构设计、代码编写、软件测试等环节

查看详情

PHP发送HTTP请求时，如何优雅地处理超时与错误？

处理HTTP请求中的超时和错误，是构建健壮应用的关键环节。毕竟，网络不是永远可靠，远程服务也可能随时“掉链子”。

首先，要明确超时和错误是两回事。超时是指在设定的时间内，客户端未能从服务器接收到响应。这可能是网络延迟、服务器过载或请求被阻塞导致的。错误则更广，包括HTTP状态码错误（如404、500）、连接失败、DNS解析失败等。

file_get_contents() 的处理方式： 它在请求失败时会返回false。你需要手动检查返回值，并通过error_get_last()来获取最近的错误信息。超时可以通过stream_context_create中的timeout选项设置。说实话，这种方式的错误信息通常比较笼统，不便于精确定位问题。

$options = [
    'http' => [
        'timeout' => 5, // 设置5秒超时
    ],
];
$context  = stream_context_create($options);
$response = @file_get_contents('http://nonexistent.url/data', false, $context); // 使用@抑制警告

if ($response === false) {
    $error = error_get_last();
    echo "请求失败: " . ($error ? $error['message'] : '未知错误');
} else {
    // 处理响应
}

登录后复制

这种方式，我个人觉得不够“优雅”，因为它依赖全局的error_get_last()，而且错误信息解析起来不如其他方式直观。

cURL 的处理方式： cURL提供了非常详细的错误报告机制。

超时设置： CURLOPT_TIMEOUT 用于设置整个请求的超时时间（包括连接和数据传输），CURLOPT_CONNECTTIMEOUT 专门用于设置连接建立的超时时间。这两个通常会一起使用，以避免长时间卡在连接阶段。
错误检查： 在curl_exec()之后，通过curl_errno()检查是否有错误码，如果返回非零值，则表示有错误发生。curl_error()则会返回具体的错误描述字符串。

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'http://nonexistent.url/data');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 10); // 总超时10秒
curl_setopt($ch, CURLOPT_CONNECTTIMEOUT, 5); // 连接超时5秒

$response = curl_exec($ch);

if (curl_errno($ch)) {
    $errorCode = curl_errno($ch);
    $errorMessage = curl_error($ch);
    echo "cURL请求错误 [{$errorCode}]: {$errorMessage}\n";
    // 根据错误码进行更细致的处理，例如：
    if ($errorCode == CURLE_OPERATION_TIMEDOUT) {
        echo "请求超时了！\n";
    }
} else {
    $httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
    if ($httpCode >= 400) {
        echo "HTTP错误状态码: {$httpCode}\n";
        echo "响应体: {$response}\n";
    } else {
        echo "请求成功，响应: {$response}\n";
    }
}
curl_close($ch);

登录后复制

cURL的错误处理能力强大，能让你更精确地诊断问题。在生产环境，我会结合HTTP状态码和cURL错误码来判断请求结果。

Guzzle 的处理方式： Guzzle将错误处理提升到了异常的层面，这使得代码更加清晰和面向对象。

超时设置： 在Client构造函数或request()方法的选项中，通过'timeout'键设置。
异常捕获： Guzzle会在遇到网络错误、连接超时或HTTP状态码表示错误（默认是4xx和5xx）时抛出GuzzleHttp\Exception\RequestException或其子类。你可以使用try...catch块来捕获并处理这些异常。

use GuzzleHttp\Client;
use GuzzleHttp\Exception\ConnectException; // 连接超时或网络问题
use GuzzleHttp\Exception\RequestException; // HTTP请求错误 (4xx, 5xx)

$client = new Client(['timeout' => 5]); // 全局5秒超时

try {
    $response = $client->get('http://nonexistent.url/data');
    echo "请求成功: " . $response->getBody()->getContents();
} catch (ConnectException $e) {
    echo "连接或网络错误: " . $e->getMessage() . "\n";
} catch (RequestException $e) {
    echo "HTTP请求错误: " . $e->getMessage() . "\n";
    if ($e->hasResponse()) {
        echo "响应状态码: " . $e->getResponse()->getStatusCode() . "\n";
        echo "响应体: " . $e->getResponse()->getBody()->getContents() . "\n";
    }
} catch (Exception $e) {
    echo "未知错误: " . $e->getMessage() . "\n";
}

登录后复制

这种基于异常的机制，我觉得是最优雅的。它强制你思考并处理各种潜在的失败情况，让你的业务逻辑和错误处理逻辑分离，代码可读性也更好。

除了GET和POST，PHP还能发送哪些类型的HTTP请求，并携带自定义头部？

HTTP协议定义了多种请求方法（或谓词），不仅仅是GET和POST。这些方法各有其语义，用于指示对资源的不同操作。在构建RESTful API时，正确使用这些方法至关重要。

常见的HTTP请求方法：

GET： 从服务器获取资源。幂等且安全（不改变服务器状态）。
POST： 向服务器提交数据，通常用于创建新资源。非幂等。
PUT： 更新或创建资源。如果资源已存在，则完全替换；如果不存在，则创建。幂等。
DELETE： 删除指定资源。幂等。
PATCH： 对资源进行部分修改。非幂等。
HEAD： 请求与GET请求相同的响应头，但不返回响应体。用于获取资源元数据。
OPTIONS： 描述目标资源支持的通信选项。

发送这些请求并携带自定义头部：

1. file_get_contents()： 虽然不推荐用于复杂场景，但它确实可以通过stream_context_create来发送这些请求和自定义头部。

$data = json_encode(['name' => 'New Item']);
$options = [
    'http' => [
        'method'  => 'PUT', // 修改请求方法
        'header'  => [
            'Content-type: application/json',
            'X-Auth-Token: your_token_here', // 自定义头部
        ],
        'content' => $data,
        'timeout' => 5,
    ],
];
$context  = stream_context_create($options);
$response = file_get_contents('https://api.example.com/items/123', false, $context);
// ... 错误处理

登录后复制

这种方式，尤其是处理头部数组，看起来有点啰嗦。

2. cURL： cURL是发送各种HTTP方法和自定义头部的“万金油”。

自定义请求方法： 使用CURLOPT_CUSTOMREQUEST选项。
自定义头部： 使用CURLOPT_HTTPHEADER选项，传入一个数组，每个元素是一个"Header-Name: Value"格式的字符串。

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, 'https://api.example.com/items/123');
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

// 发送PUT请求
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, 'PUT');
$putData = json_encode(['name' => 'Updated Item']);
curl_setopt($ch, CURLOPT_POSTFIELDS, $putData);

// 设置自定义头部
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Content-Type: application/json',
    'Content-Length: ' . strlen($putData),
    'X-Auth-Token: your_token_here',
    'Accept: application/json', // 期望接收JSON响应
]);

$response = curl_exec($ch);
// ... 错误处理
curl_close($ch);

登录后复制

cURL的灵活性在这里体现得淋漓尽致，几乎所有HTTP特性都能通过curl_setopt来配置。

3. Guzzle HTTP Client： Guzzle的设计就考虑了RESTful API的需求，发送不同方法和自定义头部非常直观。

请求方法： Client对象直接提供了get(), post(), put(), delete(), patch(), head(), options()等方法。
自定义头部： 在请求方法的第二个参数（选项数组）中，使用'headers'键，传入一个关联数组。

use GuzzleHttp\Client;

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

try {
    // 发送PUT请求并携带自定义头部
    $response = $client->put('items/123', [
        'json' => ['name' => 'Updated Item via Guzzle'], // Guzzle会自动设置Content-Type: application/json
        'headers' => [
            'X-Auth-Token' => 'guzzle_token_123',
            'Accept'       => 'application/json',
        ],
    ]);
    echo "PUT响应状态码: " . $response->getStatusCode() . "\n";
    echo "PUT响应体: " . $response->getBody()->getContents() . "\n";

    // 发送DELETE请求
    $response = $client->delete('items/456', [
        'headers' => [
            'Authorization' => 'Bearer some_jwt_token',
        ],
    ]);
    echo "\nDELETE响应状态码: " . $response->getStatusCode() . "\n";

} catch (GuzzleHttp\Exception\RequestException $e) {
    echo "Guzzle请求错误: " . $e->getMessage() . "\n";
}

登录后复制

Guzzle的API设计非常符合现代开发习惯，使得发送复杂请求变得简单。我个人在开发RESTful API客户端

以上就是PHP如何发送HTTP请求_PHP发送HTTP请求方法与代码解析的详细内容，更多请关注php中文网其它相关文章！