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 & ORM](/categories/database)
4. /
5. couchbase/couchbase

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

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

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

4.4.0(7mo ago)7665.9k↓10.2%12[4 issues](https://github.com/couchbase/couchbase-php-client/issues)[1 PRs](https://github.com/couchbase/couchbase-php-client/pulls)6Apache-2.0PHPCI passing

Since Apr 19Pushed 2mo ago17 watchersCompare

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

READMEChangelog (10)Dependencies (1)Versions (20)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 >= 3.20.0+** (e.g., `brew install cmake`)
- **c++ compiler >= std\_17** (e.g., `xcode-select --install`)
- **openssl >= 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

Maintenance65

Regular maintenance activity

Popularity46

Moderate usage in the ecosystem

Community30

Small or concentrated contributor base

Maturity57

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 65.5% 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 ~72 days

Total

18

Last Release

231d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/f62342039184a6aefe5a937945256529512dfbb8bffb4a927a0b5083ed38aeeb?d=identicon)[avsej](/maintainers/avsej)

---

Top Contributors

[![avsej](https://avatars.githubusercontent.com/u/7280?v=4)](https://github.com/avsej "avsej (209 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 (8 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

[doctrine/orm

Object-Relational-Mapper for PHP

10.2k285.3M6.2k](/packages/doctrine-orm)[jdorn/sql-formatter

a PHP SQL highlighting library

3.9k115.1M102](/packages/jdorn-sql-formatter)[illuminate/database

The Illuminate Database package.

2.8k52.4M9.4k](/packages/illuminate-database)[ramsey/uuid-doctrine

Use ramsey/uuid as a Doctrine field type.

90440.3M211](/packages/ramsey-uuid-doctrine)[reliese/laravel

Reliese Components for Laravel Framework code generation.

1.7k3.4M16](/packages/reliese-laravel)[wildside/userstamps

Laravel Userstamps provides an Eloquent trait which automatically maintains `created\_by` and `updated\_by` columns on your model, populated by the currently authenticated user in your application.

7511.7M13](/packages/wildside-userstamps)

PHPackages © 2026

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