# geoip_record_by_name

(PECL geoip >= 0.2.0)

geoip_record_by_name — Récupère les informations enregistrées correspondant au nom de l'hôte ou à l'adresse IP, trouvées dans la base de données GeoIP

### Description

geoip_record_by_name(string `$hostname`): array

La fonction geoip_record_by_name() retourne les informations enregistrées correspondant au nom de l'hôte ou à l'adresse IP.

Cette fonction est disponible pour les bases de données `GeoLite City Edition` et la version commerciale `GeoIP City Edition`. Une alerte sera émise si la base de données n'a pu être trouvée.

Les noms des différentes clés du tableau associatif retourné sont les suivantes :

- `"continent_code"` : Code du continent sur 2 lettres (disponible depuis la version 1.0.4 avec libgeoip 1.4.3 ou supérieure)
- `"country_code"` : Les deux lettres du code pays (Voir geoip_country_code_by_name())
- `"country_code3"` : Code pays sur 3 lettres (Voir la fonction geoip_country_code3_by_name())
- `"country_name"` : Nom du pays (Voir la fonction geoip_country_name_by_name())
- `"region"` : Le code région (ex: CA pour California)
- `"city"` : La ville.
- `"postal_code"` : Le code postal, FSA ou Zip.
- `"latitude"` : La latitude en tant que float signé.
- `"longitude"` : La longitude en tant que float signé.
- `"dma_code"` : Code de la zone de marché (Uniquement pour les USA et le Canada)
- `"area_code"` : Le code PSTN (ex : 212)

### Liste de paramètres

`hostname`

  Le nom de l'hôte ou l'adresse IP

### Valeurs de retour

Retourne un tableau associatif en cas de succès, ou `false` si l'adresse n'a pu être trouvée dans la base de données.

### Historique

Version | Description
--- | ---
PECL geoip 1.0.4 | Ajout de continent_code avec la bibliothèque GeoIP 1.4.3 ou supérieure uniquement
PECL geoip 1.0.3 | Ajout de country_code3 et de country_name

### Exemples

Exemple #1 Exemple avec geoip_record_by_name()

Cet exemple affiche le tableau contenant l'enregistrement de l'hôte example.com.

`<?php
$record = geoip_record_by_name('www.example.com');
if ($record) {
print_r($record);
}
?>`

L'exemple ci-dessus va afficher :

    Array
    (
        [continent_code] => NA
        [country_code] => US
        [country_code3] => USA
        [country_name] => United States
        [region] => CA
        [city] => Marina Del Rey
        [postal_code] =>
        [latitude] => 33.9776992798
        [longitude] => -118.435096741
        [dma_code] => 803
        [area_code] => 310
    )