https://github.com/couchbase/couchbase-php-client
Couchbase PHP Client Library (Official)
https://github.com/couchbase/couchbase-php-client
couchbase php sdk
Last synced: 3 months ago
JSON representation
Couchbase PHP Client Library (Official)
- Host: GitHub
- URL: https://github.com/couchbase/couchbase-php-client
- Owner: couchbase
- License: apache-2.0
- Created: 2021-10-15T16:38:06.000Z (over 4 years ago)
- Default Branch: main
- Last Pushed: 2026-04-01T23:24:10.000Z (3 months ago)
- Last Synced: 2026-04-02T09:07:47.457Z (3 months ago)
- Topics: couchbase, php, sdk
- Language: PHP
- Homepage: https://www.couchbase.com
- Size: 1.76 MB
- Stars: 7
- Watchers: 17
- Forks: 12
- Open Issues: 7
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# Couchbase PHP Extension
[](https://opensource.org/licenses/Apache-2.0)
This repository contains source code of the Couchbase PHP SDK.
## 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
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:
```shell
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:
```shell
git submodule update --init --recursive
```
## 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
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`.
```shell
export OPENSSL_ROOT_DIR=/usr/local/opt/openssl/
```
### Building (with shell script)
```shell
cd couchbase-php-client
./bin/build
./bin/package
```
## 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)
```shell
./bin/test
```