This library allows you to connect to a Couchbase cluster from PHP. It is a native PHP extension and uses the very fast libcouchbase library to handle communicating to the cluster over the Couchbase binary protocol. It supports 5.x and 7.x releases of PHP interpreter.
- Source - https://github.com/couchbaselabs/php-couchbase
- Bug Tracker - https://www.couchbase.com/issues/browse/PCBC
- Couchbase PHP Community - https://forums.couchbase.com/c/php-sdk
- Documentation - https://developer.couchbase.com/documentation/server/current/sdk/php/start-using-sdk.html
- PECL - https://pecl.php.net/package/couchbase
- Packages - https://developer.couchbase.com/server/other-products/release-notes-archives/php-sdk
- Snapshots - http://sdkbuilds.sc.couchbase.com/job/php-sdk-package/lastSuccessfulBuild/artifact/packages/
The target system should have libcouchbase installed. Detailed guide and links to the most recent versions located here: https://developer.couchbase.com/server/other-products/release-notes-archives/c-sdk.
Couchbase PHP client generally available through PECL: http://pecl.php.net/package/couchbase
pecl install couchbaseRPM packages available for Fedora 24-27 and RHEL 6-7 linux on https://rpms.remirepo.net/.
Additionally Windows builds available from Release Notes and Archives page.
On MacOS platform, the library could be installed via Homebrew:
brew tap homebrew/homebrew-php
brew install php70-couchbase # or other version instead of 70 (PHP 7.0)If you are going to prepare patches, or just need to install the most recent version from git, make sure you have PHP development tools and headers installed, and run the following commands:
git clone git://github.com/couchbase/php-couchbase.git
cd php-couchbase
phpize
./configure --with-couchbase
make && make installConnecting to a Couchbase bucket is as simple as creating a new Connection instance. Once you are connect, you may execute any of Couchbases' numerous operations against this connection.
Here is a simple example of instantiating a connection, setting a new document into the bucket and then retrieving its contents:
$cluster = new \Couchbase\Cluster('localhost');
$db = $cluster->openBucket('default');
$db->upsert('testdoc', array('name'=>'Frank'));
$res = $db->get('testdoc');
var_dump($res->value);
// array(1) {
// ["name"]=>
// string(5) "Frank"
// }An extensive documentation is available on the Couchbase website. Visit our PHP Community on the Couchbase website for the documentation as well as numerous examples and samples.
To build PHP API reference, phpDocumentor have to be installed
pear channel-discover pear.phpdoc.org
pear install phpdoc/phpDocumentor
That will bring phpdoc command into PATH. The following steps assume that current directory is the root of this repository:
ver=$(git describe | sed 's/^v//')
rm -rf couchbase-php-client-$ver
phpdoc --target couchbase-php-client-$ver --directory api
After that all reference documentation will be stored in couchbase-php-client-2.3.0, if current tag is 2.3.0.
The source code is available at https://github.com/couchbase/php-couchbase.
To execute our test suite, simply install and execute phpunit against your
checked out source code. Tests assume that you have Couchbase Server with
default bucket running on localhost (otherwise use environment variable
CB_DSN, CB_ADMIN_USER, CB_ADMIN_PASSWORD, CB_BUCKET, CB_USER,
CB_PASSWORD. E.g. CB_DSN=couchbase://192.168.1.42/ CB_BUCKET=travel-sample).
curl -L https://phar.phpunit.de/phpunit.phar > ~/bin/phpunit
chmod a+x ~/bin/phpunit
# or just 'dnf install php-phpunit-PHPUnit' on Fedora 24+
phpunit tests/Integration tests require some prerequisites, so once they met, you can run integration tests with:
phpunit integration/It is also possible to run tests using CouchbaseMock:
CB_MOCK=1 phpunit tests/Server version guard might be specified by CB_VERSION (default is 4.6). The tests which depend on functionality,
which is not supported by CB_VERSION, will be skipped automatically.
Copyright 2016-2017 Couchbase Inc.
Licensed under the Apache License, Version 2.0.
See LICENSE for further details.