(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
$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
?>