pg_connect

pg_connect(string $connection_string, [int $flags]): PgSql\Connection
```php

`pg_connect` abre una conexión a una base de datos PostgreSQL mediante la cadena de conexión `connection_string`.

Si se realiza una segunda llamada a `pg_connect` con los mismos argumentos, no se establecerá una nueva conexión a menos que se pase `PGSQL_CONNECT_FORCE_NEW` a `flags`, pero se devolverá la conexión anterior.

La antigua sintaxis `$conn = pg_connect("host", "port", "options", "tty", "dbname")` está obsoleta.

## Parámetros

`connection_string`  
La cadena `connection_string` puede estar vacía para utilizar todos los parámetros por omisión o puede contener uno o varios parámetros de configuración separados por espacios. Cada parámetro de configuración tiene la forma `code = valor`. Los espacios alrededor del signo igual son opcionales. Para escribir un valor vacío o un valor que contenga espacios, rodee este valor con comillas simples, por ejemplo: `code = 'un valor'`. Las comillas simples y las barras invertidas dentro del valor deben escapar con una barra invertida, es decir \\ y \\.

Las palabras clave actualmente reconocidas son : `host`, `hostaddr`, `port`, `dbname` (valor por omisión: `user`), `user`, `password`, `connect_timeout`, `options`, `tty` (ignorado), `sslmode`, `requiressl` (obsoleto, utilice `sslmode`) y `service`. La lista de estos argumentos depende de la versión del servidor PostgreSQL.

El parámetro `options` puede utilizarse para pasar parámetros para la línea de comandos que invoca al servidor.

`flags`  
Si `PGSQL_CONNECT_FORCE_NEW` se pasa como argumento, entonces se creará una nueva conexión, incluso si la cadena `connection_string` es idéntica a la de la conexión existente.

Si `PGSQL_CONNECT_ASYNC` se proporciona, la conexión se establecerá de forma asíncrona. El estado de la conexión puede verificarse mediante la función `pg_connect_poll` o mediante la función `pg_connection_status`.

## Valores devueltos

Devuelve una instancia de `PgSql\Connection` en caso de éxito, o `false` si ocurre un error.

## Historial de cambios

| Versión | Descripción |
|----|----|
| 8.1.0 | Ahora devuelve una instancia de `PgSql\Connection` ; anteriormente, se devolvía un `resource`. |

## Ejemplos

Ejemplo con `pg_connect`