CascadiaPHP 2024

pg_close

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

pg_closeFecha uma conexão PostgreSQL

Descrição

pg_close(?PgSql\Connection $connection = null): true

pg_close() fecha a conexão não persistente com um banco de dados PostgreSQL associado à instância de connection fornecida.

Nota:

Usar pg_close() geralmente não é necessário, pois conexões abertas não persistentes são fechadas automaticamente no final do script.

Se houver uma instância PgSql\Lob aberta na conexão, não feche a conexão antes de fechar todas as instâncias PgSql\Lob.

Parâmetros

connection

Uma instância de PgSql\Connection. Quando o parâmetro connection for null, a conexão padrão será usada. A conexão padrão é a última conexão feita por pg_connect() ou pg_pconnect().

Aviso

A partir do PHP 8.1.0, usar a conexão padrão tornou-se defasado.

Valor Retornado

Sempre retorna true.

Registro de Alterações

Versão Descrição
8.2.0 O tipo do retorno agora é true; anteriormente, era bool.
8.1.0 O parâmetro connection agora espera uma instância de PgSql\Connection; anteriormente, um resource era esperado.
8.0.0 connection agora é anulável.

Exemplos

Exemplo #1 Exemplo de pg_close()

<?php
$dbconn
= pg_connect("host=localhost port=5432 dbname=mary")
or die(
"Não foi possível conectar");
echo
"Conectado com sucesso";
pg_close($dbconn);
?>

O exemplo acima produzirá:

Conectado com sucesso

Veja Também

add a note

User Contributed Notes 2 notes

up
5
amays
18 years ago
pg_close(...) will not technically close a persistent connection but instead returns it back to the connection pool thus giving you the desired effect of having the connection closed within your script.

http://www.sitepoint.com/article/accessing-postgresql-php/3

best wishes to all.
up
2
mark at redbrick dot dcu dot ie
21 years ago
This function closes the current database connection specified by a handle returned from a pg_connect() call.

<?php
$pgsql_conn
= pg_connect("dbname=mark host=localhost");

if (
$pgsql_conn) {
print
"Successfully connected to: " . pg_host($pgsql_conn) . "<br/>\n";
} else {
print
pg_last_error($pgsql_conn);
exit;
}

// Do database stuff here.

if(!pg_close($pgsql_conn)) {
print
"Failed to close connection to " . pg_host($pgsql_conn) . ": " .
pg_last_error($pgsql_conn) . "<br/>\n";
} else {
print
"Successfully disconnected from database";
}
?>

Of course you normally wouldn't print a message.

Regards, --mark
To Top