basho/riak

Official Riak client for PHP

Thursday, April 6, 2017
by christophermancini
Repository
100 Watchers
159 Stars
140,846 Installations

PHP
10 Dependents
3 Suggesters
74 Forks
2 Open issues
26 Versions
10 % Grown

The README.md

Riak Client for PHP

, _(*1)

Riak PHP Client is a library which makes it easy to communicate with Riak, an open source, distributed database that focuses on high availability, horizontal scalability, and predictable latency. This library communicates with Riak's HTTP interface using the cURL extension. If you want to communicate with Riak using the Protocol Buffers interface, use the Official PHP PB Client. Both Riak and this library are maintained by Basho Technologies., _(*2)

To see other clients available for use with Riak visit our Documentation Site, _(*3)

Installation
Documentation
Contributing
- An honest disclaimer
Roadmap
License and Authors

Installation

Dependencies

PHP 5.4+
PHP Extensions: curl, json and openssl [required for security features]
Riak 2.1+
Composer PHP Dependency Manager

Composer Install

This library has been added to Packagist to simplify the installation process. Run the following composer command:, _(*4)

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

Alternately, manually add the following to your composer.json, in the require section:, _(*5)

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

And then run composer update to ensure the module is installed., _(*6)

Documentation

Master:

A fully traversable version of the API documentation for this library can be found on Github Pages., _(*7)

Example Usage

Below is a short example of using the client. More substantial sample code is available in examples., _(*8)

// 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();

Contributing

This repo's maintainers are engineers at Basho and we welcome your contribution to the project! You can start by reviewing CONTRIBUTING.md for information on everything from testing to coding standards., _(*9)

An honest disclaimer

Due to our obsession with stability and our rich ecosystem of users, community updates on this repo may take a little longer to review., _(*10)

The most helpful way to contribute is by reporting your experience through issues. Issues may not be updated while we review internally, but they're still incredibly appreciated., _(*11)

Thank you for being part of the community! We love you for it., _(*12)

Roadmap

Current develop & master branches contain feature support for Riak version 2.1+
Add support for Riak TS Q2 2016

License and Authors

Author: Christopher Mancini (https://github.com/christophermancini)
Author: Alex Moore (https://github.com/alexmoore)
Author: Luke Bakken (https://github.com/lukebakken)

The Versions

06/04 2017

dev-develop

dev-develop http://basho.com/riak/

Official Riak client for PHP

library riak

Official Riak client for PHP

basho/riak

The README.md

Riak Client for PHP

Installation

Dependencies

Composer Install

Documentation

Example Usage

Contributing

An honest disclaimer

Roadmap

License and Authors

The Versions

dev-develop

The Requires

The Development Requires

by Christopher Mancini

by Alex Moore

3.4.0

The Requires

The Development Requires

by Christopher Mancini

by Alex Moore

dev-list-keys-integration-test

The Requires

The Development Requires

by Christopher Mancini

by Alex Moore

3.3.0

The Requires

The Development Requires

by Christopher Mancini

by Alex Moore

dev-master

The Requires

The Development Requires

by Christopher Mancini

by Alex Moore

3.2.0

The Requires

The Development Requires

by Christopher Mancini

by Alex Moore

dev-fixes/lrb/add-socket-timeouts

The Requires

The Development Requires

by Christopher Mancini

by Alex Moore

v3.1.0

The Requires

The Development Requires

by Christopher Mancini

by Alex Moore

v3.0.2

The Requires

The Development Requires

by Christopher Mancini

by Alex Moore

v3.0.1

The Requires

The Development Requires

by Christopher Mancini

by Alex Moore

2.1.x-dev

The Requires

The Development Requires

by Christopher Mancini

by Alex Moore

v3.0.0

The Requires

The Development Requires

by Christopher Mancini

by Alex Moore

v3.0.0-beta

The Requires

The Development Requires

by Christopher Mancini

by Alex Moore