Documentation

Documentation de Net_I2C
Code source de Net_I2C

Documentation de Net_I2C

Description

Cette classe est une interface entre le site utilisateur et les services i2c. Elle permet d’obtenir le code ISO (deux lettres) du pays de l’adresse IP (v4 ou v6) fournie.

Deux modes de connexion disponibles :

SOAP (par défaut)
HTTP (requête GET)

Ainsi, après la création simple de l’instance Net_I2C, vous pouvez obtenir le pays d’origine de n’importe quelle adresse IP (v4 comme v6) de cette manière: <?php $i2c = new Net_I2C(‘soap’); // ou ‘http’ $country = $i2c->getCountry(’12.34.56.78′); var_dump($country); ?> Affiche: string(2) "us"

author: Samuel ROZE <samuel.roze@d-sites.com>
copyright: 2009 Samuel ROZE
link: http://pear.php.net/package/Net_I2C
link: http://www.d-sites.com/projets/i2c/
link: http://www.d-sites.com/librairies/Net_I2C/

Résumé des variables

public string $methode

private boolean $_connected

private array $_methodes

Résumé des méthodes

public Net_I2C __construct([ string $methode = 'soap' ])

public string(2) getCountry( string $adresse_ip )

private boolean _connectWithHTTP()

private boolean _connectWithSOAP()

private void _connexion()

private string _getCountryWithHTTP( string $adresse_ip )

private string _getCountryWithSOAP( string $adresse_ip )

Variables

public string $methode (line 63 )

Méthode de connexion choisie pour cette instance de Net_I2C

var: Méthode de connexion
access: public

private boolean $_connected = false (line 56 )

Détermine si l’on est connecté à l’API ou non…

var: True == Connecté, False == Non Connecté
access: private

