Subversion Repositories eFlore/Projets.eflore-projets

Rev

Go to most recent revision | Details | Last modification | View Log | RSS feed

Rev Author Line No. Line
106 aurelien 1 
<?php
118 jpm 2 
// declare(encoding='UTF-8');
3 
/**
4 
* Classe implémentant l'API d'eFlore Images pour le projet CEL.
5 
*
6 
* @see http://www.tela-botanica.org/wikini/eflore/wakka.php?wiki=EfloreApi01Images
7 
*
8 
* @package eFlore/services
9 
* @author Jean-Pascal MILCENT <jpm@tela-botanica.org>
10 
* @author Aurélien PERONNET <aurelien@tela-botanica.org>
11 
* @license GPL v3 <http://www.gnu.org/licenses/gpl.txt>
12 
* @license CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt>
13 
* @version 1.0
14 
* @copyright 1999-2011 Tela Botanica (accueil@tela-botanica.org)
15 
*/
16 
// TODO : Config et Outils sont des classes statiques qui doivent poser des pb pour les tests...
106 aurelien 17 
class Images {
116 jpm 18 
 
19 
	private $parametres = array();
20 
	private $ressources = array();
106 aurelien 21 
	private $Bdd;
116 jpm 22 
 
23 
	private $formats_supportes = array('image/jpeg');
24 
	private $ref_tax_demande = array();
25 
 
26 
	public function __construct(Bdd $bdd) {
27 
		$this->Bdd = $bdd;
28 
	}
29 
 
106 aurelien 30 
	public function consulter($ressources, $parametres) {
116 jpm 31 
		$this->parametres = $parametres;
32 
		$this->ressources = $ressources;
33 
 
34 
		$this->definirValeurParDefautDesParametres();
35 
		$this->verifierParametres();
36 
		$this->analyserMasqueNn();
37 
		$id_image_a_renvoyer = $this->obtenirIdImageAuHasardPourNumNom();
38 
		$image = $this->recupererImageBinaire($id_image_a_renvoyer);
39 
 
40 
		$resultat = new ResultatService();
41 
		$resultat->mime = 'image/jpeg';
42 
		$resultat->corps = $image;
43 
		return $resultat;
106 aurelien 44 
	}
116 jpm 45 
 
46 
	private function definirValeurParDefautDesParametres() {
47 
		if (isset($this->parametres['retour']) == false) {
48 
			$this->parametres['retour'] = 'image/jpeg';
106 aurelien 49 
		}
116 jpm 50 
		if (isset($this->parametres['retour.format']) == false) {
51 
			$this->parametres['retour.format'] = 'M';
106 aurelien 52 
		}
53 
	}
116 jpm 54 
 
55 
	private function verifierParametres() {
56 
		$erreurs = array();
57 
 
58 
		if (isset($this->parametres['masque.nn']) == false) {
59 
			$erreurs[] = "Le paramètre masque.nn est obligatoire.";
106 aurelien 60 
		} else {
116 jpm 61 
			if ($this->verifierMasqueNnAutoriseActuellement() == false) {
62 
				$erreurs[] = "Le paramètre masque.nn peut contenir une seule valeur numérique pour l'instant.";
63 
			} else if ($this->verifierValeurParametreMasqueNn() == false) {
64 
				$erreurs[] = "Le paramètre masque.nn est mal formé.";
106 aurelien 65 
			}
66 
		}
116 jpm 67 
		if (isset($this->parametres['retour']) == false) {
68 
			$erreurs[] = "Le paramètre type de retour 'retour' est obligatoire.";
106 aurelien 69 
		}
116 jpm 70 
		if ($this->verifierValeurParametreRetour() == false) {
71 
			$erreurs[] = "Le type de retour '{$this->parametres['retour']}' n'est pas supporté";
106 aurelien 72 
		}
116 jpm 73 
		if (isset($this->parametres['retour.format']) == false) {
74 
			$erreurs[] = "Le paramètre de format de retour 'retour.format' est obligatoire.";
106 aurelien 75 
		}
116 jpm 76 
		if ($this->verifierValeurParametreFormat() == false) {
77 
			$erreurs[] = "Le type de format '{$this->parametres['retour.format']}' n'est pas supporté";
78 
		}
79 
 
80 
		if (count($erreurs) > 0) {
81 
			$message = implode('<br />', $erreurs);
82 
			$code = RestServeur::HTTP_CODE_MAUVAISE_REQUETE;
83 
			throw new Exception($message, $code);
84 
		}
106 aurelien 85 
	}
116 jpm 86 
 
87 
	private function verifierValeurParametreRetour() {
88 
		return in_array($this->parametres['retour'], $this->formats_supportes);
106 aurelien 89 
	}
116 jpm 90 
 
91 
	private function verifierValeurParametreFormat() {
118 jpm 92 
		$formats = Outils::recupererTableauConfig('Images.formats');
116 jpm 93 
		$ok = array_key_exists($this->parametres['retour.format'], $formats);
94 
		return $ok;
106 aurelien 95 
	}
116 jpm 96 
 
97 
	private function verifierMasqueNnAutoriseActuellement() {
98 
		$ok = is_numeric($this->parametres['masque.nn']) ? true : false;
99 
		return $ok;
106 aurelien 100 
	}
116 jpm 101 
 
102 
	private function verifierValeurParametreMasqueNn() {
103 
		$nn = $this->parametres['masque.nn'];
104 
		$projetPattern = '(?:(?:[A-Z0-9]+:)?(?:[0-9]+,)*[0-9]+)';
105 
		$patternComplet = "/$projetPattern(?:;$projetPattern)*/i";
106 
		$ok = preg_match($patternComplet, $nn) ? true : false;
107 
		return $ok;
106 aurelien 108 
	}
116 jpm 109 
 
110 
	private function analyserMasqueNn() {
111 
		$nn = $this->parametres['masque.nn'];
112 
		if (is_numeric($nn)) {
113 
			$this->ref_tax_demande['bdtfx'] = $nn;
106 aurelien 114 
		} else {
116 jpm 115 
			// ceci contient potentiellement des formes ref_tax1:nn1,nn2;ref_tax2:nn3,nn4
116 
			$projetsListeEtNumNoms = explode(';', $nn);
117 
			if (count($projetsListeEtNumNoms) > 0) {
118 
				foreach ($projetsListeEtNumNoms as $projetEtNumNoms) {
119 
					list($projet, $numNoms) = explode(':', $projetEtNumNoms);
120 
					$this->ref_tax_demande[$projet] = explode(',', $numNoms);
106 aurelien 121 
				}
122 
			}
123 
		}
124 
	}
116 jpm 125 
 
126 
	private function obtenirIdImageAuHasardPourNumNom() {
127 
		$numNom = $this->Bdd->proteger($this->ref_tax_demande['bdtfx']);
128 
 
106 aurelien 129 
		//TODO: modifier la requete lors du passage à la nouvelle base de données pour faire quelque chose
130 
		// du numéro nomenclatural + modifier les champs appelés pour le nouveau format
126 jpm 131 
		$requete = 	'SELECT  coi.coi_ce_image AS id_image '.
116 jpm 132 
			'FROM cel_obs_images AS coi '.
126 jpm 133 
			'	LEFT JOIN cel_inventory AS ci '.
134 
					'ON (coi.coi_ce_observation = ci.ordre AND coi.coi_ce_utilisateur = ci.identifiant) '.
116 jpm 135 
			'WHERE ci.transmission = 1 '.
126 jpm 136 
			"	AND ci.num_nom_ret IN ($numNom) ";
116 jpm 137 
 
138 
		$resultat = $this->Bdd->recupererTous($requete);
139 
 
140 
		if (!is_array($resultat) || count($resultat) <= 0) {
126 jpm 141 
			$message = "Aucune image ne correspond au numéro numenclatural $refTax:$numNom";
116 jpm 142 
			$code = RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE;
143 
			throw new Exception($message, $code);
106 aurelien 144 
		}
116 jpm 145 
 
146 
		$id_image_hasard = $resultat[array_rand($resultat)]['id_image'];
106 aurelien 147 
		return $id_image_hasard;
148 
	}
116 jpm 149 
 
150 
	private function recupererImageBinaire($id_image) {
151 
		$image = '';
152 
		$chemin = $this->obtenirCheminImage($id_image);
118 jpm 153 
		$image = file_get_contents($chemin);
154 
		if ($image === false) {
116 jpm 155 
			$message = "L'image demandée est introuvable sur le serveur : $chemin";
156 
			$code = RestServeur::HTTP_CODE_RESSOURCE_INTROUVABLE;
157 
			throw new Exception($message, $code);
106 aurelien 158 
		}
116 jpm 159 
		return $image;
106 aurelien 160 
	}
116 jpm 161 
 
127 jpm 162 
	private function obtenirCheminImage($idImage) {
116 jpm 163 
		$nom = $this->convertirIdImageVersNomFichier($idImage);
164 
		$dossier = $this->convertirIdImageVersChemin($idImage);
106 aurelien 165 
		return $dossier.'/'.$nom;
166 
	}
116 jpm 167 
 
127 jpm 168 
	private function convertirIdImageVersNomFichier($idImage) {
116 jpm 169 
		$codeImage = $this->construireCodeImage($idImage);
170 
		$nom_fichier = $codeImage.'.jpg';
106 aurelien 171 
		return $nom_fichier;
172 
	}
116 jpm 173 
 
174 
	private function convertirIdImageVersChemin($idImage) {
175 
		$codeImage = $this->construireCodeImage($idImage);
176 
		list($dossierNiveau1, $dossierNiveau2, $idFichier, $format) = explode('_', $codeImage);
118 jpm 177 
		$chemin_base = Config::get('Images.chemin');
116 jpm 178 
		$chemin_sur_serveur = $chemin_base.'/'.$dossierNiveau1.'/'.$dossierNiveau2.'/'.$format;
179 
		return $chemin_sur_serveur;
106 aurelien 180 
	}
116 jpm 181 
 
182 
	private function construireCodeImage($idImage) {
183 
		$codeImage = sprintf('%09s', $idImage);
184 
		$codeImage = wordwrap($codeImage, 3, '_', true);
185 
		$format = $this->parametres['retour.format'];
186 
		$codeImage .= '_'.$format;
187 
		return $codeImage;
106 aurelien 188 
	}
189 
}
190 
?>