Subversion Repositories Applications.annuaire

Rev

Rev 525 | Rev 533 | 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
	}
532 aurelien 81
 
82
	public function getIdentiteConnectee() {
83
		if (isset($_COOKIE[$this->config['database_ident']['nom_cookie_persistant']])) {
84
 
85
			$cookie = $_COOKIE[$this->config['database_ident']['nom_cookie_persistant']];
86
			// le cookie de papyrus contient un md5 concaténé à l'email utilisateur
87
			$courriel = substr($cookie , 32, strlen($cookie));
88
 
89
			$id_utilisateur = $this->getAnnuaire()->obtenirIdParMail($this->idAnnuaire, $courriel);
90
			$infos = $this->getAnnuaire()->obtenirInfosUtilisateurParId($this->idAnnuaire, $id_utilisateur);
91
 
92
			$infos['pseudoUtilise'] = $this->obtenirPseudoUtilise($id_utilisateur);
93
			$infos['pseudo'] = $this->obtenirPseudo($id_utilisateur);
94
			$infos['intitule'] = $this->formaterIntitule($infos);
95
 
96
			$infos['nomWiki'] = $this->formaterNomWiki($infos);
97
 
98
			header("content-type: application/json");
99
			echo json_encode($infos);
100
		} else  {
101
			echo json_encode(array());
102
		}
103
 
104
		exit;
105
	}
106
 
107
	private function formaterNomWiki($infos) {
108
 
109
		$prenom = ucfirst(strtolower($this->supprimerAccents($infos['prenom'])));
110
		$nom = ucfirst(strtolower($this->supprimerAccents($infos['nom'])));
111
		return $prenom.$nom;
112
	}
113
 
114
	function supprimerAccents($str, $charset='utf-8') {
115
		$str = htmlentities($str, ENT_NOQUOTES, $charset);
116
 
117
		$str = preg_replace('#&([A-za-z])(?:acute|cedil|caron|circ|grave|orn|ring|slash|th|tilde|uml);#', '\1', $str);
118
		$str = preg_replace('#&([A-za-z]{2})(?:lig);#', '\1', $str); // pour les ligatures e.g. '&oelig;'
119
		$str = preg_replace('#&[^;]+;#', '', $str); // supprime les autres caractères
120
 
121
		return $str;
122
	}
454 jpm 123
 
520 mathias 124
	/**
525 mathias 125
	 * Permet d'obtenir des infos pour un ou plusieurs ids utilisateurs indiqué(s) dans la ressource.
126
	 * RESSOURCE : /infos-par-ids/#id[,#id]*
127
	 * PARAMÈTRES : forceArrayOfArrays - si true, retourne un tableau associatif même s'il n'y a qu'un
128
	 * 		résultat (casse la rétrocompatibilté)
454 jpm 129
	 * RÉPONSE : Tableau possédant un courriel de la ressource en clé et en valeur :
130
	 *  - id : identifiant numérique de l'utilisateur
131
	 *  - pseudoUtilise : indique si on doit utiliser le pseudo à la place de Prénom NOM
132
	 *  - pseudo : pseudo de l'utilisateur.
133
	 *  - intitule : l'intitulé à affiche (choix auto entre "pseudo" et "prénom nom")
134
	 *  - prenom : prénom
135
	 *  - nom : nom de famille.
136
	 *  - courriel : courriel
137
	 */
525 mathias 138
	public function getInfosParIds($ids_utilisateurs, $forceArrayOfArrays = false) {
139
		$ids_utilisateurs = explode(',', $ids_utilisateurs);
140
		if (count($ids_utilisateurs) == 1) {
141
			// s'il n'y en a qu'un on ne passe pas un array
142
			$ids_utilisateurs = array_shift($ids_utilisateurs);
143
		}
144
		$infos = $this->getAnnuaire()->obtenirInfosUtilisateurParId($this->idAnnuaire, $ids_utilisateurs);
145
 
146
		foreach ($infos as $i => $info) {
147
			$infos[$i]['pseudoUtilise'] = $this->obtenirPseudoUtilise($info['id']);
148
			$infos[$i]['pseudo'] = $this->obtenirPseudo($info['id']);
149
			$infos[$i]['intitule'] = $this->formaterIntitule($infos[$i]);
150
		}
454 jpm 151
 
525 mathias 152
		// retrocompatibilité
153
		if (count($infos) == 1 && (! $forceArrayOfArrays)) {
154
			$infos = array_shift($infos);
155
		}
454 jpm 156
 
157
		return $infos;
158
	}
