Subversion Repositories Applications.framework

Rev

Rev 304 | Go to most recent revision | Show entire file | Ignore whitespace | Details | Blame | Last modification | View Log | RSS feed

Rev 304 Rev 389
Line 1... Line 1...
1
<?php
1
<?php
2
// declare(encoding='UTF-8');
2
// declare(encoding='UTF-8');
3
/**
3
/**
4
 * Classe de base du Framework : 
4
 * Classe de base du Framework :
5
 *  - fournissant des infos sur l'application, 
5
 *  - fournissant des infos sur l'application,
6
 *  - paramétrant l'environnement de l'appli et du framework,
6
 *  - paramétrant l'environnement de l'appli et du framework,
7
 *  - réalisant des traitements sur les variables globales ($_GET, $_POST, $_COOKIE...)
7
 *  - réalisant des traitements sur les variables globales ($_GET, $_POST, $_COOKIE...)
8
 * 
8
 *
9
 * Cette classe contient la fonction de chargement automatique de classes.
9
 * Cette classe contient la fonction de chargement automatique de classes.
10
 * Ce fichier doit toujours rester à la racine du framework car il initialise le chemin 
10
 * Ce fichier doit toujours rester à la racine du framework car il initialise le chemin
11
 * de l'application en se basant sur son propre emplacement.
11
 * de l'application en se basant sur son propre emplacement.
12
 *
12
 *
13
 * @category	PHP 5.2
13
 * @category	PHP 5.2
14
 * @package	Framework
14
 * @package	Framework
15
 * @author		Jean-Pascal MILCENT <jpm@tela-botanica.org>
15
 * @author		Jean-Pascal MILCENT <jpm@tela-botanica.org>
16
 * @copyright	Copyright (c) 2010, Tela Botanica (accueil@tela-botanica.org)
16
 * @copyright	Copyright (c) 2010, Tela Botanica (accueil@tela-botanica.org)
17
 * @license	http://www.gnu.org/licenses/gpl.html Licence GNU-GPL-v3
17
 * @license	http://www.gnu.org/licenses/gpl.html Licence GNU-GPL-v3
18
 * @license	http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL-v2
18
 * @license	http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL-v2
19
 * @version	$Id: Framework.php 274 2010-12-28 15:37:22Z jpm $
19
 * @version	$Id: Framework.php 389 2011-11-07 13:47:22Z jpm $
20
 * @since		0.3
20
 * @since		0.3
21
 * @link		/doc/framework/
21
 * @link		/doc/framework/
22
 */
22
 */
23
class Framework {
23
class Framework {
Line 24... Line 24...
24
 
24
 
25
	/** Variable statique indiquant que les tableaux _GET et _POST ont déjà été encodé au format de l'appli. */
25
	/** Variable statique indiquant que les tableaux _GET et _POST ont déjà été encodé au format de l'appli. */
26
	private static $encodage = false;
26
	private static $encodage = false;
27
	
27
 
28
	/** Tableau d'informations sur l'application */
28
	/** Tableau d'informations sur l'application */
29
	private static $info = null;
29
	private static $info = null;
30
	
30
 
31
	/** Chemin de base de l'application */
31
	/** Chemin de base de l'application */
Line 32... Line 32...
32
	private static $chemin = null;
32
	private static $chemin = null;
33
 
33
 
34
	/** Tableau des noms des paramètres à définir dans le fichier de config car obligatoirement nécessaire à cette classe.*/
34
	/** Tableau des noms des paramètres à définir dans le fichier de config car obligatoirement nécessaire à cette classe.*/
35
	private static $parametres_obligatoires = array('chemin_controleurs', 'chemin_modeles', 'chemin_bibliotheque', 
35
	private static $parametres_obligatoires = array('chemin_controleurs', 'chemin_modeles', 'chemin_bibliotheque',
36
		'url_arg_separateur_entree', 'url_arg_separateur_sortie',
36
		'url_arg_separateur_entree', 'url_arg_separateur_sortie',
37
		'encodage_sortie', 'encodage_appli');
37
		'encodage_sortie', 'encodage_appli');
38
	
38
 
39
	/**
39
	/**
40
	 * Initialise l'environnement nécessaire au Framework : constantes globales, méthodeles autoload, séparateur d'arguments 
40
	 * Initialise l'environnement nécessaire au Framework : constantes globales, méthodeles autoload, séparateur d'arguments
41
	 * d'url.
41
	 * d'url.
42
	 * Cette méthode est appelée automatiquement suite à la définition du chemin de l'application via Application::setChemin().
42
	 * Cette méthode est appelée automatiquement suite à la définition du chemin de l'application via Application::setChemin().
43
	 */
43
	 */
44
	private static function initialiserEnvironnement() {
44
	private static function initialiserEnvironnement() {
45
		self::enregistrerMethodesAutoload();
45
		self::enregistrerMethodesAutoload();
46
		self::initialiserUrl();
46
		self::initialiserUrl();
47
	}
47
	}
48
	
48
 
49
	/**
49
	/**
50
	 * Initialise différentes classes du Framework nécessaires pour le fonctionnement de l'application.
50
	 * Initialise différentes classes du Framework nécessaires pour le fonctionnement de l'application.
51
	 * Ces classes sont ensuites controlées via les fichiers de config.ini.
51
	 * Ces classes sont ensuites controlées via les fichiers de config.ini.
52
	 * Elle est appelée automatiquement suite à la définition du chemin de l'application via Application::setChemin().
52
	 * Elle est appelée automatiquement suite à la définition du chemin de l'application via Application::setChemin().
53
	 */
53
	 */
54
	private static function initialiserFramework() {
54
	private static function initialiserFramework() {
55
		GestionnaireException::configurer();
55
		GestionnaireException::configurer();
56
		//Log::configurer();		
56
		//Log::configurer();
57
		self::verifierEtReencoderTableauRequete();
57
		self::verifierEtReencoderTableauRequete();
58
	}
58
	}
59
	
59
 
60
	/**
60
	/**
61
	 * Redéfinit des constantes globales utiles pour le Framework et les applis.
61
	 * Redéfinit des constantes globales utiles pour le Framework et les applis.
62
	 */
62
	 */
Line 68... Line 68...
68
		/** Redéfinition de la constante PATH_SEPARATOR en version abrégée PS */
68
		/** Redéfinition de la constante PATH_SEPARATOR en version abrégée PS */
69
		if (!defined('PS')) {
69
		if (!defined('PS')) {
70
			define('PS', PATH_SEPARATOR);
70
			define('PS', PATH_SEPARATOR);
71
		}
71
		}
72
	}
72
	}
