WebSVN – Applications.annuaire – Diff – /branches/v1.2-autel/jrest/services/Utilisateur.php


<?php
// declare(encoding='UTF-8');
/**
 * Service retournant les prénoms et nom  d'un utilisateur en fonction de son courriel.
 * UNe liste de courriel peut être passé dans la ressource.
 * Exemple :
 * /utilisateur/Prenom-nom-par-courriel/jpm@tela-botanica.org,aurelien@tela-botanica.org
 *
 * @category	php 5.2
 * @package		Annuaire::Services
 * @author		Jean-Pascal MILCENT <jpm@tela-botanica.org>
 * @copyright	Copyright (c) 2010, Tela Botanica (accueil@tela-botanica.org)
 * @license		http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL
 * @license		http://www.gnu.org/licenses/gpl.html Licence GNU-GPL
 * @version		$Id$
 */
class Utilisateur extends JRestService {
 
	private $donnees = null;
	private $idAnnuaire = null;
	private $utilisateurId = null;
	private $metadonneeModele = null;
	private $annuaireModele = null;
	private $messagerieModele = null;
 
	/*+----------------------------------------------------------------------------------------------------+*/
	// GET : consultation
 
	public function getElement($ressources){
		$this->ressources = $ressources;
		$this->idAnnuaire = Config::get('annuaire_defaut');
		$infos = null;
 
		if (isset($this->ressources[0])) {
			if (preg_match('/^[0-9]+$/', $this->ressources[0])) {
				// ATTENTION : Ces web services ne doivent être accessible que depuis des applis installées sur nos serveurs
				// pour les communications inter-serveurs.
				$this->controlerIpAutorisees();
				$infos = $this->getInfosParId($this->ressources[0]);
			} else {
				$methode_demande = array_shift($this->ressources);
				$methode = $this->traiterNomMethodeGet($methode_demande);
				if (method_exists($this, $methode)) {
					$infos = $this->$methode();
				} else {
					$this->messages[] = "Ce type de ressource '$methode_demande' n'est pas disponible pour la requete GET.";
				}
			}
		} else {
			$this->messages[] = "Le premier paramêtre du chemin du service doit correspondre au type de ressource demandée.";
		}
 
		if (!is_null($infos)) {
			$this->envoyerJson($infos);
		} else {
			$info = 'Un problème est survenu : '.print_r($this->messages, true);
			$this->envoyerTxt($info);
		}
	}
 
 
	/**
	 * Permet d'obtenir des infos pour un id utilisateur indiqué dans la ressource.
	 * RESSOURCE : /utilisateur/#id
	 * PARAMÊTRES : aucun
	 * RÉPONSE : Tableau possédant un courriel de la ressource en clé et en valeur :
	 *  - id : identifiant numérique de l'utilisateur
	 *  - pseudoUtilise : indique si on doit utiliser le pseudo à la place de Prénom NOM
	 *  - pseudo : pseudo de l'utilisateur.
	 *  - intitule : l'intitulé à affiche (choix auto entre "pseudo" et "prénom nom")
	 *  - prenom : prénom
	 *  - nom : nom de famille.
	 *  - courriel : courriel
	 */
	public function getInfosParId($id_utilisateur) {
		$champs = array('champ_id', 'champ_mail', 'champ_prenom', 'champ_nom');
 
		$infos_utilisateurs = $this->getAnnuaire()->obtenirValeursUtilisateur($this->idAnnuaire, $id_utilisateur, $champs);
		$infos_utilisateurs['pseudoUtilise'] = $this->obtenirPseudoUtilise($id_utilisateur);
		$infos_utilisateurs['pseudo'] = $this->obtenirPseudo($id_utilisateur);
		$infos_utilisateurs['intitule'] = $this->formaterIntitule($infos_utilisateurs);
 
		return $infos_utilisateurs;
	}
 
	/**
	 * Permet d'obtenir les prénoms et noms des courriels des utilisateurs indiqués dans la ressource.
	 * RESSOURCE : /utilisateur/prenom-nom-par-courriel/[courriel,courriel,...]
	 * PARAMÊTRES : aucun
	 * RÉPONSE : Tableau possédant un courriel de la ressource en clé et en valeur :
	 *  - id : identifiant numérique de l'utilisateur
	 *  - prenom : prénom
	 *  - nom : nom de famille.
	 */
	public function getPrenomNomParCourriel() {
		$courriels = explode(',', $this->ressources[0]);
		$infos = $this->getAnnuaire()->obtenirPrenomNomParCourriel($this->idAnnuaire, $courriels);
		$infous_courriel_minuscule = array();
		foreach ($infos as $courriel => $utilisateur) {
			$courriel = strtolower($courriel);
			$infous_courriel_minuscule[$courriel] = $utilisateur;
		}
		return $infos;
	}
 
