Subversion Repositories Applications.annuaire

Rev

Rev 422 | Rev 456 | 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
 
26
	/*+----------------------------------------------------------------------------------------------------+*/
27
	// GET : consultation
28
 
29
	public function getElement($ressources){
30
		$this->ressources = $ressources;
31
		$this->idAnnuaire = Config::get('annuaire_defaut');
32
		$infos = null;
33
 
34
		if (isset($this->ressources[0])) {
35
			if (preg_match('/^[0-9]+$/', $this->ressources[0])) {
36
				// ATTENTION : Ces web services ne doivent être accessible que depuis des applis installées sur nos serveurs
37
				// pour les communications inter-serveurs.
38
				$this->controlerIpAutorisees();
39
				$infos = $this->getInfosParId($this->ressources[0]);
40
			} else {
41
				$methode_demande = array_shift($this->ressources);
42
				$methode = $this->traiterNomMethodeGet($methode_demande);
43
				if (method_exists($this, $methode)) {
44
					$infos = $this->$methode();
45
				} else {
46
					$this->messages[] = "Ce type de ressource '$methode_demande' n'est pas disponible pour la requete GET.";
47
				}
48
			}
49
		} else {
50
			$this->messages[] = "Le premier paramêtre du chemin du service doit correspondre au type de ressource demandée.";
51
		}
52
 
53
		if (!is_null($infos)) {
54
			$this->envoyerJson($infos);
55
		} else {
56
			$info = 'Un problème est survenu : '.print_r($this->messages, true);
57
			$this->envoyerTxt($info);
58
		}
59
	}
60
 
61
 
62
	/**
63
	 * Permet d'obtenir des infos pour un id utilisateur indiqué dans la ressource.
64
	 * RESSOURCE : /utilisateur/#id
65
	 * PARAMÊTRES : aucun
66
	 * RÉPONSE : Tableau possédant un courriel de la ressource en clé et en valeur :
67
	 *  - id : identifiant numérique de l'utilisateur
68
	 *  - pseudoUtilise : indique si on doit utiliser le pseudo à la place de Prénom NOM
69
	 *  - pseudo : pseudo de l'utilisateur.
70
	 *  - intitule : l'intitulé à affiche (choix auto entre "pseudo" et "prénom nom")
71
	 *  - prenom : prénom
72
	 *  - nom : nom de famille.
73
	 *  - courriel : courriel
74
	 */
75
	public function getInfosParId($id_utilisateur) {
76
		$infos = $this->getAnnuaire()->obtenirInfosUtilisateurParId($this->idAnnuaire, $id_utilisateur);
77
 
78
		$infos['pseudoUtilise'] = $this->obtenirPseudoUtilise($id_utilisateur);
79
		$infos['pseudo'] = $this->obtenirPseudo($id_utilisateur);
80
		$infos['intitule'] = $this->formaterIntitule($infos);
81
 
82
		return $infos;
83
	}
84
 
85
	/**
86
	 * Permet d'obtenir l'identité pour un id utilisateur indiqué dans la ressource.
87
	 * RESSOURCE : /utilisateur/#id
88
	 * PARAMÊTRES : aucun
89
	 * RÉPONSE : Tableau possédant un courriel de la ressource en clé et en valeur :
90
	 *  - id : identifiant numérique de l'utilisateur
91
	 *  - pseudoUtilise : indique si on doit utiliser le pseudo à la place de Prénom NOM
92
	 *  - pseudo : pseudo de l'utilisateur.
93
	 *  - intitule : l'intitulé à affiche (choix auto entre "pseudo" et "prénom nom")
94
	 *  - prenom : prénom
95
	 *  - nom : nom de famille.
96
	 *  - courriel : courriel
97
	 */
98
	public function getIdentiteParId() {
99
		$infos_utilisateurs = array();
100
		$utilisateurs = $this->getPrenomNomParCourriel();
101
		foreach ($utilisateurs as $courriel => $utilisateur) {
102
			$id = $utilisateur['id'];
103
			$utilisateur['pseudo'] = $this->obtenirPseudo($id);
104
			$utilisateur['pseudoUtilise'] = $this->obtenirPseudoUtilise($id);
105
			$utilisateur['intitule'] = $this->formaterIntitule($utilisateur);
106
			$infos_utilisateurs[$courriel] = $utilisateur;
107
		}
108
		return $infos_utilisateurs;
109
	}
