Retorna o nome do host associado à conexão

# pg_host

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

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

### Descrição

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

  Aviso

  A partir do PHP 8.1.0, usar a conexão padrão foi descontinuado.

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

Exemplo #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

- pg_connect() - Abre uma conexão PostgreSQL
- pg_pconnect() - Abre uma conexão PostgreSQL persistente

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open