postgres/lib/functions.php

<?php declare(strict_types = 1);

namespace Amp\Postgres;

use Interop\Async\Awaitable;

/**
 * @param string $connectionString
 * @param int $timeout
 *
 * @return \Interop\Async\Awaitable<\Amp\Postgres\Connection>
 *
 * @throws \Amp\Postgres\FailureException If connecting fails.
 * @throws \Error If neither ext-pgsql or pecl-pq is loaded.
 */
function connect(string $connectionString, int $timeout = null): Awaitable {
    if (\extension_loaded("pq")) {
        return PqConnection::connect($connectionString, $timeout);
    }
    
    if (\extension_loaded("pgsql")) {
        return PgSqlConnection::connect($connectionString, $timeout);
    }
    
    throw new \Error("This lib requires either pecl-pq or ext-pgsql");
}

/**
 * @param string $connectionString
 * @param int $maxConnections
 * @param int $connectTimeout
 *
 * @return \Amp\Postgres\Pool
 */
function pool(
    string $connectionString,
    int $maxConnections = ConnectionPool::DEFAULT_MAX_CONNECTIONS,
    int $connectTimeout = ConnectionPool::DEFAULT_CONNECT_TIMEOUT
): Pool {
    return new ConnectionPool($connectionString, $maxConnections, $connectTimeout);
}