	/**
	 * Permet d'obtenir les identités des utilisateurs indiqués dans la ressource.
	 * RESSOURCE : /utilisateur/identite-par-courriel/[courriel,courriel,...]
	 * PARAMÊTRES : aucun
	 * RÉPONSE : Tableau possédant un courriel de la ressource en clé et en valeur :
	 *  - id : identifiant numérique de l'utilisateur
	 *  - pseudoUtilise : indique si on doit utiliser le pseudo à la place de Prénom NOM
	 *  - pseudo : pseudo de l'utilisateur.
	 *  - prenom : prénom
	 *  - nom : nom de famille.
	 */
	public function getIdentiteParCourriel() {
		$infos_utilisateurs = array();
		$utilisateurs = $this->getPrenomNomParCourriel();
		foreach ($utilisateurs as $courriel => $utilisateur) {
			$id = $utilisateur['id'];
			$utilisateur['pseudo'] = $this->obtenirPseudo($id);
			$utilisateur['pseudoUtilise'] = $this->obtenirPseudoUtilise($id);
			$utilisateur['intitule'] = $this->formaterIntitule($utilisateur);
			$infos_utilisateurs[$courriel] = $utilisateur;
		}
		return $infos_utilisateurs;
	}
 
	private function getAnnuaire() {
		if (!isset($this->annuaireModele)) {
			$this->annuaireModele = new AnnuaireModele();
		}
		return $this->annuaireModele;
	}
 
	private function getMeta() {
		if (!isset($this->metadonneeModele)) {
			$this->metadonneeModele = new MetadonneeModele();
		}
		return $this->metadonneeModele;
	}
 
	private function obtenirPseudo($id_utilisateur) {
		$pseudo = '';
		$id_champ_pseudo = $this->getMeta()->renvoyerIdChampMetadonneeParAbreviation($this->idAnnuaire, 'pseudo');
		if ($this->getMeta()->valeurExiste($id_champ_pseudo, $id_utilisateur)) {
			$pseudo = $this->getMeta()->obtenirValeurMetadonnee($id_champ_pseudo, $id_utilisateur);
		}
		return $pseudo;
	}
 
	private function obtenirPseudoUtilise($id_utilisateur) {
		$pseudo_utilise = false;
		$id_champ_utilise_pseudo = $this->getMeta()->renvoyerIdChampMetadonneeParAbreviation($this->idAnnuaire, 'utilise_pseudo');
		if ($this->getMeta()->valeurExiste($id_champ_utilise_pseudo, $id_utilisateur)) {
				$booleen = $this->getMeta()->obtenirValeurMetadonnee($id_champ_utilise_pseudo, $id_utilisateur);
				$pseudo_utilise = ($booleen == 0) ? false : true;
		}
		return $pseudo_utilise;
	}
 
	private function formaterIntitule($utilisateur) {
		$intitule = '';
		if ($utilisateur['pseudoUtilise'] && trim($utilisateur['pseudo']) != '') {
			$intitule = $utilisateur['pseudo'];
		} else {
			$intitule = $utilisateur['prenom'].' '.$utilisateur['nom'];
		}
		return $intitule;
	}
 
	/*+----------------------------------------------------------------------------------------------------+*/
	// POST : mise à jour
 
	public function updateElement($ressources, $donnees) {
		$this->ressources = $ressources;
		$this->donnees = $donnees;
		$this->idAnnuaire = Config::get('annuaire_defaut');
 
		$infos = null;
		if (isset($this->ressources[0])) {
			$this->utilisateurId = array_shift($this->ressources);
			if (isset($this->ressources[0])) {
				$methode_demande = array_shift($this->ressources);
				$methode = $this->traiterNomMethodePost($methode_demande);
				if (method_exists($this, $methode)) {
					$infos = $this->$methode();
				} else {
					$this->messages[] = "Ce type de ressource '$methode_demande' n'est pas disponible pour la requete POST.";
				}
			} else {
				$this->messages[] = "La seconde ressource du service pour les requêtes POST doit correspondre au type de ressource demandée.";
			}
		} else {
			$this->messages[] = "La première ressource du service pour les requêtes POST doit être l'identifiant de l'utilisateur.";
		}
 
		if (!is_null($infos)) {
			$this->envoyerJson($infos);
		} else {
			$info = 'Un problème est survenu : '.print_r($this->messages, true);
			$this->envoyerTxt($info);
		}
	}
 
