Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/dazzle-php/pgsql

Dazzle Async PgSQL Client
https://github.com/dazzle-php/pgsql

async database dazzle pgsql php php-lib php7 postgres sql storage

Last synced: 6 days ago
JSON representation

Dazzle Async PgSQL Client

Host: GitHub
URL: https://github.com/dazzle-php/pgsql
Owner: dazzle-php
License: mit
Created: 2017-07-25T10:37:47.000Z (about 7 years ago)
Default Branch: master
Last Pushed: 2017-09-11T15:28:10.000Z (about 7 years ago)
Last Synced: 2024-09-25T14:31:06.382Z (8 days ago)
Topics: async, database, dazzle, pgsql, php, php-lib, php7, postgres, sql, storage
Language: PHP
Homepage:
Size: 12.7 KB
Stars: 4
Watchers: 2
Forks: 2
Open Issues: 0
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE

Awesome Lists containing this project

README

        # Dazzle Async PgSQL Driver

[![Build Status](https://travis-ci.org/dazzle-php/pgsql.svg)](https://travis-ci.org/dazzle-php/pgsql)

[![Code Coverage](https://scrutinizer-ci.com/g/dazzle-php/pgsql/badges/coverage.png?b=master)](https://scrutinizer-ci.com/g/dazzle-php/pgsql/?branch=master)

[![Code Quality](https://scrutinizer-ci.com/g/dazzle-php/pgsql/badges/quality-score.png?b=master)](https://scrutinizer-ci.com/g/dazzle-php/pgsql/?branch=master)

[![Latest Stable Version](https://poser.pugx.org/dazzle-php/pgsql/v/stable)](https://packagist.org/packages/dazzle-php/pgsql) 

[![Latest Unstable Version](https://poser.pugx.org/dazzle-php/pgsql/v/unstable)](https://packagist.org/packages/dazzle-php/pgsql) 

[![License](https://poser.pugx.org/dazzle-php/pgsql/license)](https://packagist.org/packages/dazzle-php/pgsql/license)

> **Note:** This repository is part of [Dazzle Project](https://github.com/dazzle-php/dazzle) - the next-gen library for PHP. The project's purpose is to provide PHP developers with a set of complete tools to build functional async applications. Please, make sure you read the attached README carefully and it is guaranteed you will be surprised how easy to use and powerful it is. In the meantime, you might want to check out the rest of our async libraries in [Dazzle repository](https://github.com/dazzle-php) for the full extent of Dazzle experience.










## Description

TODO

## Feature Highlights

Dazzle PgSQL features:

TODO

## Provided Example(s)

### Quickstart

This example demonstrates how to connect to PgSQL database and print all tables stored inside it. 

```php

$loop = new Loop(new SelectLoop);

$mysql = new Database($loop, [

    'endpoint' => 'tcp://127.0.0.1:3306',

    'user'     => 'root',

    'pass'     => 'root',

    'dbname'   => 'dazzle',

]);

$mysql

    ->start()

    ->then(function() use($mysql) {

        printf("Connection has been established!\n");

        printf("Connection state is %s\n", $mysql->getState());

    })

    ->done(null, function($ex) {

        printf("Error: %s\n", var_export((string) $ex, true));

    });

$mysql->query('SHOW TABLES')

    ->then(function ($command) use ($loop) {

        $results = $command->resultRows;

        $fields  = $command->resultFields;

        printf("|%-60s|\n", str_repeat('-', 60));

        printf("|%-60s|\n", ' ' . $fields[0]['name']);

        printf("|%-60s|\n", str_repeat('-', 60));

        foreach ($results as $result)

        {

            printf("| # %-56s |\n", $result[$fields[0]['name']]);

        }

        printf("|%-60s|\n", str_repeat('-', 60));

    })

    ->then(null, function($ex) {

        printf("Error: %s\n", var_export((string) $ex, true));

    })

    ->done(function() use($loop) {

        $loop->stop();

    });

$loop->start();

```

### Additional

TODO

## Comparison

This section contains Dazzle vs React comparison many users requested. If you are wondering why this section has been created, see the [author's note](https://github.com/dazzle-php/pgsql/blob/master/NOTE.md) at the end of it.

#### Performance

TODO

#### Details

TODO

#### Note from the author

Note is available in [NOTE file](https://github.com/dazzle-php/pgsql/blob/master/NOTE.md).

## Requirements

Dazzle PgSQL requires:

* PHP-5.6 or PHP-7.0+,

* UNIX or Windows OS.

## Installation

To install this library make sure you have [composer](https://getcomposer.org/) installed, then run following command:

```

$> composer require dazzle-php/pgsql

```

## Tests

Tests can be run via:

```

$> vendor/bin/phpunit -d memory_limit=1024M

```

## Versioning

Versioning of Dazzle libraries is being shared between all packages included in [Dazzle Project](https://github.com/dazzle-php/dazzle). That means the releases are being made concurrently for all of them. On one hand this might lead to "empty" releases for some packages at times, but don't worry. In the end it is far much easier for contributors to maintain and -- what's the most important -- much more straight-forward for users to understand the compatibility and inter-operability of the packages.

## Contributing

Thank you for considering contributing to this repository! 

- The contribution guide can be found in the [contribution tips](https://github.com/dazzle-php/pgsql/blob/master/CONTRIBUTING.md). 

- Open tickets can be found in [issues section](https://github.com/dazzle-php/pgsql/issues). 

- Current contributors are listed in [graphs section](https://github.com/dazzle-php/pgsql/graphs/contributors)

- To contact the author(s) see the information attached in [composer.json](https://github.com/dazzle-php/pgsql/blob/master/composer.json) file.

## License

Dazzle PgSQL is open-sourced software licensed under the [MIT license](http://opensource.org/licenses/MIT).





"Everything is possible. The impossible just takes longer." ― Dan Brown