WebSVN – Applications.framework – Diff – /trunk/framework/Framework.php

 <?php
 // declare(encoding='UTF-8');
 /**
+ * Classe de base du Framework :
- * Classe fournissant des informations au Framework sur l'application.
+ *  - 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.gnu.org/licenses/gpl.html Licence GNU-GPL-v3
- * @license		http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL-v2
+ * @license	http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL-v2
- * @version		SVN : $Id: Application.php 208 2010-11-03 09:42:54Z gduche $
+ * @version	SVN : $Id: Framework.php 221 2010-11-10 13:28:36Z jpm $
  * @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;
+	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();
 	private static $chemin = null;
 	/**
 	 * 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
+	 * Elle est appelée automatiquement suite à la définition du chemin de l'application via Application::setChemin().
-		self::initialiserUrl();
-		// Configuration du gestionnaire d'exception
+	 */
-		GestionnaireException::configurer();
+	private static function initialiserFramework() {
-		// Configuration du gestionnaire de logs
+		GestionnaireException::configurer();
+		//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;
-		//Log::configurer();
+			}
 		self::verifierEtReencoderTableauRequete();
+	}
 	/**
 	 * Initialise le format des urls.
 	/**
 	 * Permet d'indiquer le chemin de base de l'Application.
 	 * 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);
+		}
+	}
 	/**
 	 * accesseur pour le chemin
 	 * @return string le chemin
 	 */
-	public static function getChemin() {
+	public static function getCheminAppli() {
 		return self::$chemin;
+	}
 	 * - encodage : encodage de l'application (ISO-8859-15, UTF-8...)
+	 *
 	 * @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 {
 			trigger_error("Le informations de l'application ont déjà été enregistrées auprès du Framework", E_USER_WARNING);
+		}
+	}
 	/**
-	 * 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];
+			}
 		} else {
 			return self::$info;
+		}
 	}
-/**
+	/**
 	 * Procédure vérifiant l'encodage des tableaux $_GET et $_POST et les transcodant dans l'encodage de l'application
 	 */
 	protected static function verifierEtReencoderTableauRequete() {
 		if (self::$encodage == false && Config::get('sortie_encodage') != Config::get('appli_encodage')) {
 			$_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;
+		}
+	}
-	/**
-	 * Procédure vérifiant l'activation des magic quotes et remplacant les slash dans les tableaux de requete
-	 */
+	/**
-	private static function verifierEtTraiterSlashTableauRequete() {
+	 * Procédure vérifiant l'activation des magic quotes et remplacant les slash dans les tableaux de requete
-		if ( get_magic_quotes_gpc() ) {
+	 */
-			if (!function_exists('stripslashes_deep')) {
-			    function stripslashes_deep( $value ) {
-					return ( is_array($value) )
+	private static function verifierEtTraiterSlashTableauRequete() {
-					    ? array_map('stripslashes_deep', $value)
-					    : stripslashes($value);
-			    } // end of 'stripslashes_deep()'
+		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('stripslashes_deep', $_GET);
-			    $_POST = array_map('stripslashes_deep', $_POST);
+			$_GET = array_map('nettoyerSlashProfond', $_GET);
-			    $_COOKIE = array_map('stripslashes_deep', $_COOKIE);
+			$_POST = array_map('nettoyerSlashProfond', $_POST);

Subversion Repositories Applications.framework

(root)/trunk/framework/Framework.php – Rev 208 → 221