110
 
111
	/**
112
	 * Permet d'obtenir les prénoms et noms des courriels des utilisateurs indiqués dans la ressource.
113
	 * RESSOURCE : /utilisateur/prenom-nom-par-courriel/[courriel,courriel,...]
114
	 * PARAMÊTRES : aucun
115
	 * RÉPONSE : Tableau possédant un courriel de la ressource en clé et en valeur :
116
	 *  - id : identifiant numérique de l'utilisateur
117
	 *  - prenom : prénom
118
	 *  - nom : nom de famille.
119
	 */
120
	public function getPrenomNomParCourriel() {
121
		$courriels = explode(',', $this->ressources[0]);
122
		$infos = $this->getAnnuaire()->obtenirPrenomNomParCourriel($this->idAnnuaire, $courriels);
123
		$infous_courriel_minuscule = array();
124
		foreach ($infos as $courriel => $utilisateur) {
125
			$courriel = strtolower($courriel);
126
			$infous_courriel_minuscule[$courriel] = $utilisateur;
127
		}
128
		return $infos;
129
	}
130
 
131
	/**
132
	 * Permet d'obtenir les identités des utilisateurs indiqués dans la ressource.
133
	 * RESSOURCE : /utilisateur/identite-par-courriel/[courriel,courriel,...]
134
	 * PARAMÊTRES : aucun
135
	 * RÉPONSE : Tableau possédant un courriel de la ressource en clé et en valeur :
136
	 *  - id : identifiant numérique de l'utilisateur
137
	 *  - pseudoUtilise : indique si on doit utiliser le pseudo à la place de Prénom NOM
138
	 *  - pseudo : pseudo de l'utilisateur.
139
	 *  - intitule : l'intitulé à affiche (choix auto entre "pseudo" et "prénom nom")
140
	 *  - prenom : prénom
141
	 *  - nom : nom de famille.
142
	 */
143
	public function getIdentiteParCourriel() {
144
		$infos_utilisateurs = array();
145
		$utilisateurs = $this->getPrenomNomParCourriel();
146
		foreach ($utilisateurs as $courriel => $utilisateur) {
147
			$id = $utilisateur['id'];
148
			$utilisateur['pseudo'] = $this->obtenirPseudo($id);
149
			$utilisateur['pseudoUtilise'] = $this->obtenirPseudoUtilise($id);
150
			$utilisateur['intitule'] = $this->formaterIntitule($utilisateur);
151
			$infos_utilisateurs[$courriel] = $utilisateur;
152
		}
153
		return $infos_utilisateurs;
154
	}
155
 
156
	private function getAnnuaire() {
157
		if (!isset($this->annuaireModele)) {
158
			$this->annuaireModele = new AnnuaireModele();
159
		}
160
		return $this->annuaireModele;
161
	}
162
 
163
	private function getMeta() {
164
		if (!isset($this->metadonneeModele)) {
165
			$this->metadonneeModele = new MetadonneeModele();
166
		}
167
		return $this->metadonneeModele;
168
	}
169
 
170
	private function obtenirPseudo($id_utilisateur) {
171
		$pseudo = '';
172
		$id_champ_pseudo = $this->getMeta()->renvoyerIdChampMetadonneeParAbreviation($this->idAnnuaire, 'pseudo');
173
		if ($this->getMeta()->valeurExiste($id_champ_pseudo, $id_utilisateur)) {
174
			$pseudo = $this->getMeta()->obtenirValeurMetadonnee($id_champ_pseudo, $id_utilisateur);
175
		}
176
		return $pseudo;
177
	}
178
 
179
	private function obtenirPseudoUtilise($id_utilisateur) {
180
		$pseudo_utilise = false;
181
		$id_champ_utilise_pseudo = $this->getMeta()->renvoyerIdChampMetadonneeParAbreviation($this->idAnnuaire, 'utilise_pseudo');
182
		if ($this->getMeta()->valeurExiste($id_champ_utilise_pseudo, $id_utilisateur)) {
183
				$booleen = $this->getMeta()->obtenirValeurMetadonnee($id_champ_utilise_pseudo, $id_utilisateur);
184
				$pseudo_utilise = ($booleen == 0) ? false : true;
185
		}
186
		return $pseudo_utilise;
187
	}