159
 
160
	/**
525 mathias 161
	 * Méthode rétrocompatible : appelle getInfosParIds et s'il n'y a qu'un résultat,
162
	 * ne retourne pas un tableau associatif mais un tableau simple
163
	 * @return array
164
	 */
165
	public function getInfosParId($ids_utilisateurs) {
166
		return $this->getInfosParIds($ids_utilisateurs, true);
167
	}
168
 
169
	/**
454 jpm 170
	 * Permet d'obtenir les prénoms et noms des courriels des utilisateurs indiqués dans la ressource.
171
	 * RESSOURCE : /utilisateur/prenom-nom-par-courriel/[courriel,courriel,...]
519 mathias 172
	 * PARAMÈTRES : aucun
454 jpm 173
	 * RÉPONSE : Tableau possédant un courriel de la ressource en clé et en valeur :
174
	 *  - id : identifiant numérique de l'utilisateur
175
	 *  - prenom : prénom
176
	 *  - nom : nom de famille.
177
	 */
178
	public function getPrenomNomParCourriel() {
179
		$courriels = explode(',', $this->ressources[0]);
180
		$infos = $this->getAnnuaire()->obtenirPrenomNomParCourriel($this->idAnnuaire, $courriels);
181
		return $infos;
182
	}
183
 
184
	/**
185
	 * Permet d'obtenir les identités des utilisateurs indiqués dans la ressource.
186
	 * RESSOURCE : /utilisateur/identite-par-courriel/[courriel,courriel,...]
519 mathias 187
	 * PARAMÈTRES : aucun
454 jpm 188
	 * RÉPONSE : Tableau possédant un courriel de la ressource en clé et en valeur :
189
	 *  - id : identifiant numérique de l'utilisateur
190
	 *  - pseudoUtilise : indique si on doit utiliser le pseudo à la place de Prénom NOM
191
	 *  - pseudo : pseudo de l'utilisateur.
192
	 *  - prenom : prénom
193
	 *  - nom : nom de famille.
194
	 */
195
	public function getIdentiteParCourriel() {
196
		$infos_utilisateurs = array();
197
		$utilisateurs = $this->getPrenomNomParCourriel();
198
		foreach ($utilisateurs as $courriel => $utilisateur) {
199
			$id = $utilisateur['id'];
200
			$utilisateur['pseudo'] = $this->obtenirPseudo($id);
201
			$utilisateur['pseudoUtilise'] = $this->obtenirPseudoUtilise($id);
202
			$utilisateur['intitule'] = $this->formaterIntitule($utilisateur);
488 aurelien 203
			$courriel = strtolower($courriel);
454 jpm 204
			$infos_utilisateurs[$courriel] = $utilisateur;
205
		}
206
		return $infos_utilisateurs;
207
	}
208
 
519 mathias 209
	/**
210
	 * Même principe que getIdentiteParCourriel() mais pour un seul courriel, et renvoie plus d'infos :
211
	 * RESSOURCE : /utilisateur/identite-complete-par-courriel/courriel[/format]
212
	 * PARAMÈTRES : format : "json" (par défaut) ou "xml" (pour
213
	 *   rétrocompatibilité avec le service eFlore_chatin/annuaire_tela/xxx/courriel)
214
	 * RÉPONSE : Tableau possédant un courriel de la ressource en clé et en valeur :
215
	 * - id : identifiant numérique de l'utilisateur
216
	 * - pseudoUtilise : indique si on doit utiliser le pseudo à la place de Prénom NOM
217
	 * - pseudo : pseudo de l'utilisateur.
218
	 * - prenom : prénom
219
	 * - nom : nom de famille.
220
	 * - mot_de_passe : le mot de passe haché (15% de matières grasses, peut contenir des traces de soja)
221
	 * - fonction
222
	 * - titre
223
	 * - site_web
224
	 * - adresse01
225
	 * - adresse02
226
	 * - code_postal
227
	 * - ville
228
	 * - departement
229
	 * - region
230
	 * - pays
231
	 * - date_inscription
232
	 */
