Subversion Repositories Applications.framework

Rev

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

Rev 377 Rev 392
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 377 2011-10-10 09:21:52Z jpm $
 19 
 * @version	$Id: Framework.php 392 2011-11-09 16:56:34Z 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 
	 */
 - 
 
63 
	private static function definirConstantesGlobales() {
 62 
	 */
- 
 
 63 
	private static function definirConstantesGlobales() {
64 
		/** Redéfinition de la constante DIRECTORY_SEPARATOR en version abrégée DS */
 64 
		if (!defined('DS')) {
65 
		if (!defined('DS')) {
 65 
			/** Redéfinition de la constante DIRECTORY_SEPARATOR en version abrégée DS */
66 
			define('DS', DIRECTORY_SEPARATOR);
 - 
 
67 
		}
 66 
			define('DS', DIRECTORY_SEPARATOR);
- 
 
 67 
		}
68 
		/** Redéfinition de la constante PATH_SEPARATOR en version abrégée PS */
 68 
		if (!defined('PS')) {
69 
		if (!defined('PS')) {
 69 
			/** Redéfinition de la constante PATH_SEPARATOR en version abrégée PS */
70 
			define('PS', PATH_SEPARATOR);
 70 
			define('PS', PATH_SEPARATOR);
71 
		}
 71 
		}
72 
	}
 72 
	}
73
73 
 
74 
	private static function enregistrerMethodesAutoload() {
 74 
	private static function enregistrerMethodesAutoload() {
75 
		spl_autoload_register(array(get_class(), 'autoloadFw'));
 75 
		spl_autoload_register(array(get_class(), 'autoloadFw'));
76
76 
 
77 
		// Vérification des paramètres de configuration obligatoire pour assurer le fonctionnement du Framework
 77 
		// Vérification des paramètres de configuration obligatoire pour assurer le fonctionnement du Framework
78 
		Config::verifierPresenceParametres(self::$parametres_obligatoires);
 78 
		Config::verifierPresenceParametres(self::$parametres_obligatoires);
79
79 
 
80 
		// Initialisation du gestionnaire d'erreur avant toute chose
 80 
		// Initialisation du gestionnaire d'erreur avant toute chose
81 
		GestionnaireException::initialiser();
 81 
		GestionnaireException::initialiser();
82
82 
 
83 
		spl_autoload_register(array(get_class(), 'autoloadAppliDefaut'));
 83 
		spl_autoload_register(array(get_class(), 'autoloadAppliDefaut'));
84
84 
 
85 
		// Autoload défini par l'application
 85 
		// Autoload défini par l'application
86 
		if (function_exists('__autoload')) {
 86 
		if (function_exists('__autoload')) {
87 
			spl_autoload_register('__autoload');
 87 
			spl_autoload_register('__autoload');
88 
		}
 88 
		}
89 
	}
 89 
	}
90
90 
 
91 
	/**
 91 
	/**
92 
	 * Autoload pour le Framework.
 92 
	 * Autoload pour le Framework.
93 
	 */
 93 
	 */
Line 102... Line 102...
102 
				include_once $fichier_a_tester;
 102 
				include_once $fichier_a_tester;
103 
				return null;
 103 
				return null;
104 
			}
 104 
			}
105 
		}
 105 
		}
106 
	}
 106 
	}
107
107 
 
108 
	/**
 108 
	/**
109 
	 * Autoload par défaut pour l'application
 109 
	 * Autoload par défaut pour l'application
110 
	 */
 110 
	 */
111 
	private static function autoloadAppliDefaut($nom_classe) {
 111 
	private static function autoloadAppliDefaut($nom_classe) {
112 
		$dossiers_classes = array(	Config::get('chemin_controleurs'),
 112 
		$dossiers_classes = array(	Config::get('chemin_controleurs'),
113 
									Config::get('chemin_modeles'),
 113 
									Config::get('chemin_modeles'),
114 
									Config::get('chemin_bibliotheque'));
 114 
									Config::get('chemin_bibliotheque'));
115
115 
 
116 
		foreach ($dossiers_classes as $chemin) {
 116 
		foreach ($dossiers_classes as $chemin) {
117 
			$fichier_a_tester = $chemin.$nom_classe.'.php';
 117 
			$fichier_a_tester = $chemin.$nom_classe.'.php';
118 
			if (file_exists($fichier_a_tester)) {
 118 
			if (file_exists($fichier_a_tester)) {
119 
				include_once $fichier_a_tester;
 119 
				include_once $fichier_a_tester;
120 
				return null;
 120 
				return null;
121 
			}
 121 
			}
122 
		}
 122 
		}
123 
	}
 123 
	}