	/**
	 * Permet d'envoyer un message à un utilisateur.
	 * RESSOURCE : /utilisateur/[id]/message
	 * POST :
	 *  - sujet : contient le sujet du message à envoyer.
	 *  - message : contient le contenu du message à envoyer.
	 *  - utilisateur_courriel : contient le courriel de l'utilisateur qui envoie le message (Il doit être
	 *		inscrit dans l'annuaire par défaut de Tela Botanica).
	 *  - copies : peut contenir une liste de courriels séparés par des virguels auxquels une copie du
	 *		message sera envoyée.
	 *  - format (optionnel) : text ou html
	 * RÉPONSE :
	 *  - message : contient le message d'information concernant l'envoie.
	 */
	private function updateMessage() {
		$destinataireId = $this->utilisateurId;//$this->donnees['destinataire_id'];
		$sujet = stripslashes($this->donnees['sujet']);
		$contenu = stripslashes($this->donnees['message']);
		$envoyeur = $this->donnees['utilisateur_courriel'];
		$copies = array_key_exists('copies', $this->donnees) ? explode(',', $this->donnees['copies']) : null;
		$format = isset($this->donnees['format']) ? $this->donnees['format'] : 'text';
 
		$info = null;
		if ($this->estAutoriseMessagerie($envoyeur) || $this->getAnnuaire()->utilisateurExisteParMail($this->idAnnuaire, $envoyeur)) {
			// il est possible de passer directement un email ou bien un id utilisateur
			if(filter_var($destinataireId, FILTER_VALIDATE_EMAIL)) {
				$destinataire = $destinataireId;
			} else {
				$destinataire = $this->getAnnuaire()->obtenirMailParId($this->idAnnuaire, $destinataireId);
			}
			if ($destinataire) {
				if ($format == 'html') {
					$envoie = $this->getMessagerie()->envoyerMail($envoyeur, $destinataire, $sujet, $contenu);
				} else {
					$envoie = $this->getMessagerie()->envoyerMailText($envoyeur, $destinataire, $sujet, $contenu);
				}
				if ($envoie) {
					$info['message'] = "Votre message a bien été envoyé.";
					foreach ($copies as $copie) {
						$sujet = '[COPIE] '.$sujet;
						$contenu = "Message original envoyé par $envoyeur pour $destinataire.\n--\n".$contenu;
						$this->getMessagerie()->envoyerMailText($envoyeur, $copie, $sujet, $contenu);
					}
				} else {
					$info['message'] = "Le message n'a pas pu être envoyé.";
				}
			} else {
				$info['message'] = "Aucun courriel ne correspond à l'id du destinataire.";
			}
		} else {
			$info['message'] = "Vous n'êtes pas inscrit à Tela Botanica avec le courriel : $envoyeur.\n".
				"Veuillez saisir votre courriel d'inscription ou vous inscrire à Tela Botanica.";
		}
		return $info;
	}
 
	private function getMessagerie() {
		if (!isset($this->messagerieModele)) {
			$this->messagerieModele = new MessageControleur();
		}
		return $this->messagerieModele;
	}
 
	/*+----------------------------------------------------------------------------------------------------+*/
	// PUT : ajout
 
	public function createElement($donnees) {
		$this->donnees = $donnees;
		$this->idAnnuaire = Config::get('annuaire_defaut');
 
		$infos = null;
		if (isset($this->donnees['methode'])) {
			$methode_demande = $this->donnees['methode'];
			$methode = $this->traiterNomMethodePut($methode_demande);
			if (method_exists($this, $methode)) {
				$infos = $this->$methode();
			} else {
				$this->messages[] = "Ce type de méthode '$methode_demande' n'est pas disponible pour la requete PUT.";
			}
		} else {
			$this->messages[] = "Ce service n'est pas implémanté.";
		}
 
		if (!is_null($infos)) {
			$this->envoyerJson($infos);
		} else {
			$info = 'Un problème est survenu : '.print_r($this->messages, true);
			$this->envoyerTxt($info);
		}
	}
 
