(PHP 4, PHP 5, PHP 7, PHP 8)
pg_connect — Establece una conexión PostgreSQL
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.
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().
Devuelve una instancia de PgSql\Connection en caso de éxito, o false
en caso de error.
Versión | Descripción |
---|---|
8.1.0 | Ahora devuelve una instancia de PgSql\Connection ; anteriormente, se devolvía un recurso. |
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
?>