在现代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免费学习笔记（深入）”；
$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
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();
}
处理常见问题与安全建议
在实际调用API时，注意以下几点可提升稳定性和安全性：
- 始终验证API返回的状态码，避免只依赖响应内容
- 使用
json_decode()后检查是否为null，防止解析失败 - 敏感信息（如token）不要硬编码，应从配置文件或环境变量读取
- 启用SSL验证（cURL默认开启），避免中间人攻击
- 设置超时时间，防止请求长时间挂起：
curl_setopt($ch, CURLOPT_TIMEOUT, 30); - 生产环境捕获异常，避免泄露调试信息