73
	
73
 
-
 
74
	private static function definirCheminAppli($chemin) {
-
 
75
		if (is_file($chemin)) {
-
 
76
			self::$chemin = dirname($chemin).DS;
-
 
77
		} else if (is_dir($chemin)) {
-
 
78
			self::$chemin = $chemin;
-
 
79
		} else {
-
 
80
			throw new Exception("Le chemin indiqué '$chemin' n'est ni un fichier ni un dossier.");
-
 
81
		}
-
 
82
	}
-
 
83
 
74
	private static function enregistrerMethodesAutoload() {
84
	private static function enregistrerMethodesAutoload() {
75
		spl_autoload_register(array(get_class(), 'autoloadFw'));
85
		spl_autoload_register(array(get_class(), 'autoloadFw'));
76
		
86
 
77
		// Vérification des paramètres de configuration obligatoire pour assurer le fonctionnement du Framework
87
		// Vérification des paramètres de configuration obligatoire pour assurer le fonctionnement du Framework
78
		Config::verifierPresenceParametres(self::$parametres_obligatoires);
88
		Config::verifierPresenceParametres(self::$parametres_obligatoires);
79
		
89
 
80
		// Initialisation du gestionnaire d'erreur avant toute chose
90
		// Initialisation du gestionnaire d'erreur avant toute chose
81
		GestionnaireException::initialiser();
91
		GestionnaireException::initialiser();
82
		
92
 
83
		spl_autoload_register(array(get_class(), 'autoloadAppliDefaut'));
93
		spl_autoload_register(array(get_class(), 'autoloadAppliDefaut'));
84
		
94
 
85
		// Autoload défini par l'application
95
		// Autoload défini par l'application
86
		if (function_exists('__autoload')) {
96
		if (function_exists('__autoload')) {
87
			spl_autoload_register('__autoload');
97
			spl_autoload_register('__autoload');
88
		}
98
		}
89
	}
99
	}
90
	
100
 
91
	/**
101
	/**
92
	 * Autoload pour le Framework.
102
	 * Autoload pour le Framework.
93
	 */
103
	 */
94
	private static function autoloadFw($nom_classe_fw) {
104
	private static function autoloadFw($nom_classe_fw) {
95
		$dossiers_classes = array(	dirname(__FILE__).DS,
105
		$dossiers_classes = array(	dirname(__FILE__).DS,
Line 100... Line 110...
100
				include_once $fichier_a_tester;
110
				include_once $fichier_a_tester;
101
				return null;
111
				return null;
102
			}
112
			}
103
		}
113
		}
104
	}
114
	}
105
	
115
 
106
	/**
116
	/**
107
	 * Autoload par défaut pour l'application
117
	 * Autoload par défaut pour l'application
108
	 */
118
	 */
109
	private static function autoloadAppliDefaut($nom_classe) {
119
	private static function autoloadAppliDefaut($nom_classe) {
110
		$dossiers_classes = array(	Config::get('chemin_controleurs'),
120
		$dossiers_classes = array(	Config::get('chemin_controleurs'),
111
									Config::get('chemin_modeles'),
121
									Config::get('chemin_modeles'),
112
									Config::get('chemin_bibliotheque'));
122
									Config::get('chemin_bibliotheque'));
113
	
123
 
114
		foreach ($dossiers_classes as $chemin) {
124
		foreach ($dossiers_classes as $chemin) {
115
			$fichier_a_tester = $chemin.$nom_classe.'.php';
125
			$fichier_a_tester = $chemin.$nom_classe.'.php';
116
			if (file_exists($fichier_a_tester)) {
126
			if (file_exists($fichier_a_tester)) {
117
				include_once $fichier_a_tester;
127
				include_once $fichier_a_tester;
118
				return null;
128
				return null;
119
			}
129
			}
120
		}
130
		}
121
	}
131
	}