233
	public function getIdentiteCompleteParCourriel() {
520 mathias 234
 
235
		$this->authentificationHttpSimple();
236
 
519 mathias 237
		$infos_utilisateurs = array();
238
		$courriel = $this->ressources[0];
239
		$utilisateur = $this->getAnnuaire()->obtenirMaximumInfosParCourriel($this->idAnnuaire, $courriel);
240
 
241
		$id = $utilisateur['id'];
242
		$utilisateur['pseudo'] = $this->obtenirPseudo($id);
243
		$utilisateur['pseudoUtilise'] = $this->obtenirPseudoUtilise($id);
244
		$utilisateur['intitule'] = $this->formaterIntitule($utilisateur);
245
 
246
		// ouksépabo
247
		$this->baliseMaitresse = "personne";
248
 
249
		return $utilisateur;
250
	}
251
 
454 jpm 252
	private function getAnnuaire() {
253
		if (!isset($this->annuaireModele)) {
254
			$this->annuaireModele = new AnnuaireModele();
255
		}
256
		return $this->annuaireModele;
257
	}
258
 
259
	private function getMeta() {
260
		if (!isset($this->metadonneeModele)) {
261
			$this->metadonneeModele = new MetadonneeModele();
262
		}
263
		return $this->metadonneeModele;
264
	}
265
 
266
	private function obtenirPseudo($id_utilisateur) {
267
		$pseudo = '';
268
		$id_champ_pseudo = $this->getMeta()->renvoyerIdChampMetadonneeParAbreviation($this->idAnnuaire, 'pseudo');
269
		if ($this->getMeta()->valeurExiste($id_champ_pseudo, $id_utilisateur)) {
270
			$pseudo = $this->getMeta()->obtenirValeurMetadonnee($id_champ_pseudo, $id_utilisateur);
271
		}
272
		return $pseudo;
273
	}
274
 
275
	private function obtenirPseudoUtilise($id_utilisateur) {
276
		$pseudo_utilise = false;
277
		$id_champ_utilise_pseudo = $this->getMeta()->renvoyerIdChampMetadonneeParAbreviation($this->idAnnuaire, 'utilise_pseudo');
278
		if ($this->getMeta()->valeurExiste($id_champ_utilise_pseudo, $id_utilisateur)) {
279
				$booleen = $this->getMeta()->obtenirValeurMetadonnee($id_champ_utilise_pseudo, $id_utilisateur);
280
				$pseudo_utilise = ($booleen == 0) ? false : true;
281
		}
282
		return $pseudo_utilise;
283
	}
284
 
285
	private function formaterIntitule($utilisateur) {
286
		$intitule = '';
287
		if ($utilisateur['pseudoUtilise'] && trim($utilisateur['pseudo']) != '') {
288
			$intitule = $utilisateur['pseudo'];
289
		} else {
290
			$intitule = $utilisateur['prenom'].' '.$utilisateur['nom'];
291
		}
292
		return $intitule;
293
	}
294
 
295
	/*+----------------------------------------------------------------------------------------------------+*/
296
	// POST : mise à jour
297
 
298
	public function updateElement($ressources, $donnees) {
299
		$this->ressources = $ressources;
300
		$this->donnees = $donnees;
301
		$this->idAnnuaire = Config::get('annuaire_defaut');
302
 
303
		$infos = null;
304
		if (isset($this->ressources[0])) {
305
			$this->utilisateurId = array_shift($this->ressources);
306
			if (isset($this->ressources[0])) {
307
				$methode_demande = array_shift($this->ressources);
308
				$methode = $this->traiterNomMethodePost($methode_demande);
309
				if (method_exists($this, $methode)) {
310
					$infos = $this->$methode();
311
				} else {
312
					$this->messages[] = "Ce type de ressource '$methode_demande' n'est pas disponible pour la requete POST.";
313
				}
314
			} else {
315
				$this->messages[] = "La seconde ressource du service pour les requêtes POST doit correspondre au type de ressource demandée.";
316
			}
317
		} else {
318
			$this->messages[] = "La première ressource du service pour les requêtes POST doit être l'identifiant de l'utilisateur.";
319
		}
320
 
321
		if (!is_null($infos)) {
322
			$this->envoyerJson($infos);
323
		} else {
324
			$info = 'Un problème est survenu : '.print_r($this->messages, true);
325
			$this->envoyerTxt($info);
326
		}
327
	}
