https://github.com/leocavalcante/swoole-postgresql-doctrine-driver

🔌 A Doctrine DBAL Driver implementation on top of Swoole Coroutine PostgreSQL client
https://github.com/leocavalcante/swoole-postgresql-doctrine-driver

async connection-pool coroutine database dbal doctrine driver orm pool postgresql swoole

Last synced: 2 months ago
JSON representation

🔌 A Doctrine DBAL Driver implementation on top of Swoole Coroutine PostgreSQL client

• Host: GitHub
• URL: https://github.com/leocavalcante/swoole-postgresql-doctrine-driver
• Owner: leocavalcante
• License: mit
• Created: 2021-03-22T21:02:03.000Z (almost 4 years ago)
• Default Branch: main
• Last Pushed: 2022-02-02T20:51:04.000Z (almost 3 years ago)
• Last Synced: 2024-10-03T10:49:59.699Z (3 months ago)
• Topics: async, connection-pool, coroutine, database, dbal, doctrine, driver, orm, pool, postgresql, swoole
• Language: PHP
• Homepage: https://wiki.swoole.com/#/coroutine_client/postgresql
• Size: 69.3 KB
• Stars: 24
• Watchers: 5
• Forks: 8
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# Swoole Coroutine PostgreSQL Doctrine DBAL Driver

A `Doctrine\DBAL\Driver` implementation on top of `Swoole\Coroutine\PostgreSQL`.

## Getting started

### Install

```shell

composer require leocavalcante/swoole-postgresql-doctrine-driver

```

### Usage

Doctrine parameters, for both DBAL and ORM projects, accepts the `driverClass` option; it is where we can inject this project's driver:

```php

use Doctrine\DBAL\{Driver, DriverManager};

$params = [

    'dbname' => 'postgres',

    'user' => 'postgres',

    'password' => 'postgres',

    'host' => 'db',

    'driverClass' => Driver\Swoole\Coroutine\PostgreSQL\Driver::class,

    'poolSize' => 8,

];

$conn = DriverManager::getConnection($params);

```

*Yes, I deliberately used the `Doctrine\DBAL\Driver` namespace + `Swoole\Coroutine\PostgreSQL` namespace, so it is not confusing.*

#### You are ready to rock inside Coroutines (Fibers):

```php

Co\run(static function() use ($conn): void {

    $results = [];

    $wg = new Co\WaitGroup();

    $start_time = time();

    Co::create(static function() use (&$results, $wg, $conn): void {

        $wg->add();

        $results[] = $conn->executeQuery('select 1, pg_sleep(1)')->fetchOne();

        $wg->done();

    });

    Co::create(static function() use (&$results, $wg, $conn): void {

        $wg->add();

        $results[] = $conn->executeQuery('select 1, pg_sleep(1)')->fetchOne();

        $wg->done();

    });

    $wg->wait();

    $elapsed = time() - $start_time;

    $sum = array_sum($results);

    echo "Two pg_sleep(1) queries in $elapsed second, returning: $sum\n";

});

```

You should be seeing `Two pg_sleep(1) queries in 1 second, returning: 2` and the total time should **not** be 2 (the sum of `pg_sleep(1)`'s) because they ran concurrently.

```shell

real    0m1.228s

user    0m0.036s

sys     0m0.027s

```

## Developing

### Use Composer through Docker

```shell

docker-compose run --rm composer install

docker-compose run --rm composer test

```

It will build a development image with PHP, Swoole, Swoole's PostgreSQL extension and PCOV for coverage.