188
 
189
	private function formaterIntitule($utilisateur) {
190
		$intitule = '';
191
		if ($utilisateur['pseudoUtilise'] && trim($utilisateur['pseudo']) != '') {
192
			$intitule = $utilisateur['pseudo'];
193
		} else {
194
			$intitule = $utilisateur['prenom'].' '.$utilisateur['nom'];
195
		}
196
		return $intitule;
197
	}
198
 
199
	/*+----------------------------------------------------------------------------------------------------+*/
200
	// POST : mise à jour
201
 
202
	public function updateElement($ressources, $donnees) {
203
		$this->ressources = $ressources;
204
		$this->donnees = $donnees;
205
		$this->idAnnuaire = Config::get('annuaire_defaut');
206
 
207
		$infos = null;
208
		if (isset($this->ressources[0])) {
209
			$this->utilisateurId = array_shift($this->ressources);
210
			if (isset($this->ressources[0])) {
211
				$methode_demande = array_shift($this->ressources);
212
				$methode = $this->traiterNomMethodePost($methode_demande);
213
				if (method_exists($this, $methode)) {
214
					$infos = $this->$methode();
215
				} else {
216
					$this->messages[] = "Ce type de ressource '$methode_demande' n'est pas disponible pour la requete POST.";
217
				}
218
			} else {
219
				$this->messages[] = "La seconde ressource du service pour les requêtes POST doit correspondre au type de ressource demandée.";
220
			}
221
		} else {
222
			$this->messages[] = "La première ressource du service pour les requêtes POST doit être l'identifiant de l'utilisateur.";
223
		}
224
 
225
		if (!is_null($infos)) {
226
			$this->envoyerJson($infos);
227
		} else {
228
			$info = 'Un problème est survenu : '.print_r($this->messages, true);
229
			$this->envoyerTxt($info);
230
		}
231
	}
232
 
233
	/**
234
	 * Permet d'envoyer un message à un utilisateur.
235
	 * RESSOURCE : /utilisateur/[id]/message
236
	 * POST :
237
	 *  - sujet : contient le sujet du message à envoyer.
238
	 *  - message : contient le contenu du message à envoyer.
239
	 *  - utilisateur_courriel : contient le courriel de l'utilisateur qui envoie le message (Il doit être
240
	 *		inscrit dans l'annuaire par défaut de Tela Botanica).
241
	 *  - copies : peut contenir une liste de courriels séparés par des virguels auxquels une copie du
242
	 *		message sera envoyée.
243
	 *  - format (optionnel) : text ou html
244
	 * RÉPONSE :
245
	 *  - message : contient le message d'information concernant l'envoie.
246
	 */
247
	private function updateMessage() {
248
		$destinataireId = $this->utilisateurId;//$this->donnees['destinataire_id'];
249
		$sujet = stripslashes($this->donnees['sujet']);
250
		$contenu = stripslashes($this->donnees['message']);
251
		$envoyeur = $this->donnees['utilisateur_courriel'];
252
		$copies = array_key_exists('copies', $this->donnees) ? explode(',', $this->donnees['copies']) : null;
253
		$format = isset($this->donnees['format']) ? $this->donnees['format'] : 'text';
254
 
255
		$info = null;
256
		if ($this->estAutoriseMessagerie($envoyeur) || $this->getAnnuaire()->utilisateurExisteParMail($this->idAnnuaire, $envoyeur)) {
257
			// il est possible de passer directement un email ou bien un id utilisateur
258
			if(filter_var($destinataireId, FILTER_VALIDATE_EMAIL)) {
259
				$destinataire = $destinataireId;
260
			} else {
261
				$destinataire = $this->getAnnuaire()->obtenirMailParId($this->idAnnuaire, $destinataireId);
262
			}
263
			if ($destinataire) {
264
				if ($format == 'html') {
265
					$envoie = $this->getMessagerie()->envoyerMail($envoyeur, $destinataire, $sujet, $contenu);
266
				} else {
267
					$envoie = $this->getMessagerie()->envoyerMailText($envoyeur, $destinataire, $sujet, $contenu);
268
				}
269
				if ($envoie) {
270
					$info['message'] = "Votre message a bien été envoyé.";
271
					foreach ($copies as $copie) {
272
						$sujet = '[COPIE] '.$sujet;
273
						$contenu = "Message original envoyé par $envoyeur pour $destinataire.\n--\n".$contenu;
274
						$this->getMessagerie()->envoyerMailText($envoyeur, $copie, $sujet, $contenu);
275
					}
276
				} else {
277
					$info['message'] = "Le message n'a pas pu être envoyé.";
278
				}
279
			} else {
280
				$info['message'] = "Aucun courriel ne correspond à l'id du destinataire.";
281
			}
282
		} else {
283
			$info['message'] = "Vous n'êtes pas inscrit à Tela Botanica avec le courriel : $envoyeur.\n".
284
				"Veuillez saisir votre courriel d'inscription ou vous inscrire à Tela Botanica.";
285
		}
286
		return $info;
287
	}
