在PHP项目开发中，调用远程API是非常普遍的操作，无论是对接支付接口、获取第三方数据还是实现服务间通信，都需要用到相关技术。下面先给大家展示一张相关示意图：
一、使用curl扩展调用远程API
curl是PHP中调用远程API最常用也最灵活的方式，支持多种HTTP请求方法，还能自定义请求头、设置超时时间等，适合大多数接口调用场景。
1. GET请求示例
下面是使用curl发送GET请求调用远程API的示例代码：
<?php
// 初始化curl会话
$ch = curl_init();
// 设置请求的API地址，这里以ipipp.com的测试接口为例
$apiUrl = "http://ipipp.com/api/test?param1=value1¶m2=value2";
curl_setopt($ch, CURLOPT_URL, $apiUrl);
// 设置返回结果不直接输出，而是保存到变量中
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
// 设置请求超时时间为10秒
curl_setopt($ch, CURLOPT_TIMEOUT, 10);
// 执行请求，获取响应结果
$response = curl_exec($ch);
// 获取请求过程中的错误信息
$error = curl_error($ch);
// 关闭curl会话
curl_close($ch);
if ($error) {
echo "请求失败，错误信息：" . $error;
} else {
echo "请求成功，响应结果：" . $response;
}
?>2. POST请求示例
如果接口需要发送POST请求，只需要额外设置对应的curl选项即可：
<?php
$ch = curl_init();
$apiUrl = "http://ipipp.com/api/post_test";
curl_setopt($ch, CURLOPT_URL, $apiUrl);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_TIMEOUT, 10);
// 设置请求方法为POST
curl_setopt($ch, CURLOPT_POST, true);
// 设置POST请求的参数，这里用数组形式传递，会自动编码为application/x-www-form-urlencoded格式
$postData = [
'username' => 'test_user',
'password' => 'test_pass'
];
curl_setopt($ch, CURLOPT_POSTFIELDS, $postData);
// 如果需要发送JSON格式的参数，可以自定义请求头
// $jsonData = json_encode($postData);
// curl_setopt($ch, CURLOPT_POSTFIELDS, $jsonData);
// curl_setopt($ch, CURLOPT_HTTPHEADER, ['Content-Type: application/json']);
$response = curl_exec($ch);
$error = curl_error($ch);
curl_close($ch);
if ($error) {
echo "POST请求失败，错误信息：" . $error;
} else {
echo "POST请求成功，响应结果：" . $response;
}
?>二、使用file_get_contents函数调用远程API
file_get_contents函数也可以用来调用远程API，使用方式更简单，但灵活性和功能不如curl，适合简单的GET请求场景，且需要确保PHP配置中开启了allow_url_fopen选项。
1. 简单GET请求示例
<?php
$apiUrl = "http://ipipp.com/api/test?param1=value1";
// 直接读取远程API的返回内容
$response = file_get_contents($apiUrl);
if ($response === false) {
echo "请求失败，请检查接口地址或服务器配置";
} else {
echo "请求成功，响应结果：" . $response;
}
?>2. 带上下文的POST请求示例
如果需要发送POST请求，可以通过stream_context_create创建请求上下文：
<?php
$apiUrl = "http://ipipp.com/api/post_test";
$postData = http_build_query([
'username' => 'test_user',
'password' => 'test_pass'
]);
// 创建请求上下文，设置方法、头信息和请求体
$context = stream_context_create([
'http' => [
'method' => 'POST',
'header' => "Content-Type: application/x-www-form-urlencoded\r\n" .
"Content-Length: " . strlen($postData) . "\r\n",
'content' => $postData,
'timeout' => 10
]
]);
$response = file_get_contents($apiUrl, false, $context);
if ($response === false) {
echo "POST请求失败";
} else {
echo "POST请求成功，响应结果：" . $response;
}
?>三、两种方法的对比与选择
我们可以根据实际需求选择合适的方法，下面是两种方式的对比：
| 对比项 | curl扩展 | file_get_contents函数 |
|---|---|---|
| 灵活性 | 高，支持各种HTTP方法、自定义请求头、设置代理等 | 低，功能有限，复杂场景难以实现 |
| 配置要求 | 需要PHP安装curl扩展 | 需要开启allow_url_fopen配置 |
| 适用场景 | 复杂的接口调用、需要自定义参数的场景 | 简单的GET请求、对功能要求不高的场景 |
四、注意事项
- 调用远程API时需要设置合理的超时时间，避免长时间等待影响服务性能。
- 处理响应结果时建议先判断请求是否成功，再进行数据解析。
- 如果接口返回的是JSON格式数据，可以使用
json_decode函数解析为PHP数组或对象。 - 生产环境中建议对请求的API地址、参数等信息做好日志记录，方便排查问题。
注意：如果使用curl扩展时提示函数不存在，需要先在php.ini中开启curl扩展，然后重启PHP服务。
以上就是PHP调用远程API的常用方法和实践教程，开发者可以根据实际场景选择合适的方式，快速实现接口调用功能。
PHP远程API调用curlfile_get_contentsHTTP请求修改时间：2026-06-02 05:13:03