WebSVN – Applications.framework – Diff – /trunk/framework/Application.php


<?php
// declare(encoding='UTF-8');
/**
 * Classe fournissant des informations au Framework sur l'application.
 *
 * @category	PHP 5.2
 * @package		Framework
 * @author		Jean-Pascal MILCENT <jpm@tela-botanica.org>
 * @copyright	Copyright (c) 2009, Tela Botanica (accueil@tela-botanica.org)
 * @license		http://www.gnu.org/licenses/gpl.html Licence GNU-GPL-v3
 * @license		http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL-v2 
 * @version		SVN : $Id: Application.php 189 2010-04-29 12:22:04Z jpm $
 * @link		/doc/framework/
 */
class Application {
 
	/**
	 * Tableau d'informations sur l'application
	 */
	private static $info = null;
	/**
	 * Chemin de base de l'application
	 */
	private static $chemin = null;
 
	/**
	 * Initialise différentes classes du Framework nécessaires pour le fonctionnement de l'application.
	 * Ces classes sont ensuites controlées via les fichiers de config.ini.
	 * Elle est appelée automatiquement suite à la définition du chemin de l'application via Application::setChemin().
	 */
	private static function initialiser() {
		// Configuration du gestionnaire d'exception
		GestionnaireException::configurer();
		// Configuration du gestionnaire de logs
		Log::configurer();
	}
	
	/**
	 * Permet d'indiquer le chemin de base de l'Application.
	 * Cette méthode doit obligatoirement être utilisée par l'application pour que le Framework fonctionne correctement.
	 * @param string $chemin_fichier_principal chemin de base
	 */
	public static function setChemin($chemin_fichier_principal) {
		if (self::$chemin === null) {
			if (!file_exists($chemin_fichier_principal)) {
				trigger_error("Le fichier indiqué n'existe pas. Utilisez __FILE__ dans la méthode set().", E_USER_ERROR);
			} else {
				self::$chemin = dirname($chemin_fichier_principal).DS;
				self::initialiser();
			}
		} else {
			trigger_error("Le chemin de l'application a déjà été enregistré auprès du Framework", E_USER_WARNING);
		}
	}
 
	/**
	 * accesseur pour le chemin
	 * @return string le chemin
	 */
	public static function getChemin() {
		return self::$chemin;
	}
 
	/** Le tableau des informations sur l'application possède les clés suivantes :
	 * - nom : nom de l'application
	 * - abr : abréviation de l'application
	 * - encodage : encodage de l'application (ISO-8859-15, UTF-8...)
	 *
	 * @param array $info tableau fournissant des informations sur l'application
	 * @return void
	 */
	public static function setInfo($info) {
		if (self::$info === null) {
			self::$info = $info;
		} else {
			trigger_error("Le informations de l'application ont déjà été enregistrées auprès du Framework", E_USER_WARNING);
		}
	}
 
	/**
	 * accesseur pour le tableau d'infos
	 * @param string $cle la clé à laquelle on veut accéder
	 */
	public static function getInfo($cle = null) {
		if ($cle !== null) {
			if (isset(self::$info[$cle])) {
				return self::$info[$cle];
			}
		} else {
			return self::$info;
		}
	}
}

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

Subversion Repositories Applications.framework

(root)/trunk/framework/Application.php – Rev 186 → 189