Subversion Repositories Applications.framework

Rev

Rev 221 | Rev 232 | Go to most recent revision | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
95 jpm 1 
<?php
96 jpm 2 
// declare(encoding='UTF-8');
3 
/**
221 jpm 4 
 * Classe de base du Framework :
5 
 *  - fournissant des infos sur l'application,
6 
 *  - paramétrant l'environnement de l'appli et du framework,
7 
 *  - réalisant des traitements sur les variables globales ($_GET, $_POST, $_COOKIE...)
8 
 *
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
11 
 * de l'application en se basant sur son propre emplacement.
129 aurelien 12 
 *
186 jpm 13 
 * @category	PHP 5.2
221 jpm 14 
 * @package	Framework
186 jpm 15 
 * @author		Jean-Pascal MILCENT <jpm@tela-botanica.org>
16 
 * @copyright	Copyright (c) 2009, Tela Botanica (accueil@tela-botanica.org)
221 jpm 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
19 
 * @version	SVN : $Id: Framework.php 230 2010-11-16 16:22:48Z jpm $
186 jpm 20 
 * @link		/doc/framework/
129 aurelien 21 
 */
221 jpm 22 
class Framework {
96 jpm 23 
 
206 aurelien 24 
	/** Variable statique indiquant que les tableaux _GET et _POST ont déjà été encodé au format de l'appli. */
25 
	private static $encodage = false;
26 
 
221 jpm 27 
	/** Tableau d'informations sur l'application */
96 jpm 28 
	private static $info = null;
221 jpm 29 
 
30 
	/** Chemin de base de l'application */
95 jpm 31 
	private static $chemin = null;
96 jpm 32 
 
129 aurelien 33 
	/**
221 jpm 34 
	 * Initialise l'environnement nécessaire au Framework : constantes globales, méthodeles autoload, séparateur d'arguments
35 
	 * d'url.
36 
	 * Cette méthode est appelée automatiquement suite à la définition du chemin de l'application via Application::setChemin().
37 
	 */
38 
	private static function initialiserEnvironnement() {
39 
		self::definirConstantesGlobales();
40 
		self::enregistrerMethodesAutoload();
41 
		self::initialiserUrl();
42 
	}
43 
 
44 
	/**
186 jpm 45 
	 * Initialise différentes classes du Framework nécessaires pour le fonctionnement de l'application.
46 
	 * Ces classes sont ensuites controlées via les fichiers de config.ini.
47 
	 * Elle est appelée automatiquement suite à la définition du chemin de l'application via Application::setChemin().
48 
	 */
221 jpm 49 
	private static function initialiserFramework() {
189 jpm 50 
		GestionnaireException::configurer();
206 aurelien 51 
		//Log::configurer();
52 
		self::verifierEtReencoderTableauRequete();
186 jpm 53 
	}
221 jpm 54 
 
186 jpm 55 
	/**
221 jpm 56 
	 * Redéfinit des constantes globales utiles pour le Framework et les applis.
57 
	 */
58 
	private static function definirConstantesGlobales() {
59 
		/** Redéfinition de la constante DIRECTORY_SEPARATOR en version abrégée DS */
60 
		if (!defined('DS')) {
61 
			define('DS', DIRECTORY_SEPARATOR);
62 
		}
63 
		/** Redéfinition de la constante PATH_SEPARATOR en version abrégée PS */
64 
		if (!defined('PS')) {
65 
			define('PS', PATH_SEPARATOR);
66 
		}
67 
	}
68 
 
69 
	private static function enregistrerMethodesAutoload() {
70 
		spl_autoload_register(array(get_class(), 'autoloadFw'));
71 
 
72 
		// Initialisation du gestionnaire d'erreur avant toute chose
73 
		GestionnaireException::initialiser();
74 
 
75 
		spl_autoload_register(array(get_class(), 'autoloadAppliDefaut'));
76 
 
77 
		// Autoload défini par l'application
78 
		if (function_exists('__autoload')) {
79 
			spl_autoload_register('__autoload');
80 
		}
81 
	}
82 
 
83 
	/**
84 
	 * Autoload pour le Framework.
85 
	 */
86 
	private static function autoloadFw($nom_classe_fw) {
87 
		$dossiers_classes = array(	dirname(__FILE__).DS,
88 
									dirname(__FILE__).DS.'utilitaires'.DS);
89 
		foreach ($dossiers_classes as $chemin) {
90 
			$fichier_a_tester = $chemin.$nom_classe_fw.'.php';
91 
			if (file_exists($fichier_a_tester)) {
92 
				include_once $fichier_a_tester;
93 
				return null;
94 
			}
95 
		}
96 
	}
97 
 
98 
	/**
99 
	 * Autoload par défaut pour l'application
100 
	 */
101 
	private static function autoloadAppliDefaut($nom_classe) {
102 
		$dossiers_classes = array(	Config::get('chemin_controleurs'),
103 
									Config::get('chemin_modeles'),
104 
									Config::get('chemin_bibliotheque'));
105 
 
106 
		foreach ($dossiers_classes as $chemin) {
107 
			$fichier_a_tester = $chemin.$nom_classe.'.php';
108 
			if (file_exists($fichier_a_tester)) {
109 
				include_once $fichier_a_tester;
110 
				return null;
111 
			}
112 
		}
113 
	}
114 
 
115 
	/**
199 jpm 116 
	 * Initialise le format des urls.
117 
	 */
118 
	private static function initialiserUrl() {
119 
		ini_set('arg_separator.input', Config::get('fw_url_arg_separateur_entree'));
120 
		ini_set('arg_separator.output', Config::get('fw_url_arg_separateur_sortie'));
121 
	}
122 
 
123 
	/**
186 jpm 124 
	 * Permet d'indiquer le chemin de base de l'Application.
125 
	 * Cette méthode doit obligatoirement être utilisée par l'application pour que le Framework fonctionne correctement.
129 aurelien 126 
	 * @param string $chemin_fichier_principal chemin de base
127 
	 */
221 jpm 128 
	public static function setCheminAppli($chemin_fichier_principal) {
95 jpm 129 
		if (self::$chemin === null) {
130 
			if (!file_exists($chemin_fichier_principal)) {
221 jpm 131 
				trigger_error("Le fichier indiqué n'existe pas. Utilisez __FILE__ dans la méthode setCheminAppli().", E_USER_ERROR);
95 jpm 132 
			} else {
221 jpm 133 
				self::initialiserEnvironnement();
95 jpm 134 
				self::$chemin = dirname($chemin_fichier_principal).DS;
221 jpm 135 
				self::initialiserFramework();
95 jpm 136 
			}
137 
		} else {
98 jpm 138 
			trigger_error("Le chemin de l'application a déjà été enregistré auprès du Framework", E_USER_WARNING);
95 jpm 139 
		}
140 
	}
141 
 
129 aurelien 142 
	/**
143 
	 * accesseur pour le chemin
144 
	 * @return string le chemin
145 
	 */
221 jpm 146 
	public static function getCheminAppli() {
95 jpm 147 
		return self::$chemin;
148 
	}
96 jpm 149 
 
98 jpm 150 
	/** Le tableau des informations sur l'application possède les clés suivantes :
151 
	 * - nom : nom de l'application
152 
	 * - abr : abréviation de l'application
153 
	 * - encodage : encodage de l'application (ISO-8859-15, UTF-8...)
154 
	 *
155 
	 * @param array $info tableau fournissant des informations sur l'application
156 
	 * @return void
157 
	 */
221 jpm 158 
	public static function setInfoAppli($info) {
98 jpm 159 
		if (self::$info === null) {
160 
			self::$info = $info;
161 
		} else {
162 
			trigger_error("Le informations de l'application ont déjà été enregistrées auprès du Framework", E_USER_WARNING);
163 
		}
164 
	}
165 
 
129 aurelien 166 
	/**
221 jpm 167 
	 * Accesseur pour le tableau d'infos sur l'application.
129 aurelien 168 
	 * @param string $cle la clé à laquelle on veut accéder
169 
	 */
221 jpm 170 
	public static function getInfoAppli($cle = null) {
96 jpm 171 
		if ($cle !== null) {
172 
			if (isset(self::$info[$cle])) {
173 
				return self::$info[$cle];
174 
			}
175 
		} else {
176 
			return self::$info;
177 
		}
95 jpm 178 
	}
206 aurelien 179 
 
221 jpm 180 
	/**
206 aurelien 181 
	 * Procédure vérifiant l'encodage des tableaux $_GET et $_POST et les transcodant dans l'encodage de l'application
182 
	 */
183 
	protected static function verifierEtReencoderTableauRequete() {
184 
		if (self::$encodage == false && Config::get('sortie_encodage') != Config::get('appli_encodage')) {
185 
			$_POST = self::encoderTableau($_POST, Config::get('appli_encodage'), Config::get('sortie_encodage'));
186 
			$_GET = self::encoderTableau($_GET, Config::get('appli_encodage'), Config::get('sortie_encodage'));
187 
 
221 jpm 188 
			// Traitement des magic quotes
206 aurelien 189 
			self::verifierEtTraiterSlashTableauRequete();
190 
 
191 
			self::$encodage = true;
192 
		}
193 
	}
194 
 
195 
	/**
196 
	 * Procédure vérifiant l'activation des magic quotes et remplacant les slash dans les tableaux de requete
197 
	 */
198 
	private static function verifierEtTraiterSlashTableauRequete() {
221 jpm 199 
		if (get_magic_quotes_gpc()) {
200 
			if (!function_exists('nettoyerSlashProfond')) {
201 
				function nettoyerSlashProfond($valeur) {
202 
					return ( is_array($valeur) ) ? array_map('nettoyerSlashProfond', $valeur) : stripslashes($valeur);
203 
				}
206 aurelien 204 
			}
221 jpm 205 
			$_GET = array_map('nettoyerSlashProfond', $_GET);
206 
			$_POST = array_map('nettoyerSlashProfond', $_POST);
207 
			$_COOKIE = array_map('nettoyerSlashProfond', $_COOKIE);
206 aurelien 208 
		}
209 
	}
210 
 
211 
	/**
212 
	 * Fonction récursive transcodant toutes les valeurs d'un tableau de leur encodage d'entrée vers un encodage de sortie donné
213 
	 * @param $tableau Array Un tableau de données à encoder
214 
	 * @param $encodage_sortie String l'encodage vers lequel on doit transcoder
215 
	 * @param $encodage_entree String l'encodage original des chaines du tableau (optionnel)
216 
	 * @return Array Le tableau encodé dans l'encodage de sortie
217 
	 *
218 
	 */
219 
	final static protected function encoderTableau($tableau, $encodage_sortie, $encodage_entree = null) {
220 
		if (is_array($tableau)) {
221 
			foreach ($tableau as $cle => $valeur) {
222 
				if (is_array($valeur)) {
223 
				 	$tableau[$cle] = self::encoderTableau($valeur, $encodage_sortie, $encodage_entree);
224 
				} else {
225 
					$tableau[$cle] = mb_convert_encoding($valeur, $encodage_sortie, $encodage_entree);
226 
				}
227 
			}
228 
		}
229 
		return $tableau;
230 
	}
208 gduche 231 
}
230 jpm 232 
?>