Abre uma conexão PostgreSQL

Descrição

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

pg_connect() abre uma conexão com um banco de dados PostgreSQL especificado pelo connection_string.

Se uma segunda chamada for feita para pg_connect() 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.

A sintaxe antiga com múltiplos parâmetros $conn = pg_connect("host", "port", "options", "tty", "dbname") foi descontinuada.

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 (o padrão é o valor de user), user, password, connect_timeout, options, tty (ignorado), sslmode, requiressl (descontinuado em favor de sslmode) e service. Quais desses argumentos existem depende da sua versão do PostgreSQL.

O parâmetro options pode ser usado para definir parâmetros de linha de comando a serem invocados pelo servidor.

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.

Se PGSQL_CONNECT_ASYNC for fornecido, então a conexão será estabelecida de forma assíncrona. O estado da conexão pode então ser verificado via pg_connect_poll() ou pg_connection_status().

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 Usanso pg_connect()

<?php
$dbconn = pg_connect("dbname=mary");
//conecta-se a um banco de dados chamado "mary"

$dbconn2 = pg_connect("host=localhost port=5432 dbname=mary");
//conecta-se a um banco de dados chamado "mary" em "localhost" na porta "5432"

$dbconn3 = pg_connect("host=sheep port=5432 dbname=mary user=lamb password=foo");
///conecta-se a um banco de dados chamado "mary" no host "sheep" com um usuário e senha

$conn_string = "host=sheep port=5432 dbname=test user=lamb password=bar";
$dbconn4 = pg_connect($conn_string);
//conecta-se a um banco de dados chamado "test" no host "sheep" com um usuário e senha

$dbconn5 = pg_connect("host=localhost options='--client_encoding=UTF8'");
//conecta-se a um banco de dados em "localhost" e define o parâmetro da linha de comando que informa que a codificação está em UTF-8
?>

Veja Também

pg_pconnect() - Abre uma conexão PostgreSQL persistente
pg_close() - Fecha uma conexão PostgreSQL
pg_host() - Retorna o nome do host associado à conexão
pg_port() - Retorne o número da porta associada à conexão
pg_tty() - Retorna o nome TTY associado à conexão
pg_options() - Obtém as opções associadas à conexão
pg_dbname() - Obtém o nome do banco de dados