(PHP 4, PHP 5, PHP 7)
pg_connect — Abre una conexión a PostgreSQL
$connection_string
[, int $connect_type
] ) : resource
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ámetro connect_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.
Si PGSQL_CONNECT_ASYNC es dado, entonces la conexión
es establecida asincrónicamente. El estado de la conexión
puede comprobarse a través de pg_connect_poll() o
pg_connection_status().
El recurso de conexión PostgreSQL en caso de éxito, FALSE en caso de fallo.
| Versión | Descripción |
|---|---|
| 5.6.0 |
El soporte para la constante PGSQL_CONNECT_ASYNC
se ha añadido con el parametro connect_type.
|
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 por el puerto 5432 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
?>