# pg_host

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

pg_host — Retourne le nom d'hôte

### Description

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

pg_host() retourne le nom d'hôte associé à l'instance de connexion PostgreSQL.

### Liste de paramètres

`connection`

  Une instance PgSql\Connection. Quand `connection` est `null`, la connexion par défaut est utilisé. La connexion par défaut est la dernière connexion faite par pg_connect() ou pg_pconnect()

  Avertissement

  À partir de PHP 8.1.0, utiliser la connexion par défaut est obsolète.

### Valeurs de retour

Une chaîne contenant le nom de l'ordinateur hôte de `connection` ou une chaîne vide en cas d'erreur.

### Historique

Version | Description
--- | ---
8.1.0 | Le paramètre `connection` attend désormais une instance de PgSql\Connection ; auparavant, une resource était attendu.
8.0.0 | `connection` est désormais nullable.

### Exemples

Exemple #1 Exemple avec pg_host()

`<?php
$pgsql_conn = pg_connect("dbname=mark host=localhost");
if ($pgsql_conn) {
print "Correctement connecté à : " . pg_host($pgsql_conn) . "<br/>\n";
} else {
print pg_last_error($pgsql_conn);
exit;
}
?>`

### Voir aussi

- pg_connect() - Établit une connexion PostgreSQL
- pg_pconnect() - Établit une connexion PostgreSQL persistante