(PHP 4, PHP 5, PHP 7, PHP 8)
pg_pconnect — Abre uma conexão PostgreSQL persistente
pg_pconnect() abre uma conexão com um banco de dados PostgreSQL. Ele retorna uma instância PgSql\Connection que é necessária para outras funções do PostgreSQL.
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().
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.
Retorna uma instância PgSql\Connection em caso de sucesso, ou false
em caso de falha.
Versão | Descrição |
---|---|
8.1.0 | Retorna uma instância PgSql\Connection agora; anteriormente, um resource era retornado. |
Exemplo #1 Usando pg_pconnect()
<?php
// Conecta a um banco de dados chamado "mary"
$dbconn = pg_pconnect("dbname=mary");
// Conecta a um banco de dados chamado "mary" em "localhost" na porta "5432"
$dbconn2 = pg_pconnect("host=localhost port=5432 dbname=mary");
// Conecta a um banco de dados chamado "mary" no host "sheep" com usuário e senha
$dbconn3 = pg_pconnect("host=sheep port=5432 dbname=mary user=lamb password=foo");
//Conecta a um banco de dados chamado "test" 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);
?>