124
124 
 
125 
	/**
 125 
	/**
126 
	 * Initialise le format des urls.
 126 
	 * Initialise le format des urls.
127 
	 */
 127 
	 */
128 
	private static function initialiserUrl() {
 128 
	private static function initialiserUrl() {
129 
		ini_set('arg_separator.input', Config::get('furl_arg_separateur_entree'));
 129 
		ini_set('arg_separator.input', Config::get('furl_arg_separateur_entree'));
130 
		ini_set('arg_separator.output', Config::get('url_arg_separateur_sortie'));
 130 
		ini_set('arg_separator.output', Config::get('url_arg_separateur_sortie'));
131 
	}
 131 
	}
132
132 
 
133 
	/**
 133 
	/**
134 
	 * Permet d'indiquer le chemin de base de l'Application.
 134 
	 * Permet d'indiquer le chemin de base de l'Application.
135 
	 * Cette méthode doit obligatoirement être utilisée par l'application pour que le Framework fonctionne correctement.
 135 
	 * Cette méthode doit obligatoirement être utilisée par l'application pour que le Framework fonctionne correctement.
136 
	 * @param string $chemin_fichier_principal chemin de base
 136 
	 * @param string $chemin_fichier_principal chemin de base
137 
	 */
 137 
	 */
Line 185... Line 185...
185 
			}
 185 
			}
186 
		} else {
 186 
		} else {
187 
			return self::$info;
 187 
			return self::$info;
188 
		}
 188 
		}
189 
	}
 189 
	}
190
190 
 
191 
	/**
 191 
	/**
192 
	 * Procédure vérifiant l'encodage des tableaux $_GET et $_POST et les transcodant dans l'encodage de l'application
 192 
	 * Procédure vérifiant l'encodage des tableaux $_GET et $_POST et les transcodant dans l'encodage de l'application
193 
	 */
 193 
	 */
194 
	protected static function verifierEtReencoderTableauRequete() {
 194 
	protected static function verifierEtReencoderTableauRequete() {
195 
		if (self::$encodage == false && Config::get('encodage_sortie') != Config::get('encodage_appli')) {
 195 
		if (self::$encodage == false && Config::get('encodage_sortie') != Config::get('encodage_appli')) {
196 
			$_POST = self::encoderTableau($_POST, Config::get('encodage_appli'), Config::get('encodage_sortie'));
 196 
			$_POST = self::encoderTableau($_POST, Config::get('encodage_appli'), Config::get('encodage_sortie'));
197 
			$_GET = self::encoderTableau($_GET, Config::get('encodage_appli'), Config::get('encodage_sortie'));
 197 
			$_GET = self::encoderTableau($_GET, Config::get('encodage_appli'), Config::get('encodage_sortie'));
198
198 
 
199 
			// Traitement des magic quotes
 199 
			// Traitement des magic quotes
200 
			self::verifierEtTraiterSlashTableauRequete();
 200 
			self::verifierEtTraiterSlashTableauRequete();
201
201 
 
202 
			self::$encodage = true;
 202 
			self::$encodage = true;
203 
		}
 203 
		}
204 
	}
 204 
	}
205
205 
 
206 
	/**
 206 
	/**
207 
	 * Procédure vérifiant l'activation des magic quotes et remplacant les slash dans les tableaux de requete
 207 
	 * Procédure vérifiant l'activation des magic quotes et remplacant les slash dans les tableaux de requete
208 
	 */
 208 
	 */
209 
	private static function verifierEtTraiterSlashTableauRequete() {
 209 
	private static function verifierEtTraiterSlashTableauRequete() {
210 
		if (get_magic_quotes_gpc()) {
 210 
		if (get_magic_quotes_gpc()) {