pg_connect

(PHP 4, PHP 5, PHP 7, PHP 8)

pg_connect Establece una conexión PostgreSQL

Descripción

pg_connect(string $connection_string, int $flags = 0): PgSql\Connection|false

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 en caso de error.

Historial de cambios

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

Ejemplos

Ejemplo #1 Ejemplo con pg_connect()

<?php
$dbconn
= pg_connect("dbname=marie");
// conexión a una base de datos llamada "marie"

$dbconn2 = pg_connect("host=localhost port=5432 dbname=marie");
// conexión a una base de datos llamada "marie" en el host "localhost" en el puerto "5432"

$dbconn3 = pg_connect("host=mouton port=5432 dbname=marie user=agneau password=foo");
// conexión a una base de datos llamada "marie" en el host "mouton" con un
// nombre de usuario y una contraseña

$conn_string = "host=mouton port=5432 dbname=test user=agneau password=bar";
$dbconn4 = pg_connect($conn_string);
// conexión a una base de datos llamada "test" en el host "mouton" con un
// nombre de usuario y una contraseña

$dbconn5 = pg_connect("host=localhost options='--client_encoding=UTF8'");
//conexión a la base en "localhost" y paso de un parámetro de la línea de
// comandos relacionado con la codificación UTF-8
?>

Ver también

  • pg_pconnect() - Establece una conexión PostgreSQL persistente
  • pg_close() - Finaliza una conexión PostgreSQL
  • pg_host() - Devuelve el nombre de host
  • pg_port() - Devuelve el número de puerto
  • pg_tty() - Devuelve el nombre de TTY asociado a la conexión
  • pg_options() - Devuelve las opciones de PostgreSQL
  • pg_dbname() - Devuelve el nombre de la base de datos PostgreSQL