ScyllaDB PHP DriverNative CQL for PHP 8

A C extension that speaks the CQL binary protocol directly. Built on the ScyllaDB C/C++ driver, with token-aware routing, prepared statements, async futures, and full CQL type support.

Get started

Installation

View on GitHub

⚡

Native protocol, no PHP overhead

Queries run through the ScyllaDB C/C++ driver. Result rows decode in C and arrive as PHP values. No CQL parsing or text protocol in userland.

How it works

🎯

Token-aware and shard-aware

The driver sends each request to a replica that owns the data. Add datacenter-aware and latency-aware routing to control which nodes get traffic.

Routing options

🔐

TLS with peer verification

Load trusted certificates, present a client certificate, and choose the verification level. Credentials use the SensitiveParameter attribute.

Set up TLS

🧩

Every CQL type

Collections, tuples, user defined types, durations, decimals, varints, inet addresses, and time UUIDs all map to dedicated PHP classes.

Type mapping

🔀

Futures for concurrency

Each blocking call has an async twin. Start many queries, then collect the results. Result pages fetch asynchronously too.

Run queries in parallel

🐘

PHP 8.2 through 8.5

Typed signatures generated from PHP stubs, NTS and ZTS builds, and installation through PIE. Tested against ScyllaDB 4.4 to 6.x and Cassandra 3.0+.

Compatibility

From zero to a query

php

<?php

$session = Cassandra::cluster()
    ->withContactPoints('10.0.0.1', '10.0.0.2', '10.0.0.3')
    ->withPort(9042)
    ->withCredentials('scylla', getenv('SCYLLA_PASSWORD'))
    ->withDefaultConsistency(Cassandra::CONSISTENCY_LOCAL_QUORUM)
    ->withTokenAwareRouting(true)
    ->build()
    ->connect('shop');

$statement = $session->prepare('SELECT id, email FROM users WHERE id = ?');

$rows = $session->execute($statement, [
    'arguments' => [new Cassandra\Uuid('7b5a4c1e-8f2a-4c9e-9a1b-3c2d1e0f5a6b')],
]);

foreach ($rows as $row) {
    printf("%s <%s>\n", $row['id'], $row['email']);
}

Read the quick start for a complete first application, or go to clusters and sessions for the full connection model.