(PHP 4, PHP 5, PHP 7)
pg_connect — Abrir una conexión a PostgreSQL
$connection_string
[, int $connect_type
] )
pg_connect()abre una conexión con una
base de datos PostgreSQL especificada por el
connection_string
.
Si una segunda llamada se hace a pg_connect() con
la misma connection_string
existiendo la conexión,
la conexión existente será devuelta a menos que pase la constante
PGSQL_CONNECT_FORCE_NEW
como
parámetroconnect_type
.
La sintaxis antigua con múltiples parámetros $conn = pg_connect("host", "port", "options", "tty", "dbname") ha quedado obsoleta.
connection_string
El connection_string
puede estar vacío para usar todos los parámetros por
defecto o este puede contener uno o más parámetros separados por espacios en blanco.
Cada parámetro debe asignarse de esta forma keyword = value.
Los espacios alrededor del signo igual son opcionales. Para escribir un valor vacío
o un valor conteniendo espacios utilice las comillas simples, por ejemplo. keyword =
'a value'. Las comillas simples y barras invertidas en el valor se pueden agregar
con una barra invertida es decir \' y \\.
Las palabras clave de parámetros que están reconocidos son:
host
, hostaddr
, port
,
dbname
(por defecto el valor de user
),
user
,
password
, connect_timeout
,
options
, tty
(ignorado), sslmode
,
requiressl
(en desuso en favor de sslmode
), y
service
. Cuál de estos argumentos existen depende
de su versión de PostgreSQL.
El parámetro options
se puede utilizar para establecer los
parámetros de la línea de comandos para ser invocado por el servidor.
connect_type
Si PGSQL_CONNECT_FORCE_NEW
es pasado, entonces una nueva conexión
se crea, incluso si el parámetroconnection_string
es idéntico a
la conexión existente.
El recurso de conexión PostgreSQL en caso de éxito, FALSE
en caso de fallo.
Ejemplo #1 Usando pg_connect()
<?php
$dbconn = pg_connect("dbname=mary");
//conectarse a una base de datos llamada "mary"
$dbconn2 = pg_connect("host=localhost port=5432 dbname=mary");
// conectarse a una base de datos llamada "mary" en "localhost" por el puerto "5432"
$dbconn3 = pg_connect("host=sheep port=5432 dbname=mary user=lamb password=foo");
//conectarse a una base de datos llamada "mary" en el host "sheep" con el nombre de usuario y password
$conn_string = "host=sheep port=5432 dbname=test user=lamb password=bar";
$dbconn4 = pg_connect($conn_string);
//conectarse a una base de datos llamada "test" en el host "sheep" con el nombre de usuario y password
$dbconn5 = pg_connect("host=localhost options='--client_encoding=UTF8'");
//conectarse a una base de datos en "localhost" y establece el parámetro de línea de comandos que indica la codificación en UTF8
?>