PHPackages                             couchbase/couchbase - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Database &amp; ORM](/categories/database)
4. /
5. couchbase/couchbase

ActiveLibrary[Database &amp; ORM](/categories/database)

couchbase/couchbase
===================

The PHP client library provides fast access to documents stored in a Couchbase Server.

4.5.0(3mo ago)7772.4k↓25.5%12[7 issues](https://github.com/couchbase/couchbase-php-client/issues)6Apache-2.0PHPCI passing

Since Apr 19Pushed 3mo ago16 watchersCompare

[ Source](https://github.com/couchbase/couchbase-php-client)[ Packagist](https://packagist.org/packages/couchbase/couchbase)[ RSS](/packages/couchbase-couchbase/feed)WikiDiscussions main Synced yesterday

READMEChangelog (10)Dependencies (2)Versions (21)Used By (6)

Couchbase PHP Extension
=======================

[](#couchbase-php-extension)

[![license](https://camo.githubusercontent.com/ae585bfe59fdbde36ff2d1717e35b57abab9f85f0668e47283c5f34c074b7dcd/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f6c6963656e73652f636f756368626173656c6162732f636f756368626173652d7068702d636c69656e743f636f6c6f723d627269676874677265656e)](https://opensource.org/licenses/Apache-2.0)

This repository contains source code of the Couchbase PHP SDK.

Support and Feedback
--------------------

[](#support-and-feedback)

If you find an issue, please file it in [our JIRA issue tracker](https://jira.issues.couchbase.com/browse/PCBC). Also you are always welcome on [our forum](https://forums.couchbase.com/c/php-sdk) and [Discord](https://discord.com/invite/sQ5qbPZuTh).

Getting the Source Code
-----------------------

[](#getting-the-source-code)

This repo uses several git submodules. If you are fetching the repo for the first time by command line, the `--recurse-submodules` option will init the submodules recursively as well:

```
git clone --recurse-submodules https://github.com/couchbaselabs/couchbase-php-client.git
```

However, if you fetched using a simple clone command (or another IDE or tool), or if you are pulling the latest and need to update, then **you must also perform** the following command to recursively update and initialize the submodules:

```
git submodule update --init --recursive
```

Building the Extension
----------------------

[](#building-the-extension)

This project is built with `CMake` and packaged with `pecl` so everything should build easily once the basic dev dependencies are satisfied. However, we have helper scripts in the [/bin](./bin) directory to help automate tasks even further.

### Dev Dependencies

[](#dev-dependencies)

The following dependencies must be installed before the project can be built. We recommend using OS specific utilities such as `brew`, `apt-get`, and similar package management utilities (depending on your environment).

- **cmake &gt;= 3.20.0+** (e.g., `brew install cmake`)
- **c++ compiler &gt;= std\_17** (e.g., `xcode-select --install`)
- **openssl &gt;= 1.1+** (e.g., `brew install openssl`)

**IMPORTANT:** On macOS, the **OpenSSL** `brew` install command mentioned above is not sufficient to be able to build. The easiest way to fix this is to add the `OPENSSL_ROOT_DIR` env variable to your exports (e.g., `.zshenv`). If this is not sufficient, see the other tips mentioned when you run `brew info openssl`.

```
export OPENSSL_ROOT_DIR=/usr/local/opt/openssl/
```

### Building (with shell script)

[](#building-with-shell-script)

```
cd couchbase-php-client
./bin/build
./bin/package
```

Running Tests
-------------

[](#running-tests)

The tests are located in the (/tests)\[./tests\] directory. More tests may be added and this directory will be organized more in the near future to differentiate between the common tests types that might be used for different types of testing (e.g., `unit tests`, `integration tests`, `system tests`).

### Testing (command-line)

[](#testing-command-line)

```
./bin/test
```

###  Health Score

52

—

FairBetter than 96% of packages

Maintenance62

Regular maintenance activity

Popularity47

Moderate usage in the ecosystem

Community30

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 65.4% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~79 days

Recently: every ~106 days

Total

19

Last Release

92d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/7280?v=4)[Sergey Avseyev](/maintainers/avsej)[@avsej](https://github.com/avsej)

---

Top Contributors

[![avsej](https://avatars.githubusercontent.com/u/7280?v=4)](https://github.com/avsej "avsej (212 commits)")[![Matt-Woz](https://avatars.githubusercontent.com/u/60651547?v=4)](https://github.com/Matt-Woz "Matt-Woz (51 commits)")[![chvck](https://avatars.githubusercontent.com/u/496482?v=4)](https://github.com/chvck "chvck (31 commits)")[![jrawsthorne](https://avatars.githubusercontent.com/u/777143?v=4)](https://github.com/jrawsthorne "jrawsthorne (12 commits)")[![DemetrisChr](https://avatars.githubusercontent.com/u/36637689?v=4)](https://github.com/DemetrisChr "DemetrisChr (10 commits)")[![raycardillo](https://avatars.githubusercontent.com/u/1744144?v=4)](https://github.com/raycardillo "raycardillo (2 commits)")[![remicollet](https://avatars.githubusercontent.com/u/270445?v=4)](https://github.com/remicollet "remicollet (2 commits)")[![deminy](https://avatars.githubusercontent.com/u/865547?v=4)](https://github.com/deminy "deminy (1 commits)")[![thias](https://avatars.githubusercontent.com/u/787766?v=4)](https://github.com/thias "thias (1 commits)")[![srjlewis](https://avatars.githubusercontent.com/u/56001?v=4)](https://github.com/srjlewis "srjlewis (1 commits)")[![CosmicSaaurabh](https://avatars.githubusercontent.com/u/75273071?v=4)](https://github.com/CosmicSaaurabh "CosmicSaaurabh (1 commits)")

---

Tags

couchbasephpsdk

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/couchbase-couchbase/health.svg)

```
[![Health](https://phpackages.com/badges/couchbase-couchbase/health.svg)](https://phpackages.com/packages/couchbase-couchbase)
```

###  Alternatives

[jdorn/sql-formatter

a PHP SQL highlighting library

3.9k117.2M117](/packages/jdorn-sql-formatter)[propel/propel1

Propel is an open-source Object-Relational Mapping (ORM) for PHP5.

8351.6M87](/packages/propel-propel1)[jfelder/oracledb

Oracle DB driver for Laravel

11518.4k](/packages/jfelder-oracledb)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
