Subversion Repositories eFlore/Projets.eflore-projets

Compare Revisions

Ignore whitespace Rev 536 → Rev 974

/tags/v5.2-alpage/services/modules/0.1/wikipedia/Textes.php
New file
0,0 → 1,80
<?php
// declare(encoding='UTF-8');
/**
* Classe implémentant l'API d'eFlore Textes pour le projet WIKIPEDIA.
*
* @see http://www.tela-botanica.org/wikini/eflore/wakka.php?wiki=EfloreApi01Textes
*
* @package eFlore/services
* @author Jean-Pascal MILCENT <jpm@tela-botanica.org>
* @license GPL v3 <http://www.gnu.org/licenses/gpl.txt>
* @license CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt>
* @version 1.0
* @copyright 1999-2012 Tela Botanica (accueil@tela-botanica.org)
*/
class Textes extends Commun{
 
protected $parametres = array();
protected $ressources = array();
protected $service = 'textes';
 
public function consulter($ressources, $parametres) {
$this->parametres = $parametres;
$this->ressources = $ressources;
 
$this->analyserRessources();
$resultat = $this->executerSousService();
 
return $resultat;
}
 
private function analyserRessources() {
$nbreRessources = count($this->ressources);
if ($nbreRessources == 0) {
$message = "A implémenter : listes des pages trouvées";
$code = RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE;
throw new Exception($message, $code);
} else if ($nbreRessources == 1) {
if ($this->etreRessourceIdentifiants(0)) {
$this->sousService = 'Page';
} else {
$message = "La ressource n°1 '{$this->ressources[0]} indiquée n'est pas valable.";
$code = RestServeur::HTTP_CODE_MAUVAISE_REQUETE;
throw new Exception($message, $code);
}
} else if ($nbreRessources > 1) {
$message = "Les ressources indiquées ne sont pas valables.";
$code = RestServeur::HTTP_CODE_MAUVAISE_REQUETE;
throw new Exception($message, $code);
}
}
 
private function etreRessourceIdentifiants($position) {
$ok = true;
if (isset($this->ressources[$position])) {
$ids = $this->ressources[$position];
$supraSpPattern = "[A-Z][a-z]+";
$spPattern = "{$supraSpPattern}_[a-z]+";
$pagePattern = "/^(?:$supraSpPattern|$spPattern)$/i";
$ok = preg_match($pagePattern, $ids) ? true : false;
}
return $ok;
}
 
private function executerSousService() {
if (isset($this->sousService)) {
$classe = $this->sousService.'Textes';
require_once dirname(__FILE__).DS.'textes'.DS.$classe.'.php';
$sousService = new $classe($this->ressources, $this->parametres, new Conteneur());
$resultat = $sousService->consulter();
} else {
$message = "L'analyse des ressources n'a pu aboutir à déterminer le sous service à exécuter.";
$code = RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE;
throw new Exception($message, $code);
}
return $resultat;
}
 
 
}
?>
/tags/v5.2-alpage/services/modules/0.1/wikipedia/NomCommune.php
New file
0,0 → 1,127
<?php
// declare(encoding='UTF-8');
/**
* Classe permettant d'obtenir le nom et le code INSEE des communes les plus proches d'un point (latitude et longitude).
* La latitude et longitude doivent être exprimée par un nombre décimal.
* Ce service fonctionne uniquement sur les communes des DROM-COM présentent
* sur Wikipedia FR à cette adrese : http://fr.wikipedia.org/
* Source des données : Wikipedia http://fr.wikipedia.org/
* Paramètres du service :
* - lat : latitude
* - lon : longitude
* Exemple :
* http://localhost/service:eflore:0.1/wikipedia/nom-commune?lat=44.71546&lon=3.84216
*
* @category php 5.2
* @package lion1906
* @author Mohcen BENMOUNAH <mohcen@tela-botanica.org>
* @author Jean-Pascal MILCENT <jpm@tela-botanica.org>
* @copyright Copyright (c) 2010, Tela Botanica (accueil@tela-botanica.org)
* @license http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL
* @license http://www.gnu.org/licenses/gpl.html Licence GNU-GPL
* @version $Id$
*/
class NomCommune {
 
const PATTERN_LAT = '/^[0-9]+(?:[.][0-9]+|)$/';
const PATTERN_LON = '/^[-]?[0-9]+(?:[.][0-9]+|)$/';
const NBRE_COMMUNE_PAR_DEFAUT = 10;
const NBRE_COMMUNE_MAX = 100;
const MIME_JSON = 'application/json';
private $bdd = null;
 
public function __construct(Bdd $bdd) {
$this->bdd = $bdd;
}
 
public function consulter($ressources, $parametres) {
$this->parametres = $parametres;
$this->ressources = $ressources;
 
$this->definirParametresParDefaut();
$this->verifierParametres();
 
$nomINSEEs = $this->trouverCommunesProches();
$corps = $this->formaterResultats($nomINSEEs);
 
$resultat = new ResultatService();
$resultat->mime = self::MIME_JSON;
$resultat->corps = $corps;
return $resultat;
}
 
private function definirParametresParDefaut() {
if (array_key_exists('nbre', $this->parametres) === false) {
$this->parametres['nbre'] = self::NBRE_COMMUNE_PAR_DEFAUT;
}
}
 
private function verifierParametres() {
extract($this->parametres);
$messages = array();
if (! array_key_exists('lat', $this->parametres)) {
$messages[] = "Vous devez indiquer une latitude en degré décimal à l'aide du paramètres d'url : lat";
} else if (!preg_match(self::PATTERN_LAT, $lat)) {
$messages[] = "La valeur de latitude doit être un nombre décimal dont le séparateur décimal est un point. Ex. : 44 ou 43.03";
}
if (! array_key_exists('lon', $this->parametres)) {
$messages[] = "Vous devez indiquer une longitude en degré décimal à l'aide du paramètres d'url : lon";
} else if (!preg_match(self::PATTERN_LON, $lon)) {
$messages[] = "La valeur de longitude doit être un nombre décimal dont le séparateur décimal est un point. Ex. : -4.03 ou 3.256";
}
if (array_key_exists('nbre', $this->parametres)) {
if (!preg_match('/^[0-9]+$/', $nbre)) {
$messages[] = "Le nombre de commune le plus proche à retourner doit être un entier positif. Ex. : 10";
} else if ($nbre > self::NBRE_COMMUNE_MAX) {
$messages[] = "Le nombre de commune le plus proche à retourner doit être un entier positif inférieur à {self::NBRE_COMMUNE_MAX}. Ex. : 10";
}
}
 
if (count($messages) != 0) {
$message = implode('<br />', $messages);
$code = RestServeur::HTTP_CODE_MAUVAISE_REQUETE;
throw new Exception($message, $code);
}
}
 
private function formaterResultats($nomINSEEs) {
$communes_trouvees = null;
if (isset($nomINSEEs) && !empty($nomINSEEs)) {
foreach ($nomINSEEs as $nomINSEE) {
$communes_trouvees[] = array('nom' => $nomINSEE['nom'], 'codeINSEE' => $nomINSEE['code_insee']);
}
if (!is_null($communes_trouvees)) {
if ($this->parametres['nbre'] == 1 && count($communes_trouvees) == 1) {
$communes_trouvees = $communes_trouvees[0];
}
} else {
$message = "Le service '".get_class($this)."' n'a trouvé aucune commune correspondant aux coordonnées : {$parametres['lat']}, {$parametres['lon']}.";
$code = RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE;
throw new Exception($message, $code);
}
} else {
$message = "Le service '".get_class($this)."' n'a trouvé aucune commune dont le centroïde correspond aux coordonnées : {$parametres['lat']}, {$parametres['lon']}.";
$code = RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE;
throw new Exception($message, $code);
}
return $communes_trouvees;
}
 
/**
* requête qui récupère les 20 communes les plus proches du point recherché
* La distance(AB = \sqrt{(x_B-x_A)^2 + (y_B-y_A)^2}) est calculée sans la racine
* (calcul en plus qui change pas le résultat).
*/
private function trouverCommunesProches() {
$lat = $this->parametres['lat'];
$lon = $this->parametres['lon'];
$requete = "SELECT (({$lat} - X(centroide)) * ({$lat} - X(centroide)) + ({$lon} - Y(centroide)) * ({$lon} - Y(centroide))) AS distance, ".
"code_insee, nom ".
'FROM wikipedia_communes_v2011 '.
'ORDER BY distance '.
"LIMIT {$this->parametres['nbre']} ";
$resultat = $this->bdd->recupererTous($requete);
return $resultat;
}
}
?>
/tags/v5.2-alpage/services/modules/0.1/wikipedia/textes/PageTextes.php
New file
0,0 → 1,132
<?php
class PageTextes {
 
private $parametres = array();
private $ressources = array();
 
const MIME_JSON = 'application/json';
const PRESENCE_CHOROLOGIE = '1';
 
private $retourFormatsSupportes = array(self::MIME_JSON);
private $txtFormatsSupportes = array('txt', 'htm');
private $serviceUrl = null;
private $idPage = null;
private $wpBot = null;
private $infosPage = null;
 
public function __construct($ressources, $parametres, Conteneur $conteneur) {
$this->parametres = $parametres;
$this->ressources = $ressources;
 
$this->wpBot = $conteneur->getWikipediaBot();
$url = $conteneur->getParametre('url_service').DS.$this->ressources[0];
$this->serviceUrl = $conteneur->getUrl($url);
}
 
public function consulter() {
$this->idPage = $this->ressources[0];
 
$this->definirValeurParDefautDesParametres();
$this->verifierParametres();
 
$resultat = $this->obtenirResultat();
 
return $resultat;
}
 
private function definirValeurParDefautDesParametres() {
if (isset($this->parametres['retour']) == false) {
$this->parametres['retour'] = self::MIME_JSON;
}
if (isset($this->parametres['txt.format']) == false) {
$this->parametres['txt.format'] = 'txt';
}
}
 
private function verifierParametres() {
$erreurs = array();
 
if (isset($this->parametres['retour']) == false) {
$erreurs[] = "Le paramètre type de retour 'retour' est obligatoire.";
}
if ($this->verifierValeurParametreTxtFormat() == false) {
$erreurs[] = "Le format du texte '{$this->parametres['txt.format']}' n'est pas supporté.";
}
 
if (count($erreurs) > 0) {
$message = implode('<br />', $erreurs);
$code = RestServeur::HTTP_CODE_MAUVAISE_REQUETE;
throw new Exception($message, $code);
}
}
 
private function verifierValeurParametreRetour() {
return in_array($this->parametres['retour'], $this->retourFormatsSupportes);
}
 
private function verifierValeurParametreTxtFormat() {
return in_array($this->parametres['txt.format'], $this->txtFormatsSupportes);
}
 
private function obtenirResultat() {
$this->chargerPageWp();
 
$resultat = new ResultatService();
$resultat->corps = $this->infosPage;
$resultat->mime = $this->parametres['retour'];
 
return $resultat;
}
 
private function chargerPageWp() {
$options = array('langue' => 'fr');
$this->wpBot = new WikipediaBot($options);
$this->wpBot->chargerPage($this->idPage);
 
$this->infosPage['id'] = $this->idPage;
$this->infosPage['titre'] = $this->wpBot->getPageTitre();
$this->infosPage['texte'] = $this->getTxt();
 
$this->infosPage['mime'] = $this->getTypeMime();
$this->infosPage['href'] = $this->getHref();
}
 
private function getTxt() {
$txt = '';
if (isset($this->parametres['txt.section.position'])) {
$positionSection = $this->parametres['txt.section.position'];
$txt = $this->wpBot->getSectionParNumero($positionSection);
} else if (isset($this->parametres['txt.section.titre'])) {
$titreSection = $this->parametres['txt.section.titre'];
if ($titreSection == 'taxobox') {
$txt = $this->wpBot->extraireTaxobox();
} else {
$txt = $this->wpBot->getSectionParTitre($titreSection);
}
} else {
$txt = $this->wpBot->getPageTxt();
}
if ($this->parametres['txt.format'] == 'htm') {
$txt = $this->wpBot->rendre($txt);
}
return $txt;
}
 
private function getTypeMime() {
$mime = '';
if ($this->parametres['txt.format'] == 'htm') {
$mime = 'txt/html';
} else if ($this->parametres['txt.format'] == 'txt') {
$mime = 'text/plain';
}
return $mime;
}
 
private function getHref() {
$href = '';
$this->serviceUrl->setRequete($this->parametres);
$href = $this->serviceUrl->getUrl();
return $href;
}
}
?>