ZFResource^beta

Zend_Auth_Adapter_Http提供一个大部分符合RFC-2617的基本 和 数字 HTTP 认证。数字认证是一个认证的方法，它在基本认证的基础上做了改进，不需要在网络上传输明文密码。

主要特性：

还有一些显著的 RFC-2617 特性没有实现：

这个适配器包括两个子组件，HTTP authentication类本身和所谓的 "Resolvers"。HTTP authentication类封装了实现基本和数字认证的逻辑。它使用Resolver在数据存储（缺省是文本文件）中查找客户的身份并取出证书。"resolved" 的证书和客户的输入相比较来决定认证是否成功。

Zend_Auth_Adapter_Http 类需要一个配置数组传递给它的构造器。有若干个配置选项有效，其中一些是必需的：

	注意
	当前的nonce_timeout实现有一些有趣的副作用。这个设置用来决定给定的nonce的有效寿命，或者客户端的认证信息多长时间被有效地接受。目前，如果它被设置为3600（例如），它将导致适配器准点地每个小时提示客户端提供新的证书。一旦nonce跟踪和stale支持实现，这在将来的版本中被解决。

Resolver的作用是接受用户名和领域，并返回证书值。基本认证期望接收用户密码的Base64编码版本。数字认证期望接收用户的用户名，领域和密码（用冒号分隔）的hash。当前，唯一支持的hash算法是MD5。

Zend_Auth_Adapter_Http 依靠对象实现 Zend_Auth_Adapter_Http_Resolver_Interface。适配器中包含一个文本文件resolver类，但任何其它种类的resolver可以通过实现resolver接口来创建。

<username>:<realm>:<credentials>\n

<?php
$path     = 'files/passwd.txt';
$resolver = new Zend_Auth_Adapter_Http_Resolver_File($path);
                

<?php
$path     = 'files/passwd.txt';
$resolver = new Zend_Auth_Adapter_Http_Resolver_File();
$resolver->setFile($path);
                

首先，建立一个带有必需的配置值得数组：

<?php
$config = array(
    'accept_schemes' => 'basic digest',
    'realm'          => 'My Web Site',
    'digest_domains' => '/members_only /my_account',
    'nonce_timeout'  => 3600,
);
            

这个数组将使适配器接收基本或者数字认证，并将请求对所有在/members_only 和/my_account之下的区域认证访问。领域值通常在浏览器中密码对话框中显示。nonce_timeout，当然，会有上述的行为。

下一步, 创建 Zend_Auth_Adapter_Http 对象：

<?php
require_once 'Zend/Auth/Adapter/Http.php';
$adapter = new Zend_Auth_Adapter_Http($config);
            

因为我们对基本和数字认证都支持，所以我们需要两个不同的resolver对象。注意这仅仅简单地是两个不同的类：

<?php
require_once 'Zend/Auth/Adapter/Http/Resolver/File.php';

$basicResolver = new Zend_Auth_Adapter_Http_Resolver_File();
$basicResolver->setFile('files/basicPasswd.txt');

$digestResolver = new Zend_Auth_Adapter_Http_Resolver_File();
$digestResolver->setFile('files/digestPasswd.txt');

$adapter->setBasicResolver($basicResolver);
$adapter->setDigestResolver($digestResolver);
            

最后，我们执行认证。为了完成认证，适配器对请求（Request）和响应（Response）都需要一个reference：

<?php
assert($request instanceof Zend_Controller_Request_Http);
assert($response instanceof Zend_Controller_Response_Http);

$adapter->setRequest($request);
$adapter->setResponse($response);

$result = $adapter->authenticate();
if (!$result->isValid()) {
    // Bad userame/password, or canceled password prompt
}