Subversion Repositories Applications.annuaire

Rev

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