sid/manager/repo/module.php

<?php require_once __ROOT__.'/manager/security.php';

/**************************************************************************/
/*   __  __  ___  ____  _   _ _     _____       ____  _____ ____   ___    */
/*  |  \/  |/ _ \|  _ \| | | | |   | ____|     |  _ \| ____|  _ \ / _ \   */
/*  | |\/| | | | | | | | | | | |   |  _|       | |_) |  _| | |_) | | | |  */
/*  | |  | | |_| | |_| | |_| | |___| |___      |  _ <| |___|  __/| |_| |  */
/*  |_|  |_|\___/|____/ \___/|_____|_____|     |_| \_\_____|_|    \___/   */
/*                                                                        */
/**************************************************************************/

class moduleRepo extends DBAccess{
	/* VERIFIE L'EXISTENCE D'UN MODULE DANS LA BDD
	*
	* @nom<String>				le nom du module recherché
	* 
	* @return  UID<int>			si le module est dans la BDD, retourne son UID
	* @return  FALSE<Boolean>	FAUX si le module n'est pas présent dans la BDD
	* 
	*/
	public static function UID($nom){
		$getModuleUID = DataBase::getPDO()->prepare("SELECT DISTINCT id_module as id FROM module WHERE nom = :nom");
		$getModuleUID->execute(array( ':nom' => $nom ));
		
		// on retourne le résultat : FAUX si aucun résultat, sinon la valeur de l'UID du module
		return $getModuleUID->fetch()['id'];
	}




	/* RENVOIE LES INFORMATIONS D'UN MODULE D'UID DONNÉ
	*
	* @moduleUID<int>					l'UID du module duquel on veut les infos
	*
	* @return module<Array>				tableau associatif contenant tout les champs de la BDD pour ce module
	*
	*/
	public static function info($moduleUID){
		$getModuleInfo = DataBase::getPDO()->prepare("SELECT DISTINCT id_module as id, nom, libelle FROM module WHERE id_module = :moduleUID");
		$getModuleInfo->execute(array( ':moduleUID' => $moduleUID ));

		// on retourne le résultat en supprimant les doublons à indices numériques
		return $getModuleInfo->fetch();
	}




	/* RENVOIE LA LISTE DES MODULES POUR UN UE D'UN SEMESTRE PARTICULER
	*
	* @UEUID<int>					l'UID d'un UE
	* @semestre<int>				l'UID du semestre
	*
	* @return modules<Array>		retourne un tableau contenant les modules de l'utilisateur pour ce semestre
	* @return existent<Boolean>			FAUX si aucun module n'a été trouvé
	*
	*/
	public static function forStudent($UEUID, $semestre){
		// on récupère les modules
		$getModulesForStudent = DataBase::getPDO()->prepare("SELECT DISTINCT m.id_module as id, m.nom, m.libelle ".
			"FROM module as m, semestre as s, mcc_ue, mcc_module as mcc_m ".
			"WHERE mcc_ue.id_semestre = s.id_semestre ".
			"AND   mcc_m.id_mcc_ue = mcc_ue.id_mcc_ue ".
			"AND   mcc_m.id_module = m.id_module ".

			"AND   mcc_ue.id_ue = :UEUID ".
			"AND   s.id_semestre = :semestre ".
			"ORDER BY m.nom, m.libelle");
		$getModulesForStudent->execute(array( ':UEUID' => $UEUID, ':semestre' => $semestre ));

		return DataBase::delNumeric( $getModulesForStudent->fetchAll() );
	}





	/* RENVOIE LA LISTE DES MODULES D'UN UE D'UNE ANNEE COURANTE (SEMESTRES COURANTS)
	*
	* @UEUID<int>						l'UID d'un UE
	* @semestre_pair<Boolean>			VRAI si le semestre est pair
	* @annee<int>						l'année en cours
	*
	* @return modules<Array>			retourne un tableau contenant les modules de l'utilisateur pour ce semestre
	* @return existent<Boolean>			FAUX si aucun module n'a été trouvé
	*
	*/
	public static function forYear($UEUID, $semestre_pair, $annee){
		// on récupère les modules
		$getModulesForYear = DataBase::getPDO()->prepare("SELECT DISTINCT m.id_module as id, m.nom, m.libelle ".
			"FROM module as m, mcc_module as mcc_m, mcc_ue, semestre as s ".
			"WHERE m.id_module = mcc_m.id_module ".
			"AND   mcc_m.id_mcc_ue = mcc_ue.id_mcc_ue ".
			"AND   mcc_ue.id_semestre = s.id_semestre ".

			"AND   mcc_ue.id_ue = :UEUID ".
			"AND   s.rang % 2 = :semestre_pair ".
			"AND   s.annee = :annee ".
			"ORDER BY s.rang, m.nom, m.libelle");
		$getModulesForYear->execute(array( ':UEUID' => $UEUID, ':semestre_pair' => ($semestre_pair) ? '0' : '1', ':annee' => $annee ));

		return DataBase::delNumeric( $getModulesForYear->fetchAll() );
	}






	/* CREE UN NOUVEAU MODULE DANS LA BASE DE DONNES
	*
	* @nom<String>					le nom du nouveau module
	* @libelle<String>				le libellé du nouveau module
	*
	* @return UID<String>			l'UID du nouveau module s'il a bien été créé
	* @return created<Boolean>		VRAI si le module n'existait pas déjà* et qu'il a bien été créé
	*								(*) Si aucun autre n'avait le même @nom
	*/
	public static function creer($nom, $libelle){
		/* [1] On normalise les données
		=================================================================================================*/
		$nom = strtoupper($nom); // nom en majuscules

		/* [2] On vérifie que le module n'est pas déjà créé
		=================================================================================================*/
		if( moduleRepo::UID($nom) ) // si on a un résultat, c'est qu'un module a déjà cee nom
			return false;

		/* [3] On créé le nouveu module
		=================================================================================================*/
		$creationModule = DataBase::getPDO()->prepare("INSERT INTO module(id_module, nom, libelle) ".
			"VALUES(DEFAULT, :nom, :libelle)");
		$creationModule->execute(array(
			':nom'     => $nom,
			':libelle' => $libelle
		));


		/* [4] On vérifie que le module a bien été créé
		=================================================================================================*/
		return moduleRepo::UID($nom);

	}



}