pg_pconnect

(PHP 4, PHP 5, PHP 7, PHP 8)

pg_pconnect — Abre uma conexão PostgreSQL persistente

Descrição

pg_pconnect(string $connection_string, int $flags = 0): PgSql\Connection|false

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().

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.

Valor Retornado

Retorna uma instância PgSql\Connection em caso de sucesso, ou false em caso de falha.

Registro de Alterações

Versão Descrição
8.1.0 Retorna uma instância PgSql\Connection agora; anteriormente, um resource era retornado.

Exemplos

Example #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
?>

Veja Também