pg_pconnect
(PHP 4, PHP 5, PHP 7, PHP 8)
pg_pconnect —
Establece una conexión PostgreSQL persistente
Descripción
Si se realiza una segunda llamada a pg_pconnect() con el mismo
connection_string como una conexión
existente, se devolverá la conexión existente a menos que se pase
PGSQL_CONNECT_FORCE_NEW a
flags.
Para activar las conexiones persistentes, la directiva de configuración
pgsql.allow_persistent
del php.ini debe establecerse en On (que es su valor por omisión).
El número máximo de conexiones puede limitarse mediante
la directiva de configuración
pgsql.max_persistent
en el archivo php.ini (por omisión, su valor es -1, es decir, sin límite).
El número total de conexiones puede configurarse con la directiva
pgsql.max_links del archivo
php.ini.
pg_close() no cerrará las conexiones persistentes
generadas por pg_pconnect().
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 escaparse con una barra invertida, es decir
\' y \\.
Las palabras clave actualmente reconocidas son :
host, hostaddr,
port,
dbname, 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.
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.
Valores devueltos
Devuelve una instancia de PgSql\Connection en caso de éxito, o false si ocurre un error.
Ejemplos
Ejemplo #1 Ejemplo con pg_pconnect()
<?php
// conexión a una base de datos llamada "marie"
$dbconn = pg_pconnect("dbname=marie");
// conexión a una base de datos llamada "marie" en el host "localhost" en el puerto "5432"
$dbconn2 = pg_pconnect("host=localhost port=5432 dbname=marie");
// conexión a una base de datos llamada "marie" en el host "mouton" con un
// nombre de usuario y una contraseña
$dk
// conexión a una base de datos llamada "test" 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_pconnect($conn_string);
?>
