PHPackages                             beauty-framework/cockroach-db-support - 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. beauty-framework/cockroach-db-support

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

beauty-framework/cockroach-db-support
=====================================

Beauty CockroachDB support

1.0.0(10mo ago)01MITPHPPHP >=8.1

Since Jun 20Pushed 10mo agoCompare

[ Source](https://github.com/beauty-framework/cockroach-db-support)[ Packagist](https://packagist.org/packages/beauty-framework/cockroach-db-support)[ RSS](/packages/beauty-framework-cockroach-db-support/feed)WikiDiscussions main Synced 1mo ago

READMEChangelog (1)Dependencies (2)Versions (2)Used By (0)

📦 CockroachDB Support for Beauty Framework
==========================================

[](#-cockroachdb-support-for-beauty-framework)

This package provides CockroachDB support for the `beauty-framework/database` component of the Beauty Framework. It offers a lightweight adapter layer for integrating CockroachDB using the existing query builder and connection system.

---

🚀 Installation
--------------

[](#-installation)

```
composer require beauty-framework/cockroach-db-support
```

---

⚙️ Configuration
----------------

[](#️-configuration)

To use CockroachDB, provide a connection configuration with `driver` set to `cockroach` (in `config/database.php`):

```
return [
    'default' => 'cockroach',

    'connections' => [
        'cockroach' => [
            'driver' => 'cockroach',
            'host' => 'localhost',
            'port' => 26257,
            'database' => 'app_db',
            'username' => 'root',
            'password' => '',
            'sslmode' => 'disable',
            'ssl' => [
                'cert' => '/path/to/ca.crt',
                'key' => '/path/to/client.key',
                'ca' => '/path/to/ca.crt'
            ]
        ],
    ],
];
```

> ℹ️ Under the hood, this driver uses PostgreSQL (`pgsql`) via PDO but is tailored for CockroachDB's SQL behavior.

And last, add in `\App\Container\Database::configure`:

```
        $factory = new ConnectionFactory([
            new PdoPgsqlDriver(),
            new PdoMysqlDriver(),
            new PdoSqliteDriver(),
            new PdoSqlsrvDriver(),
            new \Beauty\CockroachDB\Drivers\PdoCockroachDriver(), // connection('cockroach');

$connection->table('users')->insert([
    'name' => 'Kirill',
    'email' => 'admin@example.com'
]);
```

Supports:

- Basic queries (select, insert, update, delete)
- Transactions
- Insert or update (via `ON CONFLICT DO UPDATE`)

---

🧪 Testing
---------

[](#-testing)

You can spin up a CockroachDB instance locally using Docker:

```
docker run -d --name=cockroach \
  -p 26257:26257 -p 8080:8080 \
  cockroachdb/cockroach:v24.1.0 start-single-node --insecure
```

```
docker exec -it cockroach ./cockroach sql --insecure --execute="CREATE DATABASE app_db"
```

Run tests:

```
./vendor/bin/phpunit
```

---

📝 License
---------

[](#-license)

This package is open-sourced software licensed under the [MIT license](LICENSE).

###  Health Score

29

—

LowBetter than 60% of packages

Maintenance56

Moderate activity, may be stable

Popularity1

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity45

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% 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

Unknown

Total

1

Last Release

323d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/068f8c26f06f513a9c38d2a01c4d90a85eae1125a5b9d14eae7059715be860e4?d=identicon)[m1n64](/maintainers/m1n64)

---

Top Contributors

[![m1n64](https://avatars.githubusercontent.com/u/24874264?v=4)](https://github.com/m1n64 "m1n64 (1 commits)")

---

Tags

databasecockroachdbbeauty

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/beauty-framework-cockroach-db-support/health.svg)

```
[![Health](https://phpackages.com/badges/beauty-framework-cockroach-db-support/health.svg)](https://phpackages.com/packages/beauty-framework-cockroach-db-support)
```

###  Alternatives

[doctrine/dbal

Powerful PHP database abstraction layer (DBAL) with many features for database schema introspection and management.

9.7k578.4M5.6k](/packages/doctrine-dbal)[doctrine/orm

Object-Relational-Mapper for PHP

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

Symfony DoctrineBundle

4.8k241.3M3.3k](/packages/doctrine-doctrine-bundle)[doctrine/migrations

PHP Doctrine Migrations project offer additional functionality on top of the database abstraction layer (DBAL) for versioning your database schema and easily deploying changes to it. It is a very easy to use and a powerful tool.

4.8k204.8M438](/packages/doctrine-migrations)[doctrine/data-fixtures

Data Fixtures for all Doctrine Object Managers

2.9k136.1M515](/packages/doctrine-data-fixtures)[robmorgan/phinx

Phinx makes it ridiculously easy to manage the database migrations for your PHP app.

4.5k46.2M401](/packages/robmorgan-phinx)

PHPackages © 2026

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