122
	
132
 
123
	/**
133
	/**
124
	 * Initialise le format des urls.
134
	 * Initialise le format des urls.
125
	 */
135
	 */
126
	private static function initialiserUrl() {
136
	private static function initialiserUrl() {
127
		ini_set('arg_separator.input', Config::get('furl_arg_separateur_entree'));
137
		ini_set('arg_separator.input', Config::get('furl_arg_separateur_entree'));
128
		ini_set('arg_separator.output', Config::get('url_arg_separateur_sortie'));
138
		ini_set('arg_separator.output', Config::get('url_arg_separateur_sortie'));
129
	}
139
	}
130
		
140
 
131
	/**
141
	/**
132
	 * Permet d'indiquer le chemin de base de l'Application.
142
	 * Permet d'indiquer le chemin de base de l'Application.
133
	 * Cette méthode doit obligatoirement être utilisée par l'application pour que le Framework fonctionne correctement.
143
	 * Cette méthode doit obligatoirement être utilisée par l'application pour que le Framework fonctionne correctement.
134
	 * @param string $chemin_fichier_principal chemin de base
144
	 * @param string $chemin_fichier_principal chemin de base
135
	 */
145
	 */
Line 137... Line 147...
137
		if (self::$chemin === null) {
147
		if (self::$chemin === null) {
138
			if (!file_exists($chemin_fichier_principal)) {
148
			if (!file_exists($chemin_fichier_principal)) {
139
				trigger_error("Le fichier indiqué n'existe pas. Utilisez __FILE__ dans la méthode setCheminAppli().", E_USER_ERROR);
149
				trigger_error("Le fichier indiqué n'existe pas. Utilisez __FILE__ dans la méthode setCheminAppli().", E_USER_ERROR);
140
			} else {
150
			} else {
141
				self::definirConstantesGlobales();
151
				self::definirConstantesGlobales();
142
				self::$chemin = dirname($chemin_fichier_principal).DS;
152
				self::definirCheminAppli($chemin_fichier_principal);
143
				self::initialiserEnvironnement();
153
				self::initialiserEnvironnement();
144
				self::initialiserFramework();
154
				self::initialiserFramework();
145
			}
155
			}
146
		} else {
156
		} else {
147
			trigger_error("Le chemin de l'application a déjà été enregistré auprès du Framework", E_USER_WARNING);
157
			trigger_error("Le chemin de l'application a déjà été enregistré auprès du Framework", E_USER_WARNING);
Line 183... Line 193...
183
			}
193
			}
184
		} else {
194
		} else {
185
			return self::$info;
195
			return self::$info;
186
		}
196
		}
187
	}
197
	}
188
	
198
 
189
	/**
199
	/**
190
	 * Procédure vérifiant l'encodage des tableaux $_GET et $_POST et les transcodant dans l'encodage de l'application
200
	 * Procédure vérifiant l'encodage des tableaux $_GET et $_POST et les transcodant dans l'encodage de l'application
191
	 */
201
	 */
192
	protected static function verifierEtReencoderTableauRequete() {
202
	protected static function verifierEtReencoderTableauRequete() {
193
		if (self::$encodage == false && Config::get('encodage_sortie') != Config::get('encodage_appli')) {
203
		if (self::$encodage == false && Config::get('encodage_sortie') != Config::get('encodage_appli')) {
194
			$_POST = self::encoderTableau($_POST, Config::get('encodage_appli'), Config::get('encodage_sortie'));
204
			$_POST = self::encoderTableau($_POST, Config::get('encodage_appli'), Config::get('encodage_sortie'));
195
			$_GET = self::encoderTableau($_GET, Config::get('encodage_appli'), Config::get('encodage_sortie'));
205
			$_GET = self::encoderTableau($_GET, Config::get('encodage_appli'), Config::get('encodage_sortie'));
196
			
206
 
197
			// Traitement des magic quotes
207
			// Traitement des magic quotes
198
			self::verifierEtTraiterSlashTableauRequete();
208
			self::verifierEtTraiterSlashTableauRequete();
199
						
209
 
200
			self::$encodage = true;
210
			self::$encodage = true;
201
		}
211
		}
202
	}
212
	}
203
	
213
 
204
	/**
214
	/**
205
	 * Procédure vérifiant l'activation des magic quotes et remplacant les slash dans les tableaux de requete
215
	 * Procédure vérifiant l'activation des magic quotes et remplacant les slash dans les tableaux de requete
206
	 */
216
	 */
207
	private static function verifierEtTraiterSlashTableauRequete() {
217
	private static function verifierEtTraiterSlashTableauRequete() {
208
		if (get_magic_quotes_gpc()) {
218
		if (get_magic_quotes_gpc()) {