tbolier / php-rethink-ql

Brand new PHP RethinkDB driver for RethinkDB >= 2.3.0 for any framework or application
Apache License 2.0
53 stars 18 forks source link
driver nosql nosql-database php php-rethinkdb-driver php-rql reql rethinkdb rethinkdb-adapter rethinkdb-driver
PHP-RETHINK-QL
A PHP RethinkDB driver for the RethinkDB query language (ReQL).
License: Apache License 2.0

PHP-RETHINK-QL by Scrutinizer Code Quality Code Coverage Build Status

License

PHP-RETHINK-QL is licensed under the terms of the Apache License 2.0

Description

A new clean and solid RethinkDB driver for PHP, focused on clean code with SOLID principles in mind.

Unfortunately the original PHP-RQL driver is no longer is no longer actively maintained and patched. That's why we have started this new PHP RethinkDB driver with the goal to create an easy to understand driver that can be improved and maintained by the community.

Requirements

RethinkDB version

This library supports the RethinkDB release >=2.3.0 and protocol version V1_0. Earliers version of RethinkDB are not supported at this moment.

PHP

PHP version >=7.1

Supported ReQL Command API overview.

In the release roadmap you will find a table with the currently and future supported ReQL command methods.

Getting started

Multiple connections can be injected into the connection Registry. Create the Rethink driver object by injecting a Connection object into it.

<?php
use TBolier\RethinkQL\Rethink;
use TBolier\RethinkQL\Connection\Registry;

$connections = [
    'default_connection' => [
        'host' => 'localhost',
        'port' => 28015,
        'default_db' => 'demoDB',
        'user' => 'demo',
        'password' => 'demo',
        'timeout' => 5,
        'timeout_stream' => 10,
    ],
];

$registry = new Registry($connections);

$r = new Rethink($registry->getConnection('default_connection'));

// Now you can connect to RethinkDB.
$r->connection()->connect();

The driver class Rethink has a default database defined in the connection options. However you can always switch database if needed.

$r->use('demoDB-2');

The driver class Rethink has an API Interface that supports the ReQL domain-specific language (DSL).

A create table example:

$r->db()
  ->tableCreate('Table')
  ->run();

For more examples about executing queries go to our docs section: Getting started

Contributing

Please read the contributing guidelines if you would like to contribute to this project.

Discussions and chat

You can find us at Gitter.im in the rethinkdb-php room at https://gitter.im/rethinkdb-php/Lobby

Author and collaborators

See also the list of contributors who participated in this project.