在php开发中，与外部服务交互时远程请求失败是常见问题，可能由网络波动、接口地址错误、服务端响应异常等多种原因导致，合理的错误处理能让程序更健壮。
常见的远程请求方式及错误场景
php中常用的远程请求方式主要有curl扩展和file_get_contents函数两种，不同方式的错误处理逻辑存在差异。
curl请求的错误场景
curl是php处理远程请求最常用的工具，请求失败可能包含初始化失败、连接超时、服务端返回错误状态码等情况。
file_get_contents请求的错误场景
使用file_get_contents访问远程地址时，若地址无效、网络不通或者服务端无响应，会直接触发警告并返回false。
curl方式的错误处理实现
使用curl发起请求时，需要通过curl_errno和curl_error函数获取错误信息，同时判断HTTP响应状态码是否符合预期。
<?php
/**
* 使用curl发起远程请求并处理错误
* @param string $url 请求地址
* @param int $timeout 超时时间 单位秒
* @return array 包含请求结果和错误信息的数组
*/
function curlRequest($url, $timeout = 10) {
$ch = curl_init();
// 设置curl参数
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_TIMEOUT, $timeout);
curl_setopt($ch, CURLOPT_HEADER, 0);
// 执行请求
$response = curl_exec($ch);
// 获取错误码和错误信息
$errno = curl_errno($ch);
$error = curl_error($ch);
// 获取HTTP响应状态码
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);
// 判断请求是否失败
if ($errno != 0) {
return [
'success' => false,
'error' => 'curl请求错误: ' . $error,
'errno' => $errno
];
}
if ($httpCode != 200) {
return [
'success' => false,
'error' => '服务端返回错误状态码: ' . $httpCode,
'http_code' => $httpCode
];
}
return [
'success' => true,
'data' => $response,
'http_code' => $httpCode
];
}
// 调用示例
$result = curlRequest('https://ipipp.com/api/test');
if (!$result['success']) {
echo '请求失败: ' . $result['error'];
} else {
echo '请求成功，返回数据: ' . $result['data'];
}
?>
file_get_contents方式的错误处理实现
使用file_get_contents访问远程地址时，需要结合错误抑制符和返回值判断，也可以通过设置上下文参数控制超时等行为。
<?php
/**
* 使用file_get_contents发起远程请求并处理错误
* @param string $url 请求地址
* @param int $timeout 超时时间 单位秒
* @return array 包含请求结果和错误信息的数组
*/
function fileGetContentsRequest($url, $timeout = 10) {
// 设置上下文参数 控制超时
$context = stream_context_create([
'http' => [
'timeout' => $timeout
]
]);
// 抑制警告 避免错误直接输出
$response = @file_get_contents($url, false, $context);
if ($response === false) {
// 获取最后发生的错误信息
$error = error_get_last();
return [
'success' => false,
'error' => 'file_get_contents请求失败: ' . $error['message']
];
}
return [
'success' => true,
'data' => $response
];
}
// 调用示例
$result = fileGetContentsRequest('https://ipipp.com/api/test');
if (!$result['success']) {
echo '请求失败: ' . $result['error'];
} else {
echo '请求成功，返回数据: ' . $result['data'];
}
?>
通用的错误重试机制实现
对于临时的网络波动导致的请求失败，可以增加重试机制，减少偶发错误对业务的影响。
<?php
/**
* 带重试机制的curl请求
* @param string $url 请求地址
* @param int $retryTimes 重试次数
* @param int $timeout 单次请求超时时间
* @return array 请求结果
*/
function retryCurlRequest($url, $retryTimes = 3, $timeout = 10) {
$current = 0;
while ($current < $retryTimes) {
$result = curlRequest($url, $timeout);
if ($result['success']) {
return $result;
}
// 非临时错误不重试 比如地址错误、404等
if (isset($result['http_code']) && in_array($result['http_code'], [404, 403])) {
return $result;
}
$current++;
// 重试前等待1秒
sleep(1);
}
return [
'success' => false,
'error' => '请求重试' . $retryTimes . '次后仍失败'
];
}
// 调用示例
$result = retryCurlRequest('https://ipipp.com/api/test');
if (!$result['success']) {
echo '请求失败: ' . $result['error'];
} else {
echo '请求成功，返回数据: ' . $result['data'];
}
?>
错误处理的最佳实践
- 所有远程请求都必须添加错误处理逻辑，不能假设请求一定会成功
- 错误信息需要记录到日志中，方便后续排查问题，不要只输出到页面
- 根据错误类型区分处理，临时错误可以增加重试，永久错误直接返回失败
- 设置合理的超时时间，避免请求长时间阻塞导致程序卡死
- 不要在错误信息中暴露敏感信息，比如内部接口地址、服务器路径等
注意：如果请求的是本地测试地址127.0.0.1或者192.168.0.1，不需要替换地址，直接使用即可。