Subversion Repositories Applications.framework

Rev

Rev 179 | Rev 188 | Go to most recent revision | Only display areas with differences | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 179 Rev 185
1 
<?php
 1 
<?php
2 
// declare(encoding='UTF-8');
 2 
// declare(encoding='UTF-8');
3 
/**
 3 
/**
4 
 * Classe fournissant des informations au Framework sur l'application.
 4 
 * Classe fournissant des informations au Framework sur l'application.
5 
 *
 5 
 *
6 
 * PHP version 5
 6 
 * PHP version 5
7 
 *
 7 
 *
8 
 * @category Debogage
 8 
 * @category Debogage
9 
 * @package Framework
 9 
 * @package Framework
10 
 // Auteur principal :
 10 
 // Auteur principal :
11 
 * @author Jean-Pascal MILCENT <jpm@tela-botanica.org>
 11 
 * @author Jean-Pascal MILCENT <jpm@tela-botanica.org>
12 
 // Autres auteurs :
 12 
 // Autres auteurs :
13 
 * @license GPL v3 <http://www.gnu.org/licenses/gpl.txt>
 13 
 * @license GPL v3 <http://www.gnu.org/licenses/gpl.txt>
14 
 * @license CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt>
 14 
 * @license CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt>
15 
 * @version $$Id: Application.php 153 2010-03-04 10:48:32Z jpm $$
 15 
 * @version $Id: Application.php 185 2010-04-28 09:43:39Z jpm $
16 
 * @copyright 1999-2009 Tela Botanica (accueil@tela-botanica.org)
 16 
 * @copyright 1999-2009 Tela Botanica (accueil@tela-botanica.org)
17 
 */
 17 
 */
18 
class Application {
 18 
class Application {
19 
 
 19 
 
20 
	/**
 20 
	/**
21 
	 * tableau d'informations sur l'application
 21 
	 * Tableau d'informations sur l'application
22 
	 */
 22 
	 */
23 
	private static $info = null;
 23 
	private static $info = null;
24 
	/**
 24 
	/**
25 
	 * chemin de base de l'application
 25 
	 * Chemin de base de l'application
26 
	 */
 26 
	 */
27 
	private static $chemin = null;
 27 
	private static $chemin = null;
28 
 
 28 
 
29 
	/**
 29 
	/**
- 
 
 30 
	 * Initialise différentes classes du Framework nécessaires pour le fonctionnement de l'application.
- 
 
 31 
	 * Ces classes sont ensuites controlées via les fichiers de config.ini.
- 
 
 32 
	 * Elle est appelée automatiquement suite à la définition du chemin de l'application via Application::setChemin().
- 
 
 33 
	 */
- 
 
 34 
	private static function initialiser() {
- 
 
 35 
		// Instanciation du gestionnaire d'exception
- 
 
 36 
		GestionnaireException::getInstance();
- 
 
 37 
		// Instanciation du gestionnaire de logs
- 
 
 38 
		Log::getInstance();
- 
 
 39 
	}
- 
 
 40
- 
 
 41 
	/**
30 
	 * Modificateur pour le chemin de base
 42 
	 * Permet d'indiquer le chemin de base de l'Application.
- 
 
 43 
	 * Cette méthode doit obligatoirement être utilisée par l'application pour que le Framework fonctionne correctement.
31 
	 * @param string $chemin_fichier_principal chemin de base
 44 
	 * @param string $chemin_fichier_principal chemin de base
32 
	 */
 45 
	 */
33 
	public static function setChemin($chemin_fichier_principal) {
 46 
	public static function setChemin($chemin_fichier_principal) {
34 
		if (self::$chemin === null) {
 47 
		if (self::$chemin === null) {
35 
			if (!file_exists($chemin_fichier_principal)) {
 48 
			if (!file_exists($chemin_fichier_principal)) {
36 
				trigger_error("Le fichier indiqué n'existe pas. Utilisez __FILE__ dans la méthode set().", E_USER_ERROR);
 49 
				trigger_error("Le fichier indiqué n'existe pas. Utilisez __FILE__ dans la méthode set().", E_USER_ERROR);
37 
			} else {
 50 
			} else {
38 
				self::$chemin = dirname($chemin_fichier_principal).DS;
 51 
				self::$chemin = dirname($chemin_fichier_principal).DS;
- 
 
 52 
				self::initialiser();
39 
			}
 53 
			}
40 
		} else {
 54 
		} else {
41 
			trigger_error("Le chemin de l'application a déjà été enregistré auprès du Framework", E_USER_WARNING);
 55 
			trigger_error("Le chemin de l'application a déjà été enregistré auprès du Framework", E_USER_WARNING);
42 
		}
 56 
		}
43 
	}
 57 
	}
44 
 
 58 
 
45 
	/**
 59 
	/**
46 
	 * accesseur pour le chemin
 60 
	 * accesseur pour le chemin
47 
	 * @return string le chemin
 61 
	 * @return string le chemin
48 
	 */
 62 
	 */
49 
	public static function getChemin() {
 63 
	public static function getChemin() {
50 
		return self::$chemin;
 64 
		return self::$chemin;
51 
	}
 65 
	}
52 
 
 66 
 
53 
	/** Le tableau des informations sur l'application possède les clés suivantes :
 67 
	/** Le tableau des informations sur l'application possède les clés suivantes :
54 
	 * - nom : nom de l'application
 68 
	 * - nom : nom de l'application
55 
	 * - abr : abréviation de l'application
 69 
	 * - abr : abréviation de l'application
56 
	 * - encodage : encodage de l'application (ISO-8859-15, UTF-8...)
 70 
	 * - encodage : encodage de l'application (ISO-8859-15, UTF-8...)
57 
	 *
 71 
	 *
58 
	 * @param array $info tableau fournissant des informations sur l'application
 72 
	 * @param array $info tableau fournissant des informations sur l'application
59 
	 * @return void
 73 
	 * @return void
60 
	 */
 74 
	 */
61 
	public static function setInfo($info) {
 75 
	public static function setInfo($info) {
62 
		if (self::$info === null) {
 76 
		if (self::$info === null) {
63 
			self::$info = $info;
 77 
			self::$info = $info;
64 
		} else {
 78 
		} else {
65 
			trigger_error("Le informations de l'application ont déjà été enregistrées auprès du Framework", E_USER_WARNING);
 79 
			trigger_error("Le informations de l'application ont déjà été enregistrées auprès du Framework", E_USER_WARNING);
66 
		}
 80 
		}
67 
	}
 81 
	}
68 
 
 82 
 
69 
	/**
 83 
	/**
70 
	 * accesseur pour le tableau d'infos
 84 
	 * accesseur pour le tableau d'infos
71 
	 * @param string $cle la clé à laquelle on veut accéder
 85 
	 * @param string $cle la clé à laquelle on veut accéder
72 
	 */
 86 
	 */
73 
	public static function getInfo($cle = null) {
 87 
	public static function getInfo($cle = null) {
74 
		if ($cle !== null) {
 88 
		if ($cle !== null) {
75 
			if (isset(self::$info[$cle])) {
 89 
			if (isset(self::$info[$cle])) {
76 
				return self::$info[$cle];
 90 
				return self::$info[$cle];
77 
			}
 91 
			}
78 
		} else {
 92 
		} else {
79 
			return self::$info;
 93 
			return self::$info;
80 
		}
 94 
		}
81 
	}
 95 
	}
82 
}
 96 
}