288
 
289
	private function getMessagerie() {
290
		if (!isset($this->messagerieModele)) {
291
			$this->messagerieModele = new MessageControleur();
292
		}
293
		return $this->messagerieModele;
294
	}
295
 
296
	/*+----------------------------------------------------------------------------------------------------+*/
297
	// PUT : ajout
298
 
299
	public function createElement($donnees) {
300
		$this->donnees = $donnees;
301
		$this->idAnnuaire = Config::get('annuaire_defaut');
302
 
303
		$infos = null;
304
		if (isset($this->donnees['methode'])) {
305
			$methode_demande = $this->donnees['methode'];
306
			$methode = $this->traiterNomMethodePut($methode_demande);
307
			if (method_exists($this, $methode)) {
308
				$infos = $this->$methode();
309
			} else {
310
				$this->messages[] = "Ce type de méthode '$methode_demande' n'est pas disponible pour la requete PUT.";
311
			}
312
		} else {
313
			$this->messages[] = "Ce service n'est pas implémanté.";
314
		}
315
 
316
		if (!is_null($infos)) {
317
			$this->envoyerJson($infos);
318
		} else {
319
			$info = 'Un problème est survenu : '.print_r($this->messages, true);
320
			$this->envoyerTxt($info);
321
		}
322
	}
323
 
324
	/**
325
	 * Permet d'identifier un utilisateur.
326
	 * RESSOURCE : /utilisateur
327
	 * POST :
328
	 *  - methode = 'connexion' : methode doit valoir 'connexion' pour connecter l'utilisateur.
329
	 *  - courriel : contient le courriel de l'utilisateur .
330
	 *  - mdp : le mot de passe de l'utilisateur.
331
	 *  - persistance : true si on veut laisser l'utilisateur connecté au delà de la session sinon false
332
	 * RÉPONSE :
333
	 *  - identifie : indiquer si l'utilisateur a été identifié (true) ou pas (false)
334
	 *  - message : contient un message d'information complémentaire de l'état.
335
	 */
336
	private function createConnexion() {
337
		$courriel = stripslashes($this->donnees['courriel']);
338
		$mdp = stripslashes($this->donnees['mdp']);
339
		$persistance = (stripslashes($this->donnees['persistance']) == 'true') ? true : false;
340
 
341
		$infos = null;
342
		$infos['persistance'] = $persistance;
343
		if ($this->verifierAcces($courriel, $mdp)) {
344
			$infos['identifie'] = true;
345
			$infos['message'] = "Bienvenu.";
346
			$dureeCookie = 0;
347
			if ($persistance === true) {
348
				$dureeCookie = time()+3600*24*30;
349
				$this->creerCookiePersistant($dureeCookie, $courriel, $mdp);
350
			}
351
			$this->creerCookieUtilisateur($dureeCookie, $courriel);
352
			$infos['message'] = $_COOKIE;
353
		} else {
354
			$infos['identifie'] = false;
355
			$infos['message'] = "Le courriel ou le mot de passe saisi est incorrect.";
356
		}
357
		return $infos;
358
	}
359
}
360
?>