Subversion Repositories Applications.annuaire

Rev

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