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

# 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.
- "longitude" : La longitude.
- "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
--- | ---
1.0.4 | Ajout de continent_code avec la bibliothèque GeoIP 1.4.3 ou supérieure uniquement
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
    )