README

Riak PHP客户端是一个库，它使得与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以确保安装该模块。

文档

• 主分支：

此库的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开始，以获取有关从测试到编码标准的所有信息。

一个真诚的声明

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

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

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

路线图

• 当前的开发分支和主分支包含对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，版本2.0 ("许可证") 授权。有关更多详细信息，请参阅许可证。