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()) {
|