pg_pconnect
(PHP 4, PHP 5, PHP 7, PHP 8)
pg_pconnect — Abre uma conexão PostgreSQL persistente
Descrição
Se uma segunda chamada for feita para pg_pconnect() com
o mesmo connection_string
de uma conexão existente, a
conexão existente será retornada a menos que você passe
PGSQL_CONNECT_FORCE_NEW
como
flags
.
Para ativar a conexão persistente, a diretiva pgsql.allow_persistent
no php.ini deve ser definida como "On" (que é o padrão).
O número máximo de conexões persistentes pode ser definido com a diretiva pgsql.max_persistent
no php.ini (o padrão é -1 para nenhum limite). O número total
de conexões pode ser definido com a diretiva pgsql.max_links
no php.ini.
pg_close() não irá fechar conexões persistentes
geradas por pg_pconnect().
Parâmetros
connection_string
-
O connection_string
pode estar vazio para usar todos os parâmetros padrão ou
pode conter uma ou mais configurações de parâmetro separadas por espaços em branco.
Cada configuração de parâmetro está no formato palavra-chave = valor
. Os espaços ao redor
do sinal de igual são opcionais. Para escrever um valor vazio ou
contendo espaços, coloque-o entre aspas simples, por exemplo, palavra-chave =
'um valor'
. Aspas simples e barras invertidas dentro do valor devem ser
escapadas com uma barra invertida, ou seja, \' e \\.
As palavras-chave de parâmetro atualmente reconhecidas são:
host
, hostaddr
, port
,
dbname
, user
,
password
, connect_timeout
,
options
, tty
(ignorada), sslmode
,
requiressl
(descontinuada em favor de sslmode
), e
service
. Quais desses argumentos existem depende
da sua versão do PostgreSQL.
flags
-
Se PGSQL_CONNECT_FORCE_NEW
for passado, então uma nova conexão
será criada, mesmo que connection_string
seja idêntico a
uma conexão existente.
Exemplos
Exemplo #1 Usando pg_pconnect()
<?php
$dbconn = pg_pconnect("dbname=mary");
//conecta a um banco de dados chamado "mary"
$dbconn2 = pg_pconnect("host=localhost port=5432 dbname=mary");
//conecta a um banco de dados chamado "mary" em "localhost" na porta "5432"
$dbconn3 = pg_pconnect("host=sheep port=5432 dbname=mary user=lamb password=foo");
//conecta a um banco de dados chamado "mary" no host "sheep" com usuário e senha
$conn_string = "host=sheep port=5432 dbname=test user=lamb password=bar";
$dbconn4 = pg_pconnect($conn_string);
//conecta a um banco de dados chamado "test" no host "sheep" com usuário e senha
?>