1,47 → 1,118 |
<?php |
// declare(encoding='UTF-8'); |
/** |
* Classe fournissant des informations au Framework sur l'application. |
* Classe de base du Framework : |
* - fournissant des infos sur l'application, |
* - paramétrant l'environnement de l'appli et du framework, |
* - réalisant des traitements sur les variables globales ($_GET, $_POST, $_COOKIE...) |
* |
* Cette classe contient la fonction de chargement automatique de classes. |
* Ce fichier doit toujours rester à la racine du framework car il initialise le chemin |
* de l'application en se basant sur son propre emplacement. |
* |
* @category PHP 5.2 |
* @package Framework |
* @package Framework |
* @author Jean-Pascal MILCENT <jpm@tela-botanica.org> |
* @copyright Copyright (c) 2009, Tela Botanica (accueil@tela-botanica.org) |
* @license http://www.gnu.org/licenses/gpl.html Licence GNU-GPL-v3 |
* @license http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL-v2 |
* @version SVN : $Id$ |
* @license http://www.gnu.org/licenses/gpl.html Licence GNU-GPL-v3 |
* @license http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL-v2 |
* @version SVN : $Id$ |
* @link /doc/framework/ |
*/ |
class Application { |
class Framework { |
|
/** Variable statique indiquant que les tableaux _GET et _POST ont déjà été encodé au format de l'appli. */ |
private static $encodage = false; |
|
/** |
* Tableau d'informations sur l'application |
*/ |
/** Tableau d'informations sur l'application */ |
private static $info = null; |
/** |
* Chemin de base de l'application |
*/ |
|
/** Chemin de base de l'application */ |
private static $chemin = null; |
|
/** |
* Initialise l'environnement nécessaire au Framework : constantes globales, méthodeles autoload, séparateur d'arguments |
* d'url. |
* Cette méthode est appelée automatiquement suite à la définition du chemin de l'application via Application::setChemin(). |
*/ |
private static function initialiserEnvironnement() { |
self::definirConstantesGlobales(); |
self::enregistrerMethodesAutoload(); |
self::initialiserUrl(); |
} |
|
/** |
* Initialise différentes classes du Framework nécessaires pour le fonctionnement de l'application. |
* Ces classes sont ensuites controlées via les fichiers de config.ini. |
* Elle est appelée automatiquement suite à la définition du chemin de l'application via Application::setChemin(). |
*/ |
private static function initialiser() { |
// Initialiser les arguments des urls |
self::initialiserUrl(); |
// Configuration du gestionnaire d'exception |
private static function initialiserFramework() { |
GestionnaireException::configurer(); |
// Configuration du gestionnaire de logs |
//Log::configurer(); |
self::verifierEtReencoderTableauRequete(); |
} |
|
|
/** |
* Redéfinit des constantes globales utiles pour le Framework et les applis. |
*/ |
private static function definirConstantesGlobales() { |
/** Redéfinition de la constante DIRECTORY_SEPARATOR en version abrégée DS */ |
if (!defined('DS')) { |
define('DS', DIRECTORY_SEPARATOR); |
} |
/** Redéfinition de la constante PATH_SEPARATOR en version abrégée PS */ |
if (!defined('PS')) { |
define('PS', PATH_SEPARATOR); |
} |
} |
|
private static function enregistrerMethodesAutoload() { |
spl_autoload_register(array(get_class(), 'autoloadFw')); |
|
// Initialisation du gestionnaire d'erreur avant toute chose |
GestionnaireException::initialiser(); |
|
spl_autoload_register(array(get_class(), 'autoloadAppliDefaut')); |
|
// Autoload défini par l'application |
if (function_exists('__autoload')) { |
spl_autoload_register('__autoload'); |
} |
} |
|
/** |
* Autoload pour le Framework. |
*/ |
private static function autoloadFw($nom_classe_fw) { |
$dossiers_classes = array( dirname(__FILE__).DS, |
dirname(__FILE__).DS.'utilitaires'.DS); |
foreach ($dossiers_classes as $chemin) { |
$fichier_a_tester = $chemin.$nom_classe_fw.'.php'; |
if (file_exists($fichier_a_tester)) { |
include_once $fichier_a_tester; |
return null; |
} |
} |
} |
|
/** |
* Autoload par défaut pour l'application |
*/ |
private static function autoloadAppliDefaut($nom_classe) { |
$dossiers_classes = array( Config::get('chemin_controleurs'), |
Config::get('chemin_modeles'), |
Config::get('chemin_bibliotheque')); |
|
foreach ($dossiers_classes as $chemin) { |
$fichier_a_tester = $chemin.$nom_classe.'.php'; |
if (file_exists($fichier_a_tester)) { |
include_once $fichier_a_tester; |
return null; |
} |
} |
} |
|
/** |
* Initialise le format des urls. |
*/ |
private static function initialiserUrl() { |
54,13 → 125,14 |
* Cette méthode doit obligatoirement être utilisée par l'application pour que le Framework fonctionne correctement. |
* @param string $chemin_fichier_principal chemin de base |
*/ |
public static function setChemin($chemin_fichier_principal) { |
public static function setCheminAppli($chemin_fichier_principal) { |
if (self::$chemin === null) { |
if (!file_exists($chemin_fichier_principal)) { |
trigger_error("Le fichier indiqué n'existe pas. Utilisez __FILE__ dans la méthode set().", E_USER_ERROR); |
trigger_error("Le fichier indiqué n'existe pas. Utilisez __FILE__ dans la méthode setCheminAppli().", E_USER_ERROR); |
} else { |
self::initialiserEnvironnement(); |
self::$chemin = dirname($chemin_fichier_principal).DS; |
self::initialiser(); |
self::initialiserFramework(); |
} |
} else { |
trigger_error("Le chemin de l'application a déjà été enregistré auprès du Framework", E_USER_WARNING); |
71,7 → 143,7 |
* accesseur pour le chemin |
* @return string le chemin |
*/ |
public static function getChemin() { |
public static function getCheminAppli() { |
return self::$chemin; |
} |
|
83,7 → 155,7 |
* @param array $info tableau fournissant des informations sur l'application |
* @return void |
*/ |
public static function setInfo($info) { |
public static function setInfoAppli($info) { |
if (self::$info === null) { |
self::$info = $info; |
} else { |
92,10 → 164,10 |
} |
|
/** |
* accesseur pour le tableau d'infos |
* Accesseur pour le tableau d'infos sur l'application. |
* @param string $cle la clé à laquelle on veut accéder |
*/ |
public static function getInfo($cle = null) { |
public static function getInfoAppli($cle = null) { |
if ($cle !== null) { |
if (isset(self::$info[$cle])) { |
return self::$info[$cle]; |
105,7 → 177,7 |
} |
} |
|
/** |
/** |
* Procédure vérifiant l'encodage des tableaux $_GET et $_POST et les transcodant dans l'encodage de l'application |
*/ |
protected static function verifierEtReencoderTableauRequete() { |
113,7 → 185,7 |
$_POST = self::encoderTableau($_POST, Config::get('appli_encodage'), Config::get('sortie_encodage')); |
$_GET = self::encoderTableau($_GET, Config::get('appli_encodage'), Config::get('sortie_encodage')); |
|
// traitement des magic quotes |
// Traitement des magic quotes |
self::verifierEtTraiterSlashTableauRequete(); |
|
self::$encodage = true; |
124,22 → 196,15 |
* Procédure vérifiant l'activation des magic quotes et remplacant les slash dans les tableaux de requete |
*/ |
private static function verifierEtTraiterSlashTableauRequete() { |
|
if ( get_magic_quotes_gpc() ) { |
|
if (!function_exists('stripslashes_deep')) { |
function stripslashes_deep( $value ) { |
|
return ( is_array($value) ) |
? array_map('stripslashes_deep', $value) |
: stripslashes($value); |
|
} // end of 'stripslashes_deep()' |
|
$_GET = array_map('stripslashes_deep', $_GET); |
$_POST = array_map('stripslashes_deep', $_POST); |
$_COOKIE = array_map('stripslashes_deep', $_COOKIE); |
if (get_magic_quotes_gpc()) { |
if (!function_exists('nettoyerSlashProfond')) { |
function nettoyerSlashProfond($valeur) { |
return ( is_array($valeur) ) ? array_map('nettoyerSlashProfond', $valeur) : stripslashes($valeur); |
} |
} |
$_GET = array_map('nettoyerSlashProfond', $_GET); |
$_POST = array_map('nettoyerSlashProfond', $_POST); |
$_COOKIE = array_map('nettoyerSlashProfond', $_COOKIE); |
} |
} |
|