README

Riak PHP客户端是一个库，它使得与Riak进行通信变得简单，Riak是一个开源的分布式数据库，专注于高可用性、水平可扩展性和可预测的延迟。此库通过cURL扩展与Riak的HTTP接口通信。如果您想使用Protocol Buffers接口与Riak通信，请使用官方PHP PB客户端。Riak和此库均由Basho Technologies维护。

要查看可用于与Riak一起使用的其他客户端，请访问我们的文档网站

1. 安装
2. 文档
3. 贡献
   • 真诚的免责声明
4. 路线图
5. 许可证和作者

安装

依赖关系

• PHP 5.4+
• PHP扩展：curl、json和openssl [用于安全功能]
• Riak 2.1+
• Composer PHP依赖管理器

Composer安装

此库已被添加到Packagist，以简化安装过程。运行以下composer命令

$ composer require "basho/riak": "3.0.*"

或者，您可以手动将以下内容添加到您的composer.json文件中的require部分

"require": {
    "basho/riak": "3.0.*"
}

然后运行composer update以确保安装了该模块。

文档

• Master:

此库的API文档的完整可遍历版本可以在Github Pages上找到。

示例用法

以下是使用客户端的简短示例。更详细的示例代码可在示例中找到。

// lib classes are included via the Composer autoloader files
use Basho\Riak;
use Basho\Riak\Node;
use Basho\Riak\Command;

// define the connection info to our Riak nodes
$nodes = (new Node\Builder)
    ->onPort(10018)
    ->buildCluster(['riak1.company.com', 'riak2.company.com', 'riak3.company.com',]);

// instantiate the Riak client
$riak = new Riak($nodes);

// build a command to be executed against Riak
$command = (new Command\Builder\StoreObject($riak))
    ->buildObject('some_data')
    ->buildBucket('users')
    ->build();
    
// Receive a response object
$response = $command->execute();

// Retrieve the Location of our newly stored object from the Response object
$object_location = $response->getLocation();

贡献

此存储库的维护者是Basho的工程师，我们欢迎您为此项目做出贡献！您可以首先查看CONTRIBUTING.md以获取有关测试到编码标准的所有信息。

真诚的免责声明

由于我们对稳定性和我们丰富的用户生态系统着迷，因此对此存储库的社区更新可能需要更长的时间进行审查。

最有帮助的贡献方式是通过问题报告您的经验。在内部审查时，问题可能不会更新，但它们仍然非常受欢迎。

感谢您成为社区的一部分！我们为此爱您。

路线图

• 当前的开发和master分支包含对Riak版本2.1+的功能支持
• 支持Riak TS Q2 2016

许可证和作者

• 作者：Christopher Mancini (https://github.com/christophermancini)
• 作者：Alex Moore (https://github.com/alexmoore)
• 作者：Luke Bakken (https://github.com/lukebakken)

版权所有 (c) 2015 Basho Technologies, Inc. 保留所有权利。许可协议为Apache License, Version 2.0 ("许可证")。更多详细信息，请参阅许可证。