答案：PHP构建API需处理路由、请求解析、业务逻辑及JSON响应，调用第三方API则通过cURL或Guzzle发送HTTP请求并解析返回数据。
在PHP中构建API接口，核心在于接收HTTP请求、处理业务逻辑并返回结构化数据（通常是JSON）。而调用第三方API，则是向外部服务发送HTTP请求，并解析其返回的数据。无论是作为服务提供者还是消费者，理解HTTP协议、请求/响应格式以及数据序列化/反序列化是关键。
坦白说，PHP写接口和调用第三方API，本质上都是围绕HTTP协议做文章。
编写PHP接口（作为服务提供者）
当我们说“写接口”，通常指的是构建一个对外提供服务的API。这需要我们：
立即学习“PHP免费学习笔记（深入）”；
路由与请求解析： 你的PHP应用需要知道哪个URL对应哪个处理逻辑。简单的可以用index.php通过$_SERVER['REQUEST_URI']和$_SERVER['REQUEST_METHOD']来判断。更专业的，会用框架（如Laravel、Symfony、Yii）的路由功能，或者自己实现一个简单的路由器。
// 简单路由示例
$requestUri = explode('/', trim($_SERVER['REQUEST_URI'], '/'));
$method = $_SERVER['REQUEST_METHOD'];
if ($requestUri[0] === 'api' && $requestUri[1] === 'users' && $method === 'GET') {
// 处理获取用户列表的逻辑
header('Content-Type: application/json');
echo json_encode(['status' => 'success', 'data' => ['user1', 'user2']]);
exit;
}
// ... 其他接口逻辑获取请求数据：
$_GET获取。application/x-www-form-urlencoded 或 multipart/form-data：通过$_POST获取。application/json 或其他非表单数据：需要从php://input流中读取原始请求体。if ($method === 'POST' && $_SERVER['CONTENT_TYPE'] === 'application/json') {
$input = file_get_contents('php://input');
$data = json_decode($input, true); // true表示解码成关联数组
// 处理 $data
}业务逻辑处理： 这是接口的核心，根据请求数据执行相应的操作，比如查询数据库、更新记录等。
构建并返回响应：
Content-Type头：告诉客户端返回的数据格式。header('Content-Type: application/json');是最常见的。http_response_code(200);
echo json_encode(['status' => 'success', 'message' => '操作成功']);
通过PHP实现第三方API调用（作为服务消费者）
调用外部API，意味着我们的PHP应用充当客户端，向另一个服务发送请求。
选择HTTP客户端：
file_get_contents： 对于简单的GET请求，配合stream context也能用，但功能有限，不推荐用于复杂的API交互。构建请求：
Authorization（认证信息）、Content-Type（请求体类型）、User-Agent等。发送请求并处理响应：
Content-Type等。json_decode。cURL 调用示例：
$url = 'https://api.example.com/data';
$data = ['param1' => 'value1', 'param2' => 'value2'];
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); // 返回响应内容而不是直接输出
curl_setopt($ch, CURLOPT_POST, true); // POST请求
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data)); // 发送JSON数据
curl_setopt($ch, CURLOPT_HTTPHEADER, [
'Content-Type: application/json',
'Authorization: Bearer YOUR_API_TOKEN' // 认证头
]);
curl_setopt($ch, CURLOPT_TIMEOUT, 10); // 设置超时时间为10秒
$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE); // 获取HTTP状态码
if (curl_errno($ch)) {
$error = curl_error($ch);
// 处理cURL错误
error_log("cURL error: " . $error);
} else {
if ($httpCode >= 200 && $httpCode < 300) {
$responseData = json_decode($response, true);
// 处理成功响应
print_r($responseData);
} else {
// 处理API业务错误或HTTP错误
error_log("API call failed with HTTP code: " . $httpCode . ", response: " . $response);
}
}
curl_close($ch);Guzzle 调用示例（需要Composer安装 guzzlehttp/guzzle）：
require 'vendor/autoload.php';
use GuzzleHttp\Client;
use GuzzleHttp\Exception\RequestException;
$client = new Client();
$url = 'https://api.example.com/data';
$data = ['param1' => 'value1', 'param2' => 'value2'];
try {
$response = $client->post($url, [
'headers' => [
'Content-Type' => 'application/json',
'Authorization' => 'Bearer YOUR_API_TOKEN'
],
'json' => $data, // Guzzle会自动处理json编码
'timeout' => 10, // 设置超时时间
]);
$statusCode = $response->getStatusCode();
if ($statusCode >= 200 && $statusCode < 300) {
$responseData = json_decode($response->getBody()->getContents(), true);
print_r($responseData);
} else {
// Guzzle通常会在非2xx响应时抛出异常，但这里作为补充
error_log("API call failed with HTTP code: " . $statusCode . ", response: " . $response->getBody());
}
} catch (RequestException $e) {
// 处理网络错误、超时或非2xx响应
error_log("Guzzle request failed: " . $e->getMessage());
if ($e->hasResponse()) {
error_log("Response: " . $e->getResponse()->getBody()->getContents());
}
}在构建PHP API时，安全性绝不是一个可以忽视的环节。这就像你盖房子，如果地基不稳，再漂亮的装修也白搭。我个人觉得，以下几点是无论如何都得考虑的：
认证 (Authentication)： 你的API怎么知道是谁在访问？
授权 (Authorization)： 知道是谁在访问后，他/她/它能做什么？
输入验证与过滤： 这是防止各种注入攻击（SQL注入、XSS、命令注入）的基石。
php://input，甚至HTTP头，都必须严格验证和过滤。HTTPS (SSL/TLS)： 确保所有API通信都通过HTTPS进行。这能有效防止数据在传输过程中被窃听或篡改。如果你还在用HTTP提供API，那简直是“裸奔”。
限流 (Rate Limiting)： 防止恶意请求、DDoS攻击或滥用。
429 Too Many Requests。错误处理与日志：
CORS (Cross-Origin Resource Sharing)： 如果你的API需要被浏览器端的JavaScript调用（跨域），你需要正确配置CORS头。否则，浏览器会因为同源策略而阻止请求。
// 简单的CORS配置（生产环境应更严格，限制特定域名）
header("Access-Control-Allow-Origin: *"); // 允许所有来源，生产环境应指定域名
header("Access-Control-Allow-Methods: GET, POST, PUT, DELETE, OPTIONS");
header("Access-Control-Allow-Headers: Content-Type, Authorization");
if ($_SERVER['REQUEST_METHOD'] == 'OPTIONS') {
exit(0);
}调用第三方API，就像是把一部分控制权交给了别人。网络环境复杂多变，外部服务也可能不稳定。所以，处理这些不确定性，是保证我们应用健壮性的关键。我个人在做这块的时候，常常会考虑以下几个方面：
设置合理的超时时间： 这是最基本也是最重要的。一个无限等待的请求，可能拖垮你的整个应用。
CURLOPT_CONNECTTIMEOUT 和 CURLOPT_TIMEOUT。'connect_timeout' 和 'timeout' 选项。
设置超时时间要根据实际业务场景来定，太短可能导致正常请求失败，太长则可能影响用户体验和系统资源。实现重试机制 (Retry Mechanism)： 很多时候，一次API调用失败只是暂时的网络抖动或服务瞬时负载过高。
熔断器模式 (Circuit Breaker Pattern)： 想象一下电路中的保险丝。当外部服务持续出现故障时，熔断器会“跳闸”，阻止你的应用继续向该服务发送请求，直接返回错误，而不是让请求堆积导致自身也崩溃。
详细的错误日志： 当API调用失败时，我们需要知道原因。
cURL错误码或Guzzle异常信息。优雅降级与用户体验：
异步调用 (Asynchronous Calls)： 对于一些不那么实时、耗时较长的API调用，可以考虑将其放入消息队列，由后台工作进程异步处理。这样可以避免阻塞用户请求，提高响应速度。PHP结合消息队列（如RabbitMQ、Redis队列）和Supervisor/Swoole等工具可以实现。
cURL确实是PHP的“瑞士军刀”，功能强大，但它原生的API用起来确实有点繁琐，需要大量的curl_setopt。庆幸的是，PHP社区非常活跃，现在我们有很多更现代化、更优雅的选择，大大提升了开发效率和代码可读性。
Guzzle HTTP Client：
promise）。Symfony HTTP Client：
file_get_contents + Stream Contexts：
file_get_contents加上stream contexts（stream_context_create）可以实现。$options = [
'http' => [
'method' => 'POST',
'header' => 'Content-type: application/json' . "\r\n" .
'Authorization: Bearer YOUR_TOKEN',
'content' => json_encode(['key' => 'value']),
'timeout' => 10,
],
];
$context = stream_context_create($options);
$result = file_get_contents('https://api.example.com/simple', false, $context);
// 错误处理非常困难，需要检查$php_errormsg全局变量或使用try-catch捕获warningSwoole/Hyperf 等高性能框架的HTTP客户端：
总的来说，对于大多数现代PHP项目，Guzzle HTTP Client是我的首选。它在功能、易用性、社区支持和稳定性方面都表现出色。Symfony HTTP Client也是一个非常值得考虑的优秀选项。选择哪个，往往取决于你对项目现有技术栈的偏好和具体需求。
以上就是PHP怎么写接口_通过PHP实现第三方API调用的技巧的详细内容，更多请关注php中文网其它相关文章！
PHP怎么学习？PHP怎么入门？PHP在哪学？PHP怎么学才快？不用担心，这里为大家提供了PHP速学教程(入门到精通)，有需要的小伙伴保存下载就能学习啦！
广告
收藏
收藏
收藏
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号
127