328
 
329
	/**
330
	 * Permet d'envoyer un message à un utilisateur.
331
	 * RESSOURCE : /utilisateur/[id]/message
332
	 * POST :
333
	 *  - sujet : contient le sujet du message à envoyer.
334
	 *  - message : contient le contenu du message à envoyer.
456 jpm 335
	 *  - message_txt : (optionnel) si format HTML, peut contenir le contenu du message au format texte comme alternative au HTML à envoyer.
336
	 *		Sinon le texte est extrait du HTML (attention à la mise en page!).
454 jpm 337
	 *  - utilisateur_courriel : contient le courriel de l'utilisateur qui envoie le message (Il doit être
338
	 *		inscrit dans l'annuaire par défaut de Tela Botanica).
339
	 *  - copies : peut contenir une liste de courriels séparés par des virguels auxquels une copie du
340
	 *		message sera envoyée.
341
	 *  - format (optionnel) : text ou html
342
	 * RÉPONSE :
343
	 *  - message : contient le message d'information concernant l'envoie.
344
	 */
345
	private function updateMessage() {
346
		$destinataireId = $this->utilisateurId;//$this->donnees['destinataire_id'];
347
		$sujet = stripslashes($this->donnees['sujet']);
348
		$contenu = stripslashes($this->donnees['message']);
456 jpm 349
		$contenuTxt = (isset($this->donnees['message_txt'])) ? $this->donnees['message_txt'] : null;
454 jpm 350
		$envoyeur = $this->donnees['utilisateur_courriel'];
466 mathias 351
		$adresse_reponse = (isset($this->donnees['reponse_courriel']) ? $this->donnees['reponse_courriel'] : $this->donnees['utilisateur_courriel']);
454 jpm 352
		$copies = array_key_exists('copies', $this->donnees) ? explode(',', $this->donnees['copies']) : null;
353
		$format = isset($this->donnees['format']) ? $this->donnees['format'] : 'text';
354
 
355
		$info = null;
356
		if ($this->estAutoriseMessagerie($envoyeur) || $this->getAnnuaire()->utilisateurExisteParMail($this->idAnnuaire, $envoyeur)) {
357
			// il est possible de passer directement un email ou bien un id utilisateur
358
			if(filter_var($destinataireId, FILTER_VALIDATE_EMAIL)) {
359
				$destinataire = $destinataireId;
360
			} else {
361
				$destinataire = $this->getAnnuaire()->obtenirMailParId($this->idAnnuaire, $destinataireId);
362
			}
363
			if ($destinataire) {
364
				if ($format == 'html') {
456 jpm 365
					if (isset($contenuTxt)) {
366
						$envoie = $this->getMessagerie()
466 mathias 367
							->envoyerMail($envoyeur, $destinataire, $sujet, $contenu, $contenuTxt, $adresse_reponse);
456 jpm 368
					} else {
369
						$envoie = $this->getMessagerie()
466 mathias 370
							->envoyerMail($envoyeur, $destinataire, $sujet, $contenu, '', $adresse_reponse);
456 jpm 371
					}
454 jpm 372
				} else {
466 mathias 373
					$envoie = $this->getMessagerie()->envoyerMailText($envoyeur, $destinataire, $sujet, $contenu, '', $adresse_reponse);
454 jpm 374
				}
375
				if ($envoie) {
376
					$info['message'] = "Votre message a bien été envoyé.";
377
					foreach ($copies as $copie) {
378
						$sujet = '[COPIE] '.$sujet;
379
						$contenu = "Message original envoyé par $envoyeur pour $destinataire.\n--\n".$contenu;
466 mathias 380
						$this->getMessagerie()->envoyerMailText($envoyeur, $copie, $sujet, $contenu, '', $adresse_reponse);
454 jpm 381
					}
382
				} else {
383
					$info['message'] = "Le message n'a pas pu être envoyé.";
384
				}
385
			} else {
386
				$info['message'] = "Aucun courriel ne correspond à l'id du destinataire.";
387
			}
388
		} else {
389
			$info['message'] = "Vous n'êtes pas inscrit à Tela Botanica avec le courriel : $envoyeur.\n".
390
				"Veuillez saisir votre courriel d'inscription ou vous inscrire à Tela Botanica.";
391
		}
392
		return $info;
393
	}
