pg_pconnect
Establece una conexión PostgreSQL persistente
&reftitle.description;
PgSql\Connectionfalsepg_pconnectstringconnection_stringintflags0pg_pconnect devuelve una instancia PgSql\Connection
de conexión persistente.
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.
&reftitle.parameters;
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.
&reftitle.returnvalues;
Devuelve una instancia de PgSql\Connection en caso de éxito, &return.falseforfailure;.
&reftitle.changelog;
&Version;&Description;8.1.0
Ahora devuelve una instancia de PgSql\Connection ;
anteriormente, se devolvía un &resource;.
&reftitle.examples;
Ejemplo con pg_pconnect
]]>
&reftitle.seealso;
pg_connect
Conexiones Persistentes