datastax / php-driver
DataStax PHP Driver for Apache Cassandra
Installs: 485 151
Dependents: 20
Suggesters: 0
Security: 0
Stars: 432
Watchers: 64
Forks: 153
Language:C
Requires
- php: >=5.6.0
- ext-cassandra: ^1.0.0
Requires (Dev)
- behat/behat: ~3.0.6
- phpunit/php-code-coverage: ~2.0
- phpunit/php-token-stream: ~1.3
- phpunit/phpunit: ~4.8
- symfony/process: ~2.1
This package is not auto-updated.
Last update: 2024-09-28 17:07:24 UTC
README
⚠️ The PHP driver is in maintenance mode. We are still accepting pull-requests and we will occasionally release critical bug fixes, but no ongoing active development is being done currently.
DataStax PHP Driver for Apache Cassandra
A modern, feature-rich and highly tunable PHP client library for Apache Cassandra 2.1+ using exclusively Cassandra's binary protocol and Cassandra Query Language v3. Use the DSE PHP driver for better compatibility and support for DataStax Enterprise.
This is a wrapper around the DataStax C/C++ Driver for Apache Cassandra.
Note: DataStax products do not support big-endian systems.
Getting the Driver
Binary versions of the driver, available for multiple operating systems and multiple versions of PHP, can be obtained from DataStax download server. The source code is made available via GitHub. If you're using DataStax Enterprise use the DSE PHP driver instead.
Note: The driver extension is a wrapper around the DataStax C/C++ Driver for Apache Cassandra and is a requirement for proper installation of the PHP extension binaries. Ensure these dependencies are met before proceeding.
What's new in v1.2.0/v1.3.0
- Support for
duration
Session::execute()
andSession::executeAsync()
now support a simple string for the query CQL and a simple array for the query execution option- Full support for Apache Cassandra 2.2 and 3.0+
- Support for
tinyint
andsmallint
- Support for
date
andtime
- Support for user-defined function and aggregate metadata
- Support for secondary index and materialized view metadata
Compatibility
This driver works exclusively with the Cassandra Query Language v3 (CQL3) and Cassandra's native protocol. The current version works with:
- Apache Cassandra versions 2.1, 2.2 and 3.0+
- PHP 5.6, PHP 7.0, and PHP 7.1
- 32-bit (x86) and 64-bit (x64)
- Thread safe (TS) and non-thread safe (NTS)
- Compilers: GCC 4.1.2+, Clang 3.4+, and MSVC 2010/2012/2013/2015
If using DataStax Enterprise the DSE PHP driver provides more features and better compatibility.
Documentation
Getting Help
- JIRA: https://datastax-oss.atlassian.net/browse/PHP
- Mailing List: https://groups.google.com/a/lists.datastax.com/forum/#!forum/php-driver-user
- DataStax Academy via Slack: https://academy.datastax.com/slack
Quick Start
<?php $cluster = Cassandra::cluster() // connects to localhost by default ->build(); $keyspace = 'system'; $session = $cluster->connect($keyspace); // create session, optionally scoped to a keyspace $statement = new Cassandra\SimpleStatement( // also supports prepared and batch statements 'SELECT keyspace_name, columnfamily_name FROM schema_columnfamilies' ); $future = $session->executeAsync($statement); // fully asynchronous and easy parallel execution $result = $future->get(); // wait for the result, with an optional timeout foreach ($result as $row) { // results and rows implement Iterator, Countable and ArrayAccess printf("The keyspace %s has a table called %s\n", $row['keyspace_name'], $row['columnfamily_name']); }
Installation
pecl install cassandra
Read detailed instructions on building and installing the extension
Contributing
Read our contribution policy for a detailed description of the process.
Code examples
The DataStax PHP Driver uses the amazing Behat Framework for both end-to-end,
or acceptance testing and documentation. All of the features supported by the
driver have appropriate acceptance tests with easy-to-copy code examples in
the features/
directory.
Running tests
For your convenience a Vagrantfile
with configuration ready for testing is
available. To execute tests, run the following:
git clone https://github.com/datastax/php-driver.git
cd php-driver
git submodule update --init
vagrant up
vagrant ssh
Once you've logged in to the vagrant VM, run:
cd /usr/local/src/php-driver
./bin/behat
./bin/phpunit
Copyright
© DataStax, Inc.
Licensed under the Apache License, Version 2.0 (the “License”); you may not use this file except in compliance with the License. You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an “AS IS” BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.