	/**
	 * Permet d'identifier un utilisateur.
	 * RESSOURCE : /utilisateur
	 * POST :
	 *  - methode = 'connexion' : methode doit valoir 'connexion' pour connecter l'utilisateur.
	 *  - courriel : contient le courriel de l'utilisateur .
	 *  - mdp : le mot de passe de l'utilisateur.
	 *  - persistance : true si on veut laisser l'utilisateur connecté au delà de la session sinon false
	 * RÉPONSE :
	 *  - identifie : indiquer si l'utilisateur a été identifié (true) ou pas (false)
	 *  - message : contient un message d'information complémentaire de l'état.
	 */
	private function createConnexion() {
		$courriel = stripslashes($this->donnees['courriel']);
		$mdp = stripslashes($this->donnees['mdp']);
		$persistance = (stripslashes($this->donnees['persistance']) == 'true') ? true : false;
 
		$infos = null;
		$infos['persistance'] = $persistance;
		if ($this->verifierAcces($courriel, $mdp)) {
			$infos['identifie'] = true;
			$infos['message'] = "Bienvenu.";
			$dureeCookie = 0;
			if ($persistance === true) {
				$dureeCookie = time()+3600*24*30;
				$this->creerCookiePersistant($dureeCookie, $courriel, $mdp);
			}
			$this->creerCookieUtilisateur($dureeCookie, $courriel);
			$infos['message'] = $_COOKIE;
		} else {
			$infos['identifie'] = false;
			$infos['message'] = "Le courriel ou le mot de passe saisi est incorrect.";
		}
		return $infos;
	}
}
?>

Subversion Repositories Applications.annuaire

(root)/branches/v1.2-autel/jrest/services/Utilisateur.php – Rev 450 → 451

Rev 450		Rev 451
1	`<?php`	1	`<?php`
2	`// declare(encoding='UTF-8');`	2	`// declare(encoding='UTF-8');`
3	`/**`	3	`/**`
4	`* Service retournant les prénoms et nom d'un utilisateur en fonction de son courriel.`	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.`	5	`* UNe liste de courriel peut être passé dans la ressource.`
6	`* Exemple :`	6	`* Exemple :`
7	`* /utilisateur/Prenom-nom-par-courriel/jpm@tela-botanica.org,aurelien@tela-botanica.org`	7	`* /utilisateur/Prenom-nom-par-courriel/jpm@tela-botanica.org,aurelien@tela-botanica.org`
8	`*`	8	`*`
9	`* @category php 5.2`	9	`* @category php 5.2`
10	`* @package Annuaire::Services`	10	`* @package Annuaire::Services`
11	`* @author Jean-Pascal MILCENT <jpm@tela-botanica.org>`	11	`* @author Jean-Pascal MILCENT <jpm@tela-botanica.org>`
12	`* @copyright Copyright (c) 2010, Tela Botanica (accueil@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`	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`	14	`* @license http://www.gnu.org/licenses/gpl.html Licence GNU-GPL`
15	`* @version $Id$`	15	`* @version $Id$`
16	`*/`	16	`*/`
17	`class Utilisateur extends JRestService {`	17	`class Utilisateur extends JRestService {`
18		18
19	`private $donnees = null;`	19	`private $donnees = null;`
20	`private $idAnnuaire = null;`	20	`private $idAnnuaire = null;`
21	`private $utilisateurId = null;`	21	`private $utilisateurId = null;`
22	`private $metadonneeModele = null;`	22	`private $metadonneeModele = null;`
23	`private $annuaireModele = null;`	23	`private $annuaireModele = null;`
24	`private $messagerieModele = null;`	24	`private $messagerieModele = null;`
25		25
26	`/+----------------------------------------------------------------------------------------------------+/`	26	`/+----------------------------------------------------------------------------------------------------+/`
27	`// GET : consultation`	27	`// GET : consultation`
28		28
29	`public function getElement($ressources){`	29	`public function getElement($ressources){`
30	`$this->ressources = $ressources;`	30	`$this->ressources = $ressources;`
31	`$this->idAnnuaire = Config::get('annuaire_defaut');`	31	`$this->idAnnuaire = Config::get('annuaire_defaut');`
32	`$infos = null;`	32	`$infos = null;`
33		33
34	`if (isset($this->ressources[0])) {`	34	`if (isset($this->ressources[0])) {`
35	`if (is_int($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`	36	`// ATTENTION : Ces web services ne doivent être accessible que depuis des applis installées sur nos serveurs`
37	`// pour les communications inter-serveurs.`	37	`// pour les communications inter-serveurs.`
38	`$this->controlerIpAutorisees();`	38	`$this->controlerIpAutorisees();`
39	`$infos = $this->getInfosParId($this->ressources[0]);`	39	`$infos = $this->getInfosParId($this->ressources[0]);`
40	`} else {`	40	`} else {`