Subversion Repositories Applications.annuaire

Rev

Rev 521 | Rev 532 | Go to most recent revision | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
454 jpm 1
<?php
2
// declare(encoding='UTF-8');
3
/**
4
 * Service retournant les prénoms et nom  d'un utilisateur en fonction de son courriel.
5
 * UNe liste de courriel peut être passé dans la ressource.
6
 * Exemple :
7
 * /utilisateur/Prenom-nom-par-courriel/jpm@tela-botanica.org,aurelien@tela-botanica.org
8
 *
9
 * @category	php 5.2
10
 * @package		Annuaire::Services
11
 * @author		Jean-Pascal MILCENT <jpm@tela-botanica.org>
12
 * @copyright	Copyright (c) 2010, Tela Botanica (accueil@tela-botanica.org)
13
 * @license		http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL
14
 * @license		http://www.gnu.org/licenses/gpl.html Licence GNU-GPL
15
 * @version		$Id$
16
 */
17
class Utilisateur extends JRestService {
18
 
19
	private $donnees = null;
20
	private $idAnnuaire = null;
21
	private $utilisateurId = null;
22
	private $metadonneeModele = null;
23
	private $annuaireModele = null;
24
	private $messagerieModele = null;
25
 
519 mathias 26
	const FORMAT_JSON = "json";
27
	const FORMAT_XML = "xml";
28
	const FORMAT_LDEHYDE = "méthanal"; // hihi hoho
29
 
454 jpm 30
	/*+----------------------------------------------------------------------------------------------------+*/
31
	// GET : consultation
32
 
33
	public function getElement($ressources){
34
		$this->ressources = $ressources;
35
		$this->idAnnuaire = Config::get('annuaire_defaut');
36
		$infos = null;
37
 
38
		if (isset($this->ressources[0])) {
39
			if (preg_match('/^[0-9]+$/', $this->ressources[0])) {
40
				// ATTENTION : Ces web services ne doivent être accessible que depuis des applis installées sur nos serveurs
41
				// pour les communications inter-serveurs.
42
				$this->controlerIpAutorisees();
43
				$infos = $this->getInfosParId($this->ressources[0]);
44
			} else {
45
				$methode_demande = array_shift($this->ressources);
46
				$methode = $this->traiterNomMethodeGet($methode_demande);
47
				if (method_exists($this, $methode)) {
525 mathias 48
					$infos = $this->$methode($this->ressources[0]);
454 jpm 49
				} else {
50
					$this->messages[] = "Ce type de ressource '$methode_demande' n'est pas disponible pour la requete GET.";
51
				}
52
			}
53
		} else {
519 mathias 54
			$this->messages[] = "Le premier paramètre du chemin du service doit correspondre au type de ressource demandée.";
454 jpm 55
		}
56
 
519 mathias 57
		// possibilité d'envoyer en plusieurs formats @TODO faire ça plus proprement
58
		$format = self::FORMAT_JSON;
59
		$dernierIndex = count($this->ressources) - 1;
60
		if ($dernierIndex >= 0) {
61
			$dernierParametre = $this->ressources[$dernierIndex];
62
			if (in_array($dernierParametre, array(self::FORMAT_JSON, self::FORMAT_XML))) {
63
				$format = $dernierParametre;
64
			}
65
		}
66
 
454 jpm 67
		if (!is_null($infos)) {
519 mathias 68
			switch ($format) {
69
				case self::FORMAT_XML :
70
					$this->envoyerXml($infos);
71
				break;
72
				case self::FORMAT_JSON :
73
				default :
74
					$this->envoyerJson($infos);
75
			}
454 jpm 76
		} else {
77
			$info = 'Un problème est survenu : '.print_r($this->messages, true);
78
			$this->envoyerTxt($info);
79
		}
80
	}
81
 
520 mathias 82
	/**
525 mathias 83
	 * Permet d'obtenir des infos pour un ou plusieurs ids utilisateurs indiqué(s) dans la ressource.
84
	 * RESSOURCE : /infos-par-ids/#id[,#id]*
85
	 * PARAMÈTRES : forceArrayOfArrays - si true, retourne un tableau associatif même s'il n'y a qu'un
86
	 * 		résultat (casse la rétrocompatibilté)
454 jpm 87
	 * RÉPONSE : Tableau possédant un courriel de la ressource en clé et en valeur :
88
	 *  - id : identifiant numérique de l'utilisateur
89
	 *  - pseudoUtilise : indique si on doit utiliser le pseudo à la place de Prénom NOM
90
	 *  - pseudo : pseudo de l'utilisateur.
91
	 *  - intitule : l'intitulé à affiche (choix auto entre "pseudo" et "prénom nom")
92
	 *  - prenom : prénom
93
	 *  - nom : nom de famille.
94
	 *  - courriel : courriel
95
	 */
525 mathias 96
	public function getInfosParIds($ids_utilisateurs, $forceArrayOfArrays = false) {
97
		$ids_utilisateurs = explode(',', $ids_utilisateurs);
98
		if (count($ids_utilisateurs) == 1) {
99
			// s'il n'y en a qu'un on ne passe pas un array
100
			$ids_utilisateurs = array_shift($ids_utilisateurs);
101
		}
102
		$infos = $this->getAnnuaire()->obtenirInfosUtilisateurParId($this->idAnnuaire, $ids_utilisateurs);
103
 
104
		foreach ($infos as $i => $info) {
105
			$infos[$i]['pseudoUtilise'] = $this->obtenirPseudoUtilise($info['id']);
106
			$infos[$i]['pseudo'] = $this->obtenirPseudo($info['id']);
107
			$infos[$i]['intitule'] = $this->formaterIntitule($infos[$i]);
108
		}
454 jpm 109
 
525 mathias 110
		// retrocompatibilité
111
		if (count($infos) == 1 && (! $forceArrayOfArrays)) {
112
			$infos = array_shift($infos);
113
		}
454 jpm 114
 
115
		return $infos;
116
	}
117
 
118
	/**
525 mathias 119
	 * Méthode rétrocompatible : appelle getInfosParIds et s'il n'y a qu'un résultat,
120
	 * ne retourne pas un tableau associatif mais un tableau simple
121
	 * @return array
122
	 */
123
	public function getInfosParId($ids_utilisateurs) {
124
		return $this->getInfosParIds($ids_utilisateurs, true);
125
	}
126
 
127
	/**
454 jpm 128
	 * Permet d'obtenir les prénoms et noms des courriels des utilisateurs indiqués dans la ressource.
129
	 * RESSOURCE : /utilisateur/prenom-nom-par-courriel/[courriel,courriel,...]
519 mathias 130
	 * PARAMÈTRES : aucun
454 jpm 131
	 * RÉPONSE : Tableau possédant un courriel de la ressource en clé et en valeur :
132
	 *  - id : identifiant numérique de l'utilisateur
133
	 *  - prenom : prénom
134
	 *  - nom : nom de famille.
135
	 */
136
	public function getPrenomNomParCourriel() {
137
		$courriels = explode(',', $this->ressources[0]);
138
		$infos = $this->getAnnuaire()->obtenirPrenomNomParCourriel($this->idAnnuaire, $courriels);
139
		return $infos;
140
	}
141
 
142
	/**
143
	 * Permet d'obtenir les identités des utilisateurs indiqués dans la ressource.
144
	 * RESSOURCE : /utilisateur/identite-par-courriel/[courriel,courriel,...]
519 mathias 145
	 * PARAMÈTRES : aucun
454 jpm 146
	 * RÉPONSE : Tableau possédant un courriel de la ressource en clé et en valeur :
147
	 *  - id : identifiant numérique de l'utilisateur
148
	 *  - pseudoUtilise : indique si on doit utiliser le pseudo à la place de Prénom NOM
149
	 *  - pseudo : pseudo de l'utilisateur.
150
	 *  - prenom : prénom
151
	 *  - nom : nom de famille.
152
	 */
153
	public function getIdentiteParCourriel() {
154
		$infos_utilisateurs = array();
155
		$utilisateurs = $this->getPrenomNomParCourriel();
156
		foreach ($utilisateurs as $courriel => $utilisateur) {
157
			$id = $utilisateur['id'];
158
			$utilisateur['pseudo'] = $this->obtenirPseudo($id);
159
			$utilisateur['pseudoUtilise'] = $this->obtenirPseudoUtilise($id);
160
			$utilisateur['intitule'] = $this->formaterIntitule($utilisateur);
488 aurelien 161
			$courriel = strtolower($courriel);
454 jpm 162
			$infos_utilisateurs[$courriel] = $utilisateur;
163
		}
164
		return $infos_utilisateurs;
165
	}
166
 
519 mathias 167
	/**
168
	 * Même principe que getIdentiteParCourriel() mais pour un seul courriel, et renvoie plus d'infos :
169
	 * RESSOURCE : /utilisateur/identite-complete-par-courriel/courriel[/format]
170
	 * PARAMÈTRES : format : "json" (par défaut) ou "xml" (pour
171
	 *   rétrocompatibilité avec le service eFlore_chatin/annuaire_tela/xxx/courriel)
172
	 * RÉPONSE : Tableau possédant un courriel de la ressource en clé et en valeur :
173
	 * - id : identifiant numérique de l'utilisateur
174
	 * - pseudoUtilise : indique si on doit utiliser le pseudo à la place de Prénom NOM
175
	 * - pseudo : pseudo de l'utilisateur.
176
	 * - prenom : prénom
177
	 * - nom : nom de famille.
178
	 * - mot_de_passe : le mot de passe haché (15% de matières grasses, peut contenir des traces de soja)
179
	 * - fonction
180
	 * - titre
181
	 * - site_web
182
	 * - adresse01
183
	 * - adresse02
184
	 * - code_postal
185
	 * - ville
186
	 * - departement
187
	 * - region
188
	 * - pays
189
	 * - date_inscription
190
	 */
191
	public function getIdentiteCompleteParCourriel() {
520 mathias 192
 
193
		$this->authentificationHttpSimple();
194
 
519 mathias 195
		$infos_utilisateurs = array();
196
		$courriel = $this->ressources[0];
197
		$utilisateur = $this->getAnnuaire()->obtenirMaximumInfosParCourriel($this->idAnnuaire, $courriel);
198
 
199
		$id = $utilisateur['id'];
200
		$utilisateur['pseudo'] = $this->obtenirPseudo($id);
201
		$utilisateur['pseudoUtilise'] = $this->obtenirPseudoUtilise($id);
202
		$utilisateur['intitule'] = $this->formaterIntitule($utilisateur);
203
 
204
		// ouksépabo
205
		$this->baliseMaitresse = "personne";
206
 
207
		return $utilisateur;
208
	}
209
 
454 jpm 210
	private function getAnnuaire() {
211
		if (!isset($this->annuaireModele)) {
212
			$this->annuaireModele = new AnnuaireModele();
213
		}
214
		return $this->annuaireModele;
215
	}
216
 
217
	private function getMeta() {
218
		if (!isset($this->metadonneeModele)) {
219
			$this->metadonneeModele = new MetadonneeModele();
220
		}
221
		return $this->metadonneeModele;
222
	}
223
 
224
	private function obtenirPseudo($id_utilisateur) {
225
		$pseudo = '';
226
		$id_champ_pseudo = $this->getMeta()->renvoyerIdChampMetadonneeParAbreviation($this->idAnnuaire, 'pseudo');
227
		if ($this->getMeta()->valeurExiste($id_champ_pseudo, $id_utilisateur)) {
228
			$pseudo = $this->getMeta()->obtenirValeurMetadonnee($id_champ_pseudo, $id_utilisateur);
229
		}
230
		return $pseudo;
231
	}
232
 
233
	private function obtenirPseudoUtilise($id_utilisateur) {
234
		$pseudo_utilise = false;
235
		$id_champ_utilise_pseudo = $this->getMeta()->renvoyerIdChampMetadonneeParAbreviation($this->idAnnuaire, 'utilise_pseudo');
236
		if ($this->getMeta()->valeurExiste($id_champ_utilise_pseudo, $id_utilisateur)) {
237
				$booleen = $this->getMeta()->obtenirValeurMetadonnee($id_champ_utilise_pseudo, $id_utilisateur);
238
				$pseudo_utilise = ($booleen == 0) ? false : true;
239
		}
240
		return $pseudo_utilise;
241
	}
242
 
243
	private function formaterIntitule($utilisateur) {
244
		$intitule = '';
245
		if ($utilisateur['pseudoUtilise'] && trim($utilisateur['pseudo']) != '') {
246
			$intitule = $utilisateur['pseudo'];
247
		} else {
248
			$intitule = $utilisateur['prenom'].' '.$utilisateur['nom'];
249
		}
250
		return $intitule;
251
	}
252
 
253
	/*+----------------------------------------------------------------------------------------------------+*/
254
	// POST : mise à jour
255
 
256
	public function updateElement($ressources, $donnees) {
257
		$this->ressources = $ressources;
258
		$this->donnees = $donnees;
259
		$this->idAnnuaire = Config::get('annuaire_defaut');
260
 
261
		$infos = null;
262
		if (isset($this->ressources[0])) {
263
			$this->utilisateurId = array_shift($this->ressources);
264
			if (isset($this->ressources[0])) {
265
				$methode_demande = array_shift($this->ressources);
266
				$methode = $this->traiterNomMethodePost($methode_demande);
267
				if (method_exists($this, $methode)) {
268
					$infos = $this->$methode();
269
				} else {
270
					$this->messages[] = "Ce type de ressource '$methode_demande' n'est pas disponible pour la requete POST.";
271
				}
272
			} else {
273
				$this->messages[] = "La seconde ressource du service pour les requêtes POST doit correspondre au type de ressource demandée.";
274
			}
275
		} else {
276
			$this->messages[] = "La première ressource du service pour les requêtes POST doit être l'identifiant de l'utilisateur.";
277
		}
278
 
279
		if (!is_null($infos)) {
280
			$this->envoyerJson($infos);
281
		} else {
282
			$info = 'Un problème est survenu : '.print_r($this->messages, true);
283
			$this->envoyerTxt($info);
284
		}
285
	}
286
 
287
	/**
288
	 * Permet d'envoyer un message à un utilisateur.
289
	 * RESSOURCE : /utilisateur/[id]/message
290
	 * POST :
291
	 *  - sujet : contient le sujet du message à envoyer.
292
	 *  - message : contient le contenu du message à envoyer.
456 jpm 293
	 *  - message_txt : (optionnel) si format HTML, peut contenir le contenu du message au format texte comme alternative au HTML à envoyer.
294
	 *		Sinon le texte est extrait du HTML (attention à la mise en page!).
454 jpm 295
	 *  - utilisateur_courriel : contient le courriel de l'utilisateur qui envoie le message (Il doit être
296
	 *		inscrit dans l'annuaire par défaut de Tela Botanica).
297
	 *  - copies : peut contenir une liste de courriels séparés par des virguels auxquels une copie du
298
	 *		message sera envoyée.
299
	 *  - format (optionnel) : text ou html
300
	 * RÉPONSE :
301
	 *  - message : contient le message d'information concernant l'envoie.
302
	 */
303
	private function updateMessage() {
304
		$destinataireId = $this->utilisateurId;//$this->donnees['destinataire_id'];
305
		$sujet = stripslashes($this->donnees['sujet']);
306
		$contenu = stripslashes($this->donnees['message']);
456 jpm 307
		$contenuTxt = (isset($this->donnees['message_txt'])) ? $this->donnees['message_txt'] : null;
454 jpm 308
		$envoyeur = $this->donnees['utilisateur_courriel'];
466 mathias 309
		$adresse_reponse = (isset($this->donnees['reponse_courriel']) ? $this->donnees['reponse_courriel'] : $this->donnees['utilisateur_courriel']);
454 jpm 310
		$copies = array_key_exists('copies', $this->donnees) ? explode(',', $this->donnees['copies']) : null;
311
		$format = isset($this->donnees['format']) ? $this->donnees['format'] : 'text';
312
 
313
		$info = null;
314
		if ($this->estAutoriseMessagerie($envoyeur) || $this->getAnnuaire()->utilisateurExisteParMail($this->idAnnuaire, $envoyeur)) {
315
			// il est possible de passer directement un email ou bien un id utilisateur
316
			if(filter_var($destinataireId, FILTER_VALIDATE_EMAIL)) {
317
				$destinataire = $destinataireId;
318
			} else {
319
				$destinataire = $this->getAnnuaire()->obtenirMailParId($this->idAnnuaire, $destinataireId);
320
			}
321
			if ($destinataire) {
322
				if ($format == 'html') {
456 jpm 323
					if (isset($contenuTxt)) {
324
						$envoie = $this->getMessagerie()
466 mathias 325
							->envoyerMail($envoyeur, $destinataire, $sujet, $contenu, $contenuTxt, $adresse_reponse);
456 jpm 326
					} else {
327
						$envoie = $this->getMessagerie()
466 mathias 328
							->envoyerMail($envoyeur, $destinataire, $sujet, $contenu, '', $adresse_reponse);
456 jpm 329
					}
454 jpm 330
				} else {
466 mathias 331
					$envoie = $this->getMessagerie()->envoyerMailText($envoyeur, $destinataire, $sujet, $contenu, '', $adresse_reponse);
454 jpm 332
				}
333
				if ($envoie) {
334
					$info['message'] = "Votre message a bien été envoyé.";
335
					foreach ($copies as $copie) {
336
						$sujet = '[COPIE] '.$sujet;
337
						$contenu = "Message original envoyé par $envoyeur pour $destinataire.\n--\n".$contenu;
466 mathias 338
						$this->getMessagerie()->envoyerMailText($envoyeur, $copie, $sujet, $contenu, '', $adresse_reponse);
454 jpm 339
					}
340
				} else {
341
					$info['message'] = "Le message n'a pas pu être envoyé.";
342
				}
343
			} else {
344
				$info['message'] = "Aucun courriel ne correspond à l'id du destinataire.";
345
			}
346
		} else {
347
			$info['message'] = "Vous n'êtes pas inscrit à Tela Botanica avec le courriel : $envoyeur.\n".
348
				"Veuillez saisir votre courriel d'inscription ou vous inscrire à Tela Botanica.";
349
		}
350
		return $info;
351
	}
352
 
353
	private function getMessagerie() {
354
		if (!isset($this->messagerieModele)) {
355
			$this->messagerieModele = new MessageControleur();
356
		}
357
		return $this->messagerieModele;
358
	}
359
 
360
	/*+----------------------------------------------------------------------------------------------------+*/
361
	// PUT : ajout
362
 
363
	public function createElement($donnees) {
364
		$this->donnees = $donnees;
365
		$this->idAnnuaire = Config::get('annuaire_defaut');
366
 
367
		$infos = null;
368
		if (isset($this->donnees['methode'])) {
369
			$methode_demande = $this->donnees['methode'];
370
			$methode = $this->traiterNomMethodePut($methode_demande);
371
			if (method_exists($this, $methode)) {
372
				$infos = $this->$methode();
373
			} else {
374
				$this->messages[] = "Ce type de méthode '$methode_demande' n'est pas disponible pour la requete PUT.";
375
			}
376
		} else {
377
			$this->messages[] = "Ce service n'est pas implémanté.";
378
		}
379
 
380
		if (!is_null($infos)) {
381
			$this->envoyerJson($infos);
382
		} else {
383
			$info = 'Un problème est survenu : '.print_r($this->messages, true);
384
			$this->envoyerTxt($info);
385
		}
386
	}
387
 
388
	/**
389
	 * Permet d'identifier un utilisateur.
390
	 * RESSOURCE : /utilisateur
391
	 * POST :
392
	 *  - methode = 'connexion' : methode doit valoir 'connexion' pour connecter l'utilisateur.
393
	 *  - courriel : contient le courriel de l'utilisateur .
394
	 *  - mdp : le mot de passe de l'utilisateur.
395
	 *  - persistance : true si on veut laisser l'utilisateur connecté au delà de la session sinon false
396
	 * RÉPONSE :
397
	 *  - identifie : indiquer si l'utilisateur a été identifié (true) ou pas (false)
398
	 *  - message : contient un message d'information complémentaire de l'état.
399
	 */
400
	private function createConnexion() {
401
		$courriel = stripslashes($this->donnees['courriel']);
402
		$mdp = stripslashes($this->donnees['mdp']);
403
		$persistance = (stripslashes($this->donnees['persistance']) == 'true') ? true : false;
404
 
405
		$infos = null;
406
		$infos['persistance'] = $persistance;
407
		if ($this->verifierAcces($courriel, $mdp)) {
408
			$infos['identifie'] = true;
409
			$infos['message'] = "Bienvenu.";
410
			$dureeCookie = 0;
411
			if ($persistance === true) {
412
				$dureeCookie = time()+3600*24*30;
413
				$this->creerCookiePersistant($dureeCookie, $courriel, $mdp);
414
			}
415
			$this->creerCookieUtilisateur($dureeCookie, $courriel);
416
			$infos['message'] = $_COOKIE;
417
		} else {
418
			$infos['identifie'] = false;
419
			$infos['message'] = "Le courriel ou le mot de passe saisi est incorrect.";
420
		}
421
		return $infos;
422
	}
423
}
424
?>