private array $_methodes = array(‘soap’ =>… (line 38 )

Contient la liste des méthodes de connexion autorisées comme clé et comme valeur un tableau associatif de la fonction à utiliser pour la récupération, la fonction à utiliser pour la connexion ainsi que de l’URL du service.

var: Méthodes de connexion disponibles
access: private

Méthodes

Constructeur __construct (line 74)

Constructeur de Net_I2C.

throws: Exception quand la méthode est invalide
access: public

Net_I2C__construct([string $methode = 'soap'])

string$methode: Méthode de connexion

public getCountry (line 91)

Retourne le pays en fonction de l’adresse IP fournie.

return: Pays de l’IP
throws: Exception si la fonction de récupération n’éxiste pas.
access: public

string(2)getCountry(string $adresse_ip)

string$adresse_ip: Adresse IP v4 ou v6

private _connectWithHTTP (line 193)

Connexion via HTTP.

En réalité, cette fonction ne fait rien puisqu’il ne faut pas se connecter avant pour utiliser HTTP.

return: = true
access: private

boolean_connectWithHTTP()

private _connectWithSOAP (line 173)

Connexion à l’API i2c avec SOAP

return: = true
throws: Exception si la connexion à échoué.
access: private

boolean_connectWithSOAP()

private _connexion (line 154)

Appelle la fonction de connexion spécifique à la méthode utilisée.

throws: Exception si la fonction de connexion définie par la méthode n’éxiste pas
access: private

void_connexion()

private _getCountryWithHTTP (line 131)

Récupèrer le pays de l’IP en HTTP

return: Pays de l’IP
access: private

string_getCountryWithHTTP(string $adresse_ip)

string$adresse_ip: Adresse IP

private _getCountryWithSOAP (line 114)

Récupèrer le pays en utilisant SOAP

return: Pays de l’IP
access: private

string_getCountryWithSOAP(string $adresse_ip)

string$adresse_ip: Adresse IP

Code source de Net_I2C

<?php
/**
* Cette classe est une interface entre le site utilisateur et les services i2c. Elle
* permet d’obtenir le code ISO (deux lettres) du pays de l’adresse IP (v4 ou v6) fournie.
* Deux modes de connexion disponibles :
* - SOAP (par défaut)
* - HTTP (requête GET)
*
* Ainsi, après la création simple de l’instance Net_I2C, vous pouvez obtenir le pays
* d’origine de n’importe quelle adresse IP (v4 comme v6) de cette manière:
* <?php
* $i2c = new Net_I2C(‘soap’); // ou ’http’
* $country = $i2c->getCountry(’12.34.56.78′);
* var_dump($country);
* ?>
* Affiche: string(2) "us"
*
* @category Net
* @package Net_I2C
* @author Samuel ROZE <samuel.roze@d-sites.com>
* @link http://www.d-sites.com/projets/i2c/
* @link http://www.d-sites.com/librairies/Net_I2C/
* @link http://pear.php.net/package/Net_I2C
*
*/
class Net_I2C
{
// {{{ properties
/**
* Contient la liste des méthodes de connexion autorisées comme clé
* et comme valeur un tableau associatif de la fonction à utiliser
* pour la récupération, la fonction à utiliser pour la connexion
* ainsi que de l’URL du service.
*
* @var array Méthodes de connexion disponibles
*/
private $_methodes = array(
‘soap’ => array(
‘func_connect’ => ‘_connectWithSOAP’,
‘func_get’ => ‘_getCountryWithSOAP’,
‘url’ => ‘http://i2c.mes-stats.fr/i2c.wsdl’
),
‘http’ => array(
‘func_connect’ => ‘_connectWithHTTP’,
‘func_get’ => ‘_getCountryWithHTTP’,
‘url’ => ‘http://i2c.mes-stats.fr/get?ip=’
)
);
/**
* Détermine si l’on est connecté à l’API ou non…
*
* @var boolean True == Connecté, False == Non Connecté
*/
private $_connected = false;
/**
* Méthode de connexion choisie pour cette instance de Net_I2C
*
* @var string Méthode de connexion
*/
public $methode;
// }}}
// {{{ __construct()
/**
* Constructeur de Net_I2C.
*
* @param string $methode Méthode de connexion
* @return Net_I2C
* @throws Exception quand la méthode est invalide
*/
public function __construct($methode = ‘soap’)
{
if (!array_key_exists($methode, $this->_methodes)) {
throw new Exception(‘La méthode est invalide’, E_USER_ERROR);
}
$this->methode = $methode;
}
// }}}
// {{{ getCountry()
/**
* Retourne le pays en fonction de l’adresse IP fournie.
*
* @param string $adresse_ip Adresse IP v4 ou v6
* @return string(2) $country Pays de l’IP
* @throws Exception si la fonction de récupération n’éxiste pas.
*/
public function getCountry ($adresse_ip)
{
if (!$this->_connected) {
$this->_connexion();
}
$function = $this->_methodes[$this->methode]['func_get'];
if (!($country = $this->$function($adresse_ip))) {
throw new Exception(‘La fonction de récupération n’éxiste pas’, E_USER_ERROR);
}
return $country;
}
// }}}
// {{{ _getCountryWithSOAP()
/**
* Récupèrer le pays en utilisant SOAP
*
* @param string $adresse_ip Adresse IP
* @return string $country Pays de l’IP
*/
private function _getCountryWithSOAP ($adresse_ip) {
try {
$country = $this->_methodes['soap']['client']->getCountry($adresse_ip);
} catch (SoapFault $exception) {
throw new Exception(‘SOAP Exception: ’.$exception, E_USER_ERROR);
}
return $country;
}
// }}}
// {{{ _getCountryWithHTTP()
/**
* Récupèrer le pays de l’IP en HTTP
*
* @param string $adresse_ip Adresse IP
* @return string $country Pays de l’IP
*/
private function _getCountryWithHTTP ($adresse_ip) {
$fp = fopen ($this->_methodes['http']['url'].$adresse_ip, ‘r’);
if (!$fp) {
throw new Exception(‘Impossible d’ouvrir la connexion’, E_USER_ERROR);
}
else {
$country = fgets ($fp);
if (strlen($country) != 2) {
throw new Exception(fgets ($fp), E_USER_ERROR);
}
}
fclose($fp);
return $country;
}
// }}}
// {{{ _connexion()
/**
* Appelle la fonction de connexion spécifique à la méthode utilisée.
*
* @return void
* @throws Exception si la fonction de connexion définie par la méthode n’éxiste pas
*/
private function _connexion ()
{
$function = $this->_methodes[$this->methode]['func_connect'];
if (!$this->$function()) {
throw new Exception(‘La fonction de connexion n’éxiste pas’, E_USER_ERROR);
}
$this->_connected = true;
}
/// }}}
/// {{{ _connectWithSOAP()
/**
* Connexion à l’API i2c avec SOAP
*
* @return boolean = true
* @throws Exception si la connexion à échoué.
*/
private function _connectWithSOAP ()
{
try {
$this->_methodes['soap']['client'] = new SoapClient($this->_methodes['soap']['url']);
} catch (SoapFault $exception) {
throw new Exception(‘SOAP Exception: ’.$exception, E_USER_ERROR);
}
return true;
}
/// }}}
/// {{{ _connectWithHTTP()
/**
* Connexion via HTTP.
* En réalité, cette fonction ne fait rien puisqu’il ne faut pas se connecter
* avant pour utiliser HTTP.
*
* @return boolean = true
*/
private function _connectWithHTTP ()
{
return true;
}
/// }}}
}

D-Sites

Web, PHP, Python, …

Documentation de Net_I2C

Code source de Net_I2C

Leave a Reply Cancel reply