
在开发过程中,我们经常需要通过编程方式访问受http认证保护的资源,例如网络摄像头(nvr/dvr)提供的实时视频流或快照。然而,即使在浏览器或命令行工具(如wget)中能够成功访问,php脚本却可能频繁遭遇“401 unauthorized”错误。本文将深入分析这一问题的原因,并提供一个基于http digest认证的可靠解决方案。
HTTP协议定义了几种认证机制,其中最常见的是Basic认证和Digest认证。
许多现代设备和服务器(如HikVision NVR)为了提高安全性,可能默认或强制使用Digest认证,或者在客户端尝试Basic认证失败后,要求进行Digest认证。
当PHP脚本尝试访问受Digest认证保护的资源时,如果使用了不正确的认证方式,就会收到401错误。以下是几种常见的PHP实现方式及其可能失败的原因。
直接在URL中嵌入用户名和密码是一种便捷的方式,但file_get_contents函数对这种URL格式的支持可能有限,或者底层HTTP客户端实现不具备处理复杂认证流的能力。
立即学习“PHP免费学习笔记(深入)”;
<?php
// 示例 v1: 直接在URL中嵌入凭据
$url_with_credentials = "http://admin:441e3!@192.168.1.90/ISAPI/Streaming/channels/201/picture?videoResolutionWidth=1920&videoResolutionHeight=1080";
$data = file_get_contents($url_with_credentials);
if ($data === false) {
echo "ERROR: file_get_contents failed. Check server logs for 401 Unauthorized.\n";
} else {
header('Content-type: image/jpeg');
echo $data;
}
?>失败原因: 这种方式通常无法处理Digest认证的挑战-响应机制,直接导致401错误。
通过stream_context_create创建HTTP上下文,并设置Basic认证头是file_get_contents的更高级用法。
<?php
// 示例 v2: 使用 stream_context_create 进行 Basic 认证
$username = 'admin';
$password = '441e3!';
$url = 'http://192.168.1.90/ISAPI/Streaming/channels/201/picture?videoResolutionWidth=1920&videoResolutionHeight=1080';
$context = stream_context_create(array(
'http' => array(
'header' => "Authorization: Basic " . base64_encode("$username:$password")
)
));
$data = file_get_contents($url, false, $context);
if ($data === false) {
echo "ERROR: file_get_contents with Basic auth failed. Check server logs for 401 Unauthorized.\n";
} else {
header('Content-type: image/jpeg');
echo $data;
}
?>失败原因: 尽管明确发送了Basic认证头,但如果服务器要求Digest认证,此方法仍将失败,因为服务器会忽略Basic认证并继续发送Digest挑战。
cURL库提供了更强大的HTTP请求控制能力,包括多种认证方式。然而,如果错误地指定为Basic认证,同样会失败。
<?php
// 示例 v3 (原始): 使用 cURL 进行 Basic 认证
$login = 'admin';
$password = '441e3!';
$url = 'http://192.168.1.90/ISAPI/Streaming/channels/201/picture?videoResolutionWidth=1920&videoResolutionHeight=1080';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_BASIC); // 指定 Basic 认证
curl_setopt($ch, CURLOPT_USERPWD, "$login:$password");
$data = curl_exec($ch);
if ($data === false) {
echo 'ERROR: ' . curl_error($ch) . "\n";
} else {
header('Content-type: image/jpeg');
echo $data;
}
curl_close($ch);
?>失败原因: 与stream_context_create类似,如果服务器期望Digest认证,即使使用cURL并指定CURLAUTH_BASIC,也会因为认证类型不匹配而收到401错误。
当浏览器能够访问而PHP脚本失败时,一个关键的诊断步骤是使用命令行工具(如wget或curl)在PHP脚本运行的环境中尝试访问,并观察其输出。这些工具通常会提供更详细的认证过程信息。
例如,在问题描述中,wget的输出清晰地显示了:
Authentication selected: Digest realm="da9ea0f8f352408658c64b0a", domain="::", qop="auth", nonce="e1f5166b2054a18a2a17595a4bbfaf23:1635894137125", opaque="", algorithm="MD5", stale="FALSE" ... HTTP request sent, awaiting response... 200 OK
这明确指示服务器选择了Digest认证,并且wget成功地完成了Digest认证流程。这个信息是解决问题的关键。
既然服务器要求Digest认证,那么PHP脚本也必须使用Digest认证才能成功。cURL库提供了CURLAUTH_DIGEST选项来支持这种认证方式。
<?php
// 最终解决方案: 使用 cURL 进行 HTTP Digest 认证
$login = 'admin';
$password = '441e3!';
$url = 'http://192.168.1.90/ISAPI/Streaming/channels/201/picture?videoResolutionWidth=1920&videoResolutionHeight=1080';
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_DIGEST); // 关键:指定 Digest 认证
curl_setopt($ch, CURLOPT_USERPWD, "$login:$password");
// 可选:如果遇到SSL/TLS证书问题,可以添加以下两行,但在生产环境应谨慎使用
// curl_setopt($ch, CURLOPT_SSL_VERIFYPEER, false);
// curl_setopt($ch, CURLOPT_SSL_VERIFYHOST, false);
$data = curl_exec($ch);
// 错误处理:检查 cURL 执行是否成功
if ($data === false) {
echo 'ERROR: ' . curl_error($ch) . "\n"; // 输出 cURL 错误信息
// 进一步诊断:可以获取 HTTP 状态码
$http_code = curl_getinfo($ch, CURLINFO_HTTP_CODE);
echo 'HTTP Status Code: ' . $http_code . "\n";
} else {
// 成功获取数据,设置正确的 Content-Type 并输出
header('Content-type: image/jpeg');
echo $data;
}
curl_close($ch);
?>在这个解决方案中,curl_setopt($ch, CURLOPT_HTTPAUTH, CURLAUTH_DIGEST); 是核心。它告诉cURL客户端使用HTTP Digest认证机制与服务器进行通信。cURL会自动处理Digest认证的挑战-响应过程,包括计算摘要和发送正确的认证头。
当PHP脚本在访问受保护的HTTP资源时遇到“401 Unauthorized”错误,而浏览器或wget等工具能够成功访问时,最常见的原因是PHP脚本使用的认证机制与服务器要求的认证机制不匹配。通过仔细分析命令行工具的输出(例如wget明确指出的Digest realm),可以确定服务器期望的认证类型。对于HTTP Digest认证,使用PHP cURL库并设置CURLOPT_HTTPAUTH为CURLAUTH_DIGEST是解决此类问题的关键。结合健壮的错误处理,可以确保PHP脚本能够稳定、安全地访问这些受保护的资源。
以上就是PHP访问受保护资源:从401未授权到HTTP Digest认证的实践指南的详细内容,更多请关注php中文网其它相关文章!
PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号