php调用RESTful API的实例_php调用Web服务的详细指南-php教程-PHP中文网

php调用RESTful API的实例_php调用Web服务的详细指南

星夢妙者

发布： 2025-11-16 08:00:08

原创

408人浏览过

php调用restful api的实例_php调用web服务的详细指南

在现代Web开发中，PHP调用RESTful API是非常常见的需求。无论是对接第三方服务（如微信、支付宝、阿里云），还是与前后端分离的后端API通信，掌握如何用PHP发起HTTP请求并处理响应至关重要。本文提供一个实用、清晰的指南，帮助你快速上手PHP调用RESTful API的方法。

使用cURL发送REST请求

cURL是PHP中最常用且功能强大的工具，用于发送HTTP请求。以下是一个完整的示例，展示如何使用cURL调用GET和POST类型的RESTful接口。

GET 请求示例：获取用户信息

假设我们要从 https://api.example.com/users/123 获取用户数据：

$ch = curl_init();
$url = "https://api.example.com/users/123";

curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer your-access-token',
    'Content-Type: application/json'
]);

$response = curl_exec($ch);

if (curl_error($ch)) {
    die("请求出错: " . curl_error($ch));
}

$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

$data = json_decode($response, true);

if ($httpCode === 200) {
    echo "用户姓名: " . $data['name'];
} else {
    echo "请求失败，状态码: " . $httpCode;
}

登录后复制

POST 请求示例：创建新用户

向API提交JSON格式的数据创建用户：

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

AppMall应用商店

AI应用商店，提供即时交付、按需付费的人工智能应用服务

查看详情

$ch = curl_init();
$url = "https://api.example.com/users";
$data = [
    'name' => '张三',
    'email' => 'zhangsan@example.com'
];

$jsonData = json_encode($data);

curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, $jsonData);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_HTTPHEADER, [
    'Authorization: Bearer your-access-token',
    'Content-Type: application/json'
]);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

if ($httpCode === 201) {
    echo "用户创建成功";
} else {
    echo "创建失败，状态码: " . $httpCode;
}

登录后复制

使用Guzzle HTTP客户端（推荐）

虽然cURL原生支持强大，但代码较冗长。推荐使用Guzzle，它是PHP中最受欢迎的HTTP客户端，语法简洁，易于维护。

安装Guzzle

通过Composer安装：

composer require guzzlehttp/guzzle

GET 请求示例

require 'vendor/autoload.php';

use GuzzleHttp\Client;

$client = new Client();

try {
    $response = $client->request('GET', 'https://api.example.com/users/123', [
        'headers' => [
            'Authorization' => 'Bearer your-access-token',
            'Content-Type'  => 'application/json'
        ]
    ]);

    $body = $response->getBody();
    $data = json_decode($body, true);

    echo "用户名: " . $data['name'];
} catch (\Exception $e) {
    echo "请求失败: " . $e->getMessage();
}

登录后复制

POST 请求示例

try {
    $response = $client->request('POST', 'https://api.example.com/users', [
        'json' => [
            'name'  => '李四',
            'email' => 'lisi@example.com'
        ],
        'headers' => [
            'Authorization' => 'Bearer your-access-token'
        ]
    ]);

    if ($response->getStatusCode() == 201) {
        echo "用户创建成功";
    }
} catch (\Exception $e) {
    echo "错误: " . $e->getMessage();
}

登录后复制