394
 
395
	private function getMessagerie() {
396
		if (!isset($this->messagerieModele)) {
397
			$this->messagerieModele = new MessageControleur();
398
		}
399
		return $this->messagerieModele;
400
	}
401
 
402
	/*+----------------------------------------------------------------------------------------------------+*/
403
	// PUT : ajout
404
 
405
	public function createElement($donnees) {
532 aurelien 406
 
454 jpm 407
		$this->donnees = $donnees;
408
		$this->idAnnuaire = Config::get('annuaire_defaut');
409
 
410
		$infos = null;
411
		if (isset($this->donnees['methode'])) {
412
			$methode_demande = $this->donnees['methode'];
413
			$methode = $this->traiterNomMethodePut($methode_demande);
414
			if (method_exists($this, $methode)) {
415
				$infos = $this->$methode();
416
			} else {
417
				$this->messages[] = "Ce type de méthode '$methode_demande' n'est pas disponible pour la requete PUT.";
418
			}
419
		} else {
420
			$this->messages[] = "Ce service n'est pas implémanté.";
421
		}
422
 
423
		if (!is_null($infos)) {
424
			$this->envoyerJson($infos);
425
		} else {
426
			$info = 'Un problème est survenu : '.print_r($this->messages, true);
427
			$this->envoyerTxt($info);
428
		}
429
	}
430
 
431
	/**
432
	 * Permet d'identifier un utilisateur.
433
	 * RESSOURCE : /utilisateur
434
	 * POST :
435
	 *  - methode = 'connexion' : methode doit valoir 'connexion' pour connecter l'utilisateur.
436
	 *  - courriel : contient le courriel de l'utilisateur .
437
	 *  - mdp : le mot de passe de l'utilisateur.
438
	 *  - persistance : true si on veut laisser l'utilisateur connecté au delà de la session sinon false
439
	 * RÉPONSE :
440
	 *  - identifie : indiquer si l'utilisateur a été identifié (true) ou pas (false)
441
	 *  - message : contient un message d'information complémentaire de l'état.
442
	 */
443
	private function createConnexion() {
444
		$courriel = stripslashes($this->donnees['courriel']);
445
		$mdp = stripslashes($this->donnees['mdp']);
446
		$persistance = (stripslashes($this->donnees['persistance']) == 'true') ? true : false;
447
 
448
		$infos = null;
449
		$infos['persistance'] = $persistance;
450
		if ($this->verifierAcces($courriel, $mdp)) {
451
			$infos['identifie'] = true;
452
			$infos['message'] = "Bienvenu.";
453
			$dureeCookie = 0;
454
			if ($persistance === true) {
455
				$dureeCookie = time()+3600*24*30;
456
				$this->creerCookiePersistant($dureeCookie, $courriel, $mdp);
457
			}
458
			$this->creerCookieUtilisateur($dureeCookie, $courriel);
459
			$infos['message'] = $_COOKIE;
460
		} else {
461
			$infos['identifie'] = false;
462
			$infos['message'] = "Le courriel ou le mot de passe saisi est incorrect.";
463
		}
464
		return $infos;
465
	}
532 aurelien 466
 
467
	/*+----------------------------------------------------------------------------------------------------+*/
468
	// DELETE : suppression
469
 
470
	/**
471
	 * Permet de déconnecter un utilisateur
472
	 * RESSOURCE : /utilisateur
473
	 * DELETE
474
	 */
475
	public function deleteElement($uid) {
476
		if($uid[0] == 'deconnexion') {
477
			$this->supprimerCookieUtilisateur();
478
		}
479
	}
454 jpm 480
}
481
?>