正文
oauth2-server-php-docs 存储
提示：扫一扫查出行【扫一扫了解最新限行尾号】
复制提示
PDO
概观
PDO存储类使用 PHP 的PDO扩展。这允许连接到MySQL，SQLite，PostgreSQL 等等。
安装
PDO是默认安装的
php 5.1+
，这个库已经是必需的了，所以你会很好的去。
开始使用
一旦完成，实例化一个PDO客户端 连接到您选择的数据库服务器。
腓
// connection for MySQL
$pdo = new PDO('mysql:host=localhost;dbname=test', $user, $pass);
// connection for SQLite
$pdo = new PDO('sqlite:/opt/databases/mydb.sq3');
// connection for SQLite in memory
$pdo = new PDO('sqlite::memory:');
然后，使用
Pdo
存储类创建存储对象：
腓
$storage = new OAuth2\Storage\Pdo($pdo);
// now you can perform storage functions, such as the one below
$storage->setClientDetails($client_id, $client_secret, $redirect_uri);用法
PDO存储引擎实现了该库中支持的所有标准存储接口。请参阅接口了解更多信息。
蒙戈
概观
使用Mongo文档数据库在OAuth中存储和检索对象。
安装
首先，安装Mongo Extension for PHP您可以使用PECL：
文本
$ sudo pecl install mongo或者手动安装。 从github 下载最新版本的代码。
文本
$ tar zxvf mongodb-mongodb-php-driver-<commit_id>.tar.gz
$ cd mongodb-mongodb-php-driver-<commit_id>
$ phpize
$ ./configure
$ make all
$ sudo make install
接下来，
mongo.so
在您的
php.ini
文件中启用扩展名：
文本
extension=mongo.so开始使用
一旦完成，创建一个mongo客户端 连接到mongo服务器。
腓
$mongo = new \MongoClient();
现在，使用
Mongo
存储类创建存储对象：
腓
$storage = new OAuth2\Storage\Mongo($mongo);
// now you can perform storage functions, such as the one below
$storage->setClientDetails($client_id, $client_secret, $redirect_uri);用法
Mongo存储引擎实现了该库中支持的所有标准存储接口。请参阅接口了解更多信息。
Redis的
概观
使用Redis键值存储系统在OAuth中存储和检索对象。
安装
首先，安装PHP 的Redis客户端库
文本
$ composer require predis/predis:dev-master开始使用
一旦完成，创建一个连接实例 来连接到redis服务器。
腓
$predis = new \Predis\Client();
然后，使用
Redis
存储类创建存储对象：
腓
$storage = new OAuth2\Storage\Redis($predis);
// now you can perform storage functions, such as the one below
$storage->setClientDetails($client_id, $client_secret, $redirect_uri);用法
Redis存储引擎实现了该库中支持的所有标准存储接口。请参阅接口了解更多信息。
卡桑德拉
概观
使用Cassandra数据库管理系统在OAuth中存储和检索对象。
安装
首先，为PHP 安装Cassandra客户端库
文本
$ composer require thobbs/phpcassa:dev-master开始使用
一旦完成，实例化连接池 实例以连接到cassandra服务器。
腓
$servers = array('127.0.0.1:9160');
$cassandra = new \phpcassa\Connection\ConnectionPool('oauth2_server', $servers);
然后，使用
Cassandra
存储类创建存储对象：
腓
$storage = new OAuth2\Storage\Cassandra($cassandra);
// now you can perform storage functions, such as the one below
$storage->setClientDetails($client_id, $client_secret, $redirect_uri);用法
Cassandra存储引擎实现了该库中支持的所有标准存储接口。请参阅接口了解更多信息。
DynamoDB
概观
使用DynamoDB NoSQL数据库服务在OAuth中存储和检索对象。
安装
首先，您需要安装Amazon Web Services PHP SDK
文本
$ composer require aws/aws-sdk-php:dev-master开始使用
如果您尚未创建
~/.aws/credentials
文件，则这是启动DynamoDB并运行的最简单方法。
腓
// @see http://docs.aws.amazon.com/aws-sdk-php/guide/latest/credentials.html#credential-profiles
$config = array(
'profile' => 'default',
'region' => Aws\Common\Enum\Region::US_EAST_1, // Your region may differ
);或者，您可以将您的客户端配置为直接使用您的凭据运行
腓
// These credentials are found in your AWS management console
$config = array(
'key' => 'my-aws-key',
'secret' => 'my-aws-secret',
'region' => Aws\Common\Enum\Region::US_EAST_1, // Your region may differ
);
接下来，通过创建您的配置数组并使用以下
factory
方法来实例化AWS客户端：
腓
$dynamo = Aws\DynamoDb\DynamoDbClient::factory($config);
最后，使用
DynamoDB
存储类创建存储对象：
腓
$storage = new OAuth2\Storage\DynamoDB($dynamo);
// now you can perform storage functions, such as the one below
$storage->setClientDetails($client_id, $client_secret, $redirect_uri);要查看默认表结构的示例，请查看
Bootstrap::createDynamoDB此库中的函数，或者使用DynamoDB的管理UI自行创建表。
用法
DynamoDB存储引擎实现了此库中支持的所有标准存储接口。请参阅接口了解更多信息。
自定义存储
概观
使用这个库的一个很大的好处是可以自定义你自己的存储。如果其中一个内置存储对象不符合您的需求，则可以实现下面的一个或多个接口以获取自定义存储功能。
如何自定义存储
首先，找出你想要实现的存储接口。至少，每一个的OAuth2服务器需要存储对象实施
AccessTokenInterface
和
ClientCredentialsInterface
，因此，如果您不能存储在内置存储类的这些使用，您的自定义存储可以用这些启动。之后，您将需要根据您的授予类型实施其他接口。例如，如果您希望服务器支持
authorization_code
授予类型（最常见），并且希望自定义存储执行该操作，则还需要
AuthorizationCodeInterface
在存储对象上实现 。
术语“实现”是指您的自定义存储PHP类中的类声明。例如，要为访问令牌，客户端和授权代码授权类型使用自定义存储，您的类将如下所示：
腓
class MyCustomStorage implements OAuth2\Storage\AccessTokenInterface,
OAuth2\Storage\ClientCredentialsInterface, OAuth2\Storage\AuthorizationCodeInterface
{
// method implementation here...
}
一旦完成，您将需要编写这些接口所需的所有方法。例如，
ClientCredentialsInterface
指定
getClientDetails
接受
$client_id
参数并返回客户端数据数组的方法。
从那里，你将传递这个新的存储对象到服务器类：
腓
$customStorage = new MyCustomStorage();
$server = new OAuth2\Server($customStorage);不知道你需要什么方法？没问题，只需弹出打开界面类，并看看！如果这不是你的风格，PHP会抛出一个有用的错误消息，让你知道你的类仍然需要实现的方法，如果它丢失了。
包含在该库中的所有存储对象与“自定义存储”对象没有区别。唯一真正的区别是它们默认包含在库中，并且它们实现了 所有 的接口（你不需要实现所有的存储接口，只是你想要定制的接口）。
有关所有可能的存储接口，请参阅下面的接口列表，并查看 Cassandra存储 类，以获得为实现“定制”目的而实现的存储对象的示例 - 与Cassandra存储引擎进行接口。
接口
访问令牌接口
为了实现基本的访问令牌。这是令牌控制器所必需的 ，除非使用 JWT访问令牌。
ID：“access_token”
客户端界面
令牌控制器 和授权控制器是必需的，用于收集有关发出请求的客户端的信息。
ID：“客户端”
客户端凭证界面
验证客户的凭证。这对于令牌控制器的所有请求都是必需的，以便验证发出请求的客户端。
ID：“client_credentials”
授权码接口
用于实施授权码授权类型
id：“authorization_code”
刷新令牌接口
用于实现刷新令牌授予类型。
id：“refresh_token”
用户凭证界面
用于实现用户凭证授予类型。
id：“user_credentials”
智威汤逊承载接口
JWT承载授权类型必需。
id：“jwt_bearer”
范围界面
使用Scope Util来实现作用域。
ID：“范围”
公钥接口
用于实施JWT访问令牌。
id：“public_key”
智威汤逊接入令牌接口
使用JWT访问令牌的界面。这需要公用密钥接口（见下），并用于验证访问令牌而不使用数据库系统。
ID：无
使用多个存储
几乎所有类型的存储都可以使用该库附带的每个存储对象。但是，您可能想要针对不同的事物使用不同类型的商店。例如，如果你想存储你的客户
MySQL
，你的访问令牌
MongoDB
和你的范围
Memory
？
文本
clients ---> ||MySQL Database||
access tokens ---> {{ MongoDB }}
scopes ---> (( Memory ))这不是问题！您只需在创建OAuth2服务器对象时单独指定每个存储。首先创建你的存储对象：
腓
// instantiate all your storage objects
$clientStorage = new OAuth2\Storage\PDO(array(
'dsn' => 'mysql:host=localhost;dbname=test',
'username' => $user,
'password' => $pass
));
$tokenStorage = new OAuth2\Storage\Mongo(array(
'host' => 'localhost',
'port' => 27017
));
$scopeStorage = new OAuth2\Storage\Memory(array(
'supported_scopes' => array(
'one-scope',
'two-scope',
'red-scope',
'blue-scope',
);
));完成此操作后，创建OAuth服务器，并将存储对象作为关联数组传递，并将其id作为关键字：
腓
// add your storage objects to the OAuth server
$server = new OAuth2\Server(array(
'client_credentials' => $clientStorage,
'access_token' => $tokenStorage,
'scope' => $scopeStorage,
));你也可以在创建后添加它们，如果你喜欢：
腓
$server->addStorage($clientStorage, 'client_credentials');
$server->addStorage($tokenStorage, 'access_token');
$server->addStorage($scopeStorage, 'scope');由于您指定了存储ID，因此库仅将这些存储用于指定的功能。
对于存储器及其ID的列表，向下滚动到 界面 上的自定义存储。
