pg_host

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

pg_host — Retorna o nome do host associado à conexão

Descrição

pg_host(?PgSql\Connection $connection = null): string

pg_host() retorna o nome do host da instância de connection do PostgreSQL à qual está conectada.

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

Warning

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

Valor Retornado

Uma string contendo o nome do host ao qual a connection está, ou uma string vazia em caso de erro.

Registro de Alterações

Versão Descrição
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

Example #1 Exemplo de pg_host()

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

if ($pgsql_conn) {
   print "Conectado com sucesso a: " . pg_host($pgsql_conn) . "<br/>\n";
} else {
   print pg_last_error($pgsql_conn);
   exit;
}
?>

Veja Também