PHP语言如何调用 API 接口获取和提交数据 PHP语言 API 接口调用的详细操作方法-php教程-PHP中文网

PHP语言如何调用 API 接口获取和提交数据 PHP语言 API 接口调用的详细操作方法

星夢妙者

发布： 2025-08-03 09:36:02

原创

192人浏览过

php调用api接口的核心是发送http请求并处理响应，主要步骤包括：1. 使用curl或guzzle等工具发送get或post请求，设置必要的请求头和数据格式；2. 对于get请求，初始化curl并获取返回数据，通过json_decode解析json响应；3. 对于post请求，设置curlopt_postfields和content-type头，发送json数据并处理响应；4. 错误处理时通过curl_getinfo获取http状态码，判断4xx或5xx错误，并解析返回体中的错误信息；5. 使用guzzle时需先通过composer安装，然后实例化client并调用request方法，结合try-catch捕获异常，区分处理客户端和服务端错误；6. 常见认证方式包括basic auth、api key、oauth 2.0和jwt，api key可通过url参数或请求头传递；7. 处理速率限制时需检查http状态码429，读取retry-after响应头，使用sleep暂停后重试。完整实现需结合文档规范，确保请求合法性与错误容错性。

PHP语言如何调用 API 接口获取和提交数据 PHP语言 API 接口调用的详细操作方法

PHP 调用 API 接口，核心在于发送 HTTP 请求，并处理返回的数据。选择合适的工具（如

curl

登录后复制

或

Guzzle

登录后复制

），设置请求头，处理认证，以及解析 JSON 或 XML 格式的响应，是关键步骤。

// 使用 cURL 发送 GET 请求
$url = 'https://api.example.com/users';
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);

if (curl_errno($ch)) {
    echo 'cURL error: ' . curl_error($ch);
} else {
    $data = json_decode($response, true); // 将 JSON 字符串解码为 PHP 数组
    // 处理 $data
    print_r($data);
}
curl_close($ch);

登录后复制

// 使用 cURL 发送 POST 请求
$url = 'https://api.example.com/users';
$data = array('name' => 'John Doe', 'email' => 'john.doe@example.com');
$data_string = json_encode($data);

$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_POSTFIELDS, $data_string);
curl_setopt($ch, CURLOPT_HTTPHEADER, array(
    'Content-Type: application/json',
    'Content-Length: ' . strlen($data_string))
);

$response = curl_exec($ch);

if (curl_errno($ch)) {
    echo 'cURL error: ' . curl_error($ch);
} else {
    $result = json_decode($response, true);
    // 处理 $result
    print_r($result);
}
curl_close($ch);

登录后复制

PHP 如何处理 API 接口返回的错误？

API 接口调用中，错误处理至关重要。首先，检查 HTTP 状态码。200 表示成功，4xx 表示客户端错误，5xx 表示服务器错误。

curl_getinfo()

登录后复制

函数可以获取状态码。然后，解析 API 返回的错误信息，通常包含在 JSON 或 XML 响应中。

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

$url = 'https://api.example.com/nonexistent_resource';
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
$http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);

if ($http_code >= 400) {
    echo "HTTP Error: " . $http_code . "\n";
    $error_data = json_decode($response, true);
    if (isset($error_data['message'])) {
        echo "Error Message: " . $error_data['message'] . "\n";
    } else {
        echo "Raw Response: " . $response . "\n";
    }
} else {
    $data = json_decode($response, true);
    print_r($data);
}
curl_close($ch);

登录后复制

如何使用 Guzzle HTTP 客户端进行 API 调用？

Guzzle 是一个流行的 PHP HTTP 客户端，提供了更简洁的 API。安装 Guzzle：

composer require guzzlehttp/guzzle

登录后复制

。

require 'vendor/autoload.php';

use GuzzleHttp\Client;

$client = new Client();
try {
    $response = $client->request('GET', 'https://api.example.com/users');
    $statusCode = $response->getStatusCode();
    $body = $response->getBody();
    $data = json_decode($body, true);
    print_r($data);

} catch (GuzzleHttp\Exception\GuzzleException $e) {
    echo "Guzzle Exception: " . $e->getMessage() . "\n";
    if ($e instanceof GuzzleHttp\Exception\ClientException) {
        $response = $e->getResponse();
        $statusCode = $response->getStatusCode();
        $errorBody = $response->getBody();
        echo "Status Code: " . $statusCode . "\n";
        echo "Error Body: " . $errorBody . "\n";
    }
}

登录后复制

API 接口的认证方式有哪些，如何在 PHP 中实现？

SpeakingPass-打造你的专属雅思口语语料

使用chatGPT帮你快速备考雅思口语，提升分数

查看详情

常见的 API 认证方式包括：

Basic Authentication: 使用用户名和密码，通过 HTTP Authorization 头传递。
API Key: 在请求头或 URL 参数中传递 API 密钥。
OAuth 2.0: 使用访问令牌，通常通过 Authorization 头传递。
JWT (JSON Web Token): 使用 JWT 令牌进行身份验证。

实现示例（API Key）：

$url = 'https://api.example.com/data';
$apiKey = 'YOUR_API_KEY';

$ch = curl_init($url . '?api_key=' . $apiKey); // API Key 作为 URL 参数
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);

if (curl_errno($ch)) {
    echo 'cURL error: ' . curl_error($ch);
} else {
    $data = json_decode($response, true);
    print_r($data);
}
curl_close($ch);

登录后复制

OAuth 2.0 的实现会更复杂，通常需要使用 OAuth 客户端库。

如何处理 API 接口的速率限制？

API 接口通常有速率限制，防止滥用。处理速率限制的关键是：

了解限制: 阅读 API 文档，了解速率限制的具体规则。
检查响应头: API 通常在响应头中返回剩余请求次数和重置时间。
实现重试机制: 当达到速率限制时，暂停一段时间后重试。

$url = 'https://api.example.com/data';
$ch = curl_init($url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);

if ($http_code == 429) { // 429 表示 Too Many Requests
    $retry_after = curl_getinfo($ch, CURLINFO_HTTP_HEADER, CURLINFO_HEADER_OUT); // 获取 Retry-After 头
    preg_match('/Retry-After: (\d+)/', $retry_after, $matches);
    $wait_seconds = (isset($matches[1])) ? intval($matches[1]) : 60; // 默认等待 60 秒

    echo "Rate limit exceeded. Waiting " . $wait_seconds . " seconds before retrying.\n";
    sleep($wait_seconds);
    // 重新调用 API
} else {
    $data = json_decode($response, true);
    print_r($data);
}
curl_close($ch);

登录后复制

这个例子展示了如何检查 HTTP 状态码 429 (Too Many Requests)，并根据