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 208 2010-11-03 09:42:54Z gduche $
|
|
|
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 |
}
|
208 |
gduche |
166 |
}
|