Subversion Repositories Applications.framework

Rev

Rev 199 | Rev 208 | 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 
/**
129 aurelien 4 
 * Classe fournissant des informations au Framework sur l'application.
5 
 *
186 jpm 6 
 * @category	PHP 5.2
7 
 * @package		Framework
8 
 * @author		Jean-Pascal MILCENT <jpm@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
197 aurelien 11 
 * @license		http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL-v2
186 jpm 12 
 * @version		SVN : $Id: Application.php 206 2010-10-18 14:05:20Z aurelien $
13 
 * @link		/doc/framework/
129 aurelien 14 
 */
95 jpm 15 
class Application {
96 jpm 16 
 
206 aurelien 17 
	/** Variable statique indiquant que les tableaux _GET et _POST ont déjà été encodé au format de l'appli. */
18 
	private static $encodage = false;
19 
 
129 aurelien 20 
	/**
186 jpm 21 
	 * Tableau d'informations sur l'application
129 aurelien 22 
	 */
96 jpm 23 
	private static $info = null;
129 aurelien 24 
	/**
186 jpm 25 
	 * Chemin de base de l'application
129 aurelien 26 
	 */
95 jpm 27 
	private static $chemin = null;
96 jpm 28 
 
129 aurelien 29 
	/**
186 jpm 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() {
199 jpm 35 
		// Initialiser les arguments des urls
36 
		self::initialiserUrl();
189 jpm 37 
		// Configuration du gestionnaire d'exception
38 
		GestionnaireException::configurer();
39 
		// Configuration du gestionnaire de logs
206 aurelien 40 
		//Log::configurer();
41 
		self::verifierEtReencoderTableauRequete();
186 jpm 42 
	}
197 aurelien 43 
 
186 jpm 44 
	/**
199 jpm 45 
	 * Initialise le format des urls.
46 
	 */
47 
	private static function initialiserUrl() {
48 
		ini_set('arg_separator.input', Config::get('fw_url_arg_separateur_entree'));
49 
		ini_set('arg_separator.output', Config::get('fw_url_arg_separateur_sortie'));
50 
	}
51 
 
52 
	/**
186 jpm 53 
	 * Permet d'indiquer le chemin de base de l'Application.
54 
	 * Cette méthode doit obligatoirement être utilisée par l'application pour que le Framework fonctionne correctement.
129 aurelien 55 
	 * @param string $chemin_fichier_principal chemin de base
56 
	 */
98 jpm 57 
	public static function setChemin($chemin_fichier_principal) {
95 jpm 58 
		if (self::$chemin === null) {
59 
			if (!file_exists($chemin_fichier_principal)) {
96 jpm 60 
				trigger_error("Le fichier indiqué n'existe pas. Utilisez __FILE__ dans la méthode set().", E_USER_ERROR);
95 jpm 61 
			} else {
62 
				self::$chemin = dirname($chemin_fichier_principal).DS;
186 jpm 63 
				self::initialiser();
95 jpm 64 
			}
65 
		} else {
98 jpm 66 
			trigger_error("Le chemin de l'application a déjà été enregistré auprès du Framework", E_USER_WARNING);
95 jpm 67 
		}
68 
	}
69 
 
129 aurelien 70 
	/**
71 
	 * accesseur pour le chemin
72 
	 * @return string le chemin
73 
	 */
95 jpm 74 
	public static function getChemin() {
75 
		return self::$chemin;
76 
	}
96 jpm 77 
 
98 jpm 78 
	/** Le tableau des informations sur l'application possède les clés suivantes :
79 
	 * - nom : nom de l'application
80 
	 * - abr : abréviation de l'application
81 
	 * - encodage : encodage de l'application (ISO-8859-15, UTF-8...)
82 
	 *
83 
	 * @param array $info tableau fournissant des informations sur l'application
84 
	 * @return void
85 
	 */
86 
	public static function setInfo($info) {
87 
		if (self::$info === null) {
88 
			self::$info = $info;
89 
		} else {
90 
			trigger_error("Le informations de l'application ont déjà été enregistrées auprès du Framework", E_USER_WARNING);
91 
		}
92 
	}
93 
 
129 aurelien 94 
	/**
95 
	 * accesseur pour le tableau d'infos
96 
	 * @param string $cle la clé à laquelle on veut accéder
97 
	 */
96 jpm 98 
	public static function getInfo($cle = null) {
99 
		if ($cle !== null) {
100 
			if (isset(self::$info[$cle])) {
101 
				return self::$info[$cle];
102 
			}
103 
		} else {
104 
			return self::$info;
105 
		}
95 jpm 106 
	}
206 aurelien 107 
 
108 
/**
109 
	 * Procédure vérifiant l'encodage des tableaux $_GET et $_POST et les transcodant dans l'encodage de l'application
110 
	 */
111 
	protected static function verifierEtReencoderTableauRequete() {
112 
		if (self::$encodage == false && Config::get('sortie_encodage') != Config::get('appli_encodage')) {
113 
			$_POST = self::encoderTableau($_POST, Config::get('appli_encodage'), Config::get('sortie_encodage'));
114 
			$_GET = self::encoderTableau($_GET, Config::get('appli_encodage'), Config::get('sortie_encodage'));
115 
 
116 
			// traitement des magic quotes
117 
			self::verifierEtTraiterSlashTableauRequete();
118 
 
119 
			self::$encodage = true;
120 
		}
121 
	}
122 
 
123 
	/**
124 
	 * Procédure vérifiant l'activation des magic quotes et remplacant les slash dans les tableaux de requete
125 
	 */
126 
	private static function verifierEtTraiterSlashTableauRequete() {
127 
 
128 
		if ( get_magic_quotes_gpc() ) {
129 
 
130 
			if (!function_exists('stripslashes_deep')) {
131 
			    function stripslashes_deep( $value ) {
132 
 
133 
					return ( is_array($value) )
134 
					    ? array_map('stripslashes_deep', $value)
135 
					    : stripslashes($value);
136 
 
137 
			    } // end of 'stripslashes_deep()'
138 
 
139 
			    $_GET = array_map('stripslashes_deep', $_GET);
140 
			    $_POST = array_map('stripslashes_deep', $_POST);
141 
			    $_COOKIE = array_map('stripslashes_deep', $_COOKIE);
142 
			}
143 
		}
144 
	}
145 
 
146 
	/**
147 
	 * Fonction récursive transcodant toutes les valeurs d'un tableau de leur encodage d'entrée vers un encodage de sortie donné
148 
	 * @param $tableau Array Un tableau de données à encoder
149 
	 * @param $encodage_sortie String l'encodage vers lequel on doit transcoder
150 
	 * @param $encodage_entree String l'encodage original des chaines du tableau (optionnel)
151 
	 * @return Array Le tableau encodé dans l'encodage de sortie
152 
	 *
153 
	 */
154 
	final static protected function encoderTableau($tableau, $encodage_sortie, $encodage_entree = null) {
155 
		if (is_array($tableau)) {
156 
			foreach ($tableau as $cle => $valeur) {
157 
				if (is_array($valeur)) {
158 
				 	$tableau[$cle] = self::encoderTableau($valeur, $encodage_sortie, $encodage_entree);
159 
				} else {
160 
					$tableau[$cle] = mb_convert_encoding($valeur, $encodage_sortie, $encodage_entree);
161 
				}
162 
			}
163 
		}
164 
		return $tableau;
165 
	}
95 jpm 166 
}