(PHP 4, PHP 5, PHP 7, PHP 8)
pg_pconnect — Abre una conexión persistente a PostgreSQL
pg_pconnect() Abre una conexión con una base de datos PostgreSQL. Devuelve un recurso de conexión que es necesario por otras funciones para PostgreSQL.
Si se hace una segunda llamada a la función pg_pconnect() con la misma connection_string
y hay una conexión existente, la conexión existente será devuelta a menos que pase la constante PGSQL_CONNECT_FORCE_NEW
como connect_type
.
Para habilitar la conexión persistente, la directiva de php.inipgsql.allow_persistent se debe establecer en "On" (que es el predeterminado). El número máximo de conexiones persistentes se pueden definir con la directiva de php.inipgsql.max_persistent (por defecto es -1 para sin límite). El número total de conexiones se pueden establecer con la directiva de php.inipgsql.max_links.
pg_close() no cerrará enlaces persistentes generados por pg_pconnect().
connection_string
El parametro connection_string
puede estar vacío para usar todos los parámetros por defecto, o puede contener uno o más parámetros separados por espacios en blanco. Cada ajuste de parámetros se encuentra en la forma keyword = value
. Los espacios alrededor del signo igual son opcionales. Para escribir un valor vacío o un valor que contiene espacios, hay que encerrarlo entre comillas simples, por ejemplo, keyword = 'a value'
. Las comillas simples y barras invertidas en el valor se pueden colocar utilizando el caracter de escapado barra invertida, es decir, \'y \\.
Las palabras clave reconocidas actualmente como parámetros son: host
, hostaddr
, port
, dbname
, user
, password
, connect_timeout
, options
, tty
(ignored), sslmode
, requiressl
(obsoleto a favor de sslmode
), y service
. Cada uno de estos argumentos existen dependiendo de su versión de PostgreSQL.
connect_type
Si PGSQL_CONNECT_FORCE_NEW
es pasado, entonces una nueva conexión es creada, inclusive si la connection_string
es idéntica a la de la conexión existente.
Recurso de conexión PostgreSQL en caso de éxito, false
en caso de fallo.
Ejemplo #1 Usando pg_pconnect()
<?php
$dbconn = pg_pconnect("dbname=mary");
//conectar a la base de datos llamada "mary"
$dbconn2 = pg_pconnect("host=localhost port=5432 dbname=mary");
// conectar a la base de datos llamada "mary" en "localhost" en el puerto "5432"
$dbconn3 = pg_pconnect("host=sheep port=5432 dbname=mary user=lamb password=foo");
//conectar a la base de datos llamada "mary" en el host "sheep" con usuario y password
$conn_string = "host=sheep port=5432 dbname=test user=lamb password=bar";
$dbconn4 = pg_pconnect($conn_string);
//conectar a la base de datos llamada "test" en el host "sheep" con usuario y password
?>