Cassandra client library for PHP, which support Protocol v3 (Cassandra 2.1) and asynchronous request
- Support for PHP 5.3
- composer is not required
- Using Protocol v3 (Cassandra 2.1)
- Support asynchronous and synchronous request
- Support for logged, unlogged and counter batches
- The ability to specify the consistency, "serial consistency" and all flags defined in the protocol
- Support Query preparation and execute
- Support all data types convertion and binding
- Support conditional update/insert
- 5 fetch methods (fetchAll, fetchRow, fetchPairs, fetchCol, fetchOne)
- 800% performance improvement(async mode) than other php cassandra client libraries
PHP 5.3+ is required. There is no need for additional libraries.
<?php
$nodes = [
'127.0.0.1', // simple way, hostname only
'192.168.0.2:9160', // simple way, hostname with port
[ // advanced way, array including username, password and socket options
'host' => '10.205.48.70',
'port' => 9042,
'username' => 'admin',
'password' => 'pass',
'socket' => [
SO_RCVTIMEO => ["sec" => 10, "usec" => 0],
],
],
];
require_once "Autoloader.php";
Cassandra\Autoloader::register();
// Create a connection.
$connection = new Cassandra\Connection($nodes, 'my_keyspace');
// Run query synchronously.
$response = $connection->querySync('SELECT * FROM "users" WHERE "id" = ?', [new Cassandra\Type\Uuid('c5420d81-499e-4c9c-ac0c-fa6ba3ebc2bc')]);
// Return a SplFixedArray containing all of the result set.
$rows = $response->fetchAll(); // SplFixedArray
// Return a SplFixedArray containing a specified index column from the result set.
$col = $response->fetchCol(); // SplFixedArray
// Return a assoc array with key-value pairs, the key is the first column, the value is the second column.
$col = $response->fetchPairs(); // assoc array
// Return the first row of the result set.
$row = $response->fetchRow(); // ArrayObject
// Return the first column of the first row of the result set.
$value = $response->fetchOne(); // mixed
// Return a statement immediately
$statement = $connection->queryAsync($cql);
// Wait until received the response
$response = $statement->getResponse();
$rows = $response->fetchAll();
$preparedData = $connection->prepare('SELECT * FROM "users" WHERE "id" = :id');
$strictValues = Cassandra\Request\Request::strictTypeValues(
[
'id' => 'c5420d81-499e-4c9c-ac0c-fa6ba3ebc2bc',
],
$preparedData['metadata']['columns']
);
$response = $connection->executeSync(
$preparedData['id'],
$strictValues,
Cassandra\Request\Request::CONSISTENCY_QUORUM,
[
'page_size' => 100,
'names_for_values' => true,
'skip_metadata' => true,
]
);
$response->setMetadata($preparedData['result_metadata']);
$rows = $response->fetchAll();
$batchRequest = new Cassandra\Request\Batch();
// Append a prepared query
$preparedData = $connection->prepare('UPDATE "students" SET "age" = :age WHERE "id" = :id');
$values = [
'age' => 21,
'id' => 'c5419d81-499e-4c9c-ac0c-fa6ba3ebc2bc',
];
$batchRequest->appendQueryId($preparedData['id'], Cassandra\Request\Request::strictTypeValues($values, $preparedData['metadata']['columns']));
// Append a query string
$batchRequest->appendQuery(
'INSERT INTO "students" ("id", "name", "age") VALUES (:id, :name, :age)',
[
'id' => new Cassandra\Type\Uuid('c5420d81-499e-4c9c-ac0c-fa6ba3ebc2bc'),
'name' => new Cassandra\Type\Varchar('Mark'),
'age' => 20,
]
);
$response = $connection->syncRequest($batchRequest);
$rows = $response->fetchAll();
All types are supported.
// Ascii
new Cassandra\Type\Ascii('string');
// Bigint
new Cassandra\Type\Bigint(10000000000);
// Blob
new Cassandra\Type\Blob('string');
// Boolean
new Cassandra\Type\Boolean(true);
// Counter
new Cassandra\Type\Counter(1000);
// Decimal
new Cassandra\Type\Decimal('2.718281828459');
// Double
new Cassandra\Type\Double(2.718281828459);
// Float
new Cassandra\Type\Float(2.718);
// Inet
new Cassandra\Type\Inet('127.0.0.1');
// Int
new Cassandra\Type\Int(1);
// CollectionList
new Cassandra\Type\CollectionList([1, 1, 1], Cassandra\Type\Base::INT);
// CollectionMap
new Cassandra\Type\CollectionMap(['a' => 1, 'b' => 2], Cassandra\Type\Base::ASCII, Cassandra\Type\Base::INT);
// CollectionSet
new Cassandra\Type\CollectionSet([1, 2, 3], Cassandra\Type\Base::INT);
// Timestamp (unit: microseconds)
new Cassandra\Type\Timestamp(1409830696263000);
// Uuid
new Cassandra\Type\Uuid('62c36092-82a1-3a00-93d1-46196ee77204');
// Timeuuid
new Cassandra\Type\Timeuuid('2dc65ebe-300b-11e4-a23b-ab416c39d509');
// Varchar
new Cassandra\Type\Varchar('string');
// Varint
new Cassandra\Type\Varint(10000000000);
// Custom
new Cassandra\Type\Custom('string');
- shen2/fluent-cql: write CQL in fluent interface
- duoshuo/uuid: generate UUID and TimeUUID