/branches/v0.2-buhl/framework/I18n.php |
---|
New file |
0,0 → 1,248 |
<?php |
// declare(encoding='UTF-8'); |
/** |
* I18n permet de traduire une application à partir de données stockées dans des fichiers ini. |
* Si vous souhaitez utiliser le fonctionnement par défaut vous devrez : |
* - déposer les fichiers ini dans le dossier définit par la variable de config "chemin_i18n". |
* - nommer les fichiers selon la forme "locale.ini" (Ex.: fr.ini ou fr_CH.ini ). |
* |
* Elle offre l'accès en lecture seule aux paramètres de des fichiers ini. |
* C'est une Singleton. Une seule classe de traduction peut être instanciée par Application. |
* |
* @category PHP 5.2 |
* @package Framework |
* @author Jean-Pascal MILCENT <jpm@tela-botanica.org> |
* @copyright Copyright (c) 2010, Tela Botanica (accueil@tela-botanica.org) |
* @license GNU-GPL-v3 <http://www.gnu.org/licenses/gpl.html> |
* @license CECILL-v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt> |
*/ |
class I18n { |
/** Format de traduction utilisant les fichier .ini */ |
const FORMAT_INI = '.ini'; |
/** Instance de la classe pointant sur elle même (pour le pattern singleton) */ |
private static $instance = null; |
/** Fichiers de traduction disponibles. */ |
private static $traductions = array(); |
/** Langue courrante utilisée par l'application. */ |
private static $langue = null; |
private function __construct() { |
self::verifierParametresConfig(); |
self::trouverLangue(); |
} |
/** |
* Accesseur pour la valeur d'une traduction |
* @param string $param le nom du paramètre |
* @return string la valeur du paramètre |
*/ |
public static function get($identifiant, $langue = null) { |
self::verifierCreationInstance(); |
$texte = ''; |
// Récupération de la langue actuellement demandée |
$langue_a_charger = self::$langue; |
if (!is_null($langue)) { |
$langue_a_charger = $langue; |
} |
if (!isset(self::$traductions[$langue_a_charger])) { |
// Tentative de chargement du fichier de traduction |
$chargement = self::charger($langue_a_charger); |
if ($chargement === false) { |
$m = "Le fichier d'i18n pour la langue '$langue_a_charger' demandée n'a pas été trouvé."; |
self::ajouterErreur($m); |
} |
} |
// Recherche de la langue dans le tableau des traductions |
if (isset(self::$traductions[$langue_a_charger]) && self::$traductions[$langue_a_charger] !== false) { |
// Recherche de la traduction demandée |
$valeur = self::getValeur($identifiant, self::$traductions[$langue_a_charger]); |
if ($valeur !== false) { |
$texte = $valeur; |
} else { |
$m = "Le traduction n'existe pas pour l'identifiant '$identifiant' demandé."; |
self::ajouterErreur($m); |
} |
} |
return $texte; |
} |
/** |
* Charge un fichier ini dans le tableau des paramètres de l'appli |
* @param string $fichier_ini le nom du fichier à charger |
* @return boolean true, si le fichier a été trouvé et correctement chargé, sinon false. |
*/ |
public static function charger($langue, $fichier = null, $format = self::FORMAT_INI) { |
self::verifierCreationInstance(); |
$ok = false; |
// Création du chemin vers le fichier de traduction par défaut |
if (is_null($fichier)) { |
$fichier = Config::get('chemin_i18n').$langue.$format; |
} |
// Chargement |
if ($format == self::FORMAT_INI) { |
$ok = self::chargerFichierIni($fichier, $langue); |
} else { |
$m = "Le format '$format' de fichier de traduction n'est pas pris en compte par le Framework."; |
self::ajouterErreur($m); |
} |
return $ok; |
} |
/** |
* Définit la langue utiliser pour rechercher une traduction. |
* @param string $fichier_ini le nom du fichier à charger |
* @return array le fichier ini parsé |
*/ |
public static function setLangue($langue) { |
self::verifierCreationInstance(); |
self::$langue = $langue; |
} |
/** |
* Renvoie la valeur demandé grâce une chaine de paramètres |
* @param string $param la chaine identifiante |
* @param array $i18n le tableau de traductions |
* @return mixed la valeur correspondante à la chaine identifiante si elle est trouvée, sinon false. |
*/ |
private static function getValeur($param, $i18n) { |
if ($param === null) { |
return false; |
} else { |
if (isset($i18n[$param])) { |
return $i18n[$param]; |
} else if (strpos($param, '.') !== false) { |
$pieces = explode('.', $param, 2); |
if (strlen($pieces[0]) && strlen($pieces[1])) { |
if (isset($i18n[$pieces[0]])) { |
if (is_array($i18n[$pieces[0]])) { |
return self::getValeur($pieces[1], $i18n[$pieces[0]]); |
} |
} |
} |
} else { |
return false; |
} |
} |
} |
/** |
* Parse le fichier ini donné en paramètre |
* @param string $fichier_ini nom du fichier ini à parser |
* @param string $langue la langue correspondant au fichier |
* @return boolean true si le chargement c'est bien passé, sinon false. |
*/ |
private static function chargerFichierIni($fichier_ini, $langue) { |
self::$traductions[$langue] = false; |
if (file_exists($fichier_ini)) { |
$ini = parse_ini_file($fichier_ini, true); |
Debug::printr($ini, 'Avant :'); |
$ini = self::analyserTableauIni($ini); |
Debug::printr($ini, 'Aprés :'); |
self::$traductions[$langue] = $ini; |
} |
return (self::$traductions[$langue] === false) ? false : true; |
} |
/** |
* Analyse un tableau de traductions pour évaluer les clés. |
* @param array $i18n le tableau de traductions |
* @return array le tableau analysé et modifié si nécessaire. |
*/ |
private static function analyserTableauIni($i18n = array()) { |
//ATTENTION : il est important de passer la valeur par référence car nous la modifions dynamiquement dans la boucle |
foreach ($i18n as $cle => &$valeur) { |
if (is_array($valeur)) { |
$i18n[$cle] = self::analyserTableauIni($valeur); |
} else { |
$i18n = self::evaluerCle($i18n, $cle, $valeur); |
} |
} |
return $i18n; |
} |
/** |
* Dans le cas des chaines de traduction à sous clé (ex.: cle.souscle), cette méthode |
* évalue les valeurs correspondantes et créée les sous tableaux associés. |
* @param array $i18n tableau de traductions (par référence) |
* @param string $cle la cle dans le tableau |
* @param string $valeur la valeur à affecter |
*/ |
private static function evaluerCle($i18n, $cle, $valeur) { |
if (strpos($cle, '.') !== false) { |
unset($i18n[$cle]); |
$pieces = explode('.', $cle, 2); |
if (strlen($pieces[0]) && strlen($pieces[1])) { |
if (isset($i18n[$pieces[0]]) && !is_array($i18n[$pieces[0]])) { |
$m = "Ne peut pas créer de sous-clé pour '{$pieces[0]}' car la clé existe déjà"; |
trigger_error($m, E_USER_WARNING); |
} else { |
$i18n[$pieces[0]][$pieces[1]] = $valeur; |
$i18n[$pieces[0]] = self::evaluerCle($i18n[$pieces[0]], $pieces[1], $valeur); |
} |
} else { |
$m = "Clé invalide '$cle'"; |
trigger_error($m, E_USER_WARNING); |
} |
} else { |
$i18n[$cle] = $valeur; |
} |
return $i18n; |
} |
/** |
* Cherche l'information sur la langue demandée par l'application |
*/ |
private static function trouverLangue() { |
if (isset($_GET[Config::get('i18n_url_parametre')])) { |
self::$langue = $_GET[Config::get('i18n_url_parametre')]; |
} else { |
self::$langue = Config::get('i18n_langue_defaut'); |
} |
} |
/** |
* Vérifie si l'instance de classe à été crée, si non la crée |
*/ |
private static function verifierCreationInstance() { |
if (empty(self::$instance)) { |
self::$instance = new I18n(); |
} |
} |
/** |
* Vérifie que tous les paramêtres de config nécessaires au fonctionnement de cette classe existe dans les fichiers |
* de configurations. |
*/ |
private static function verifierParametresConfig() { |
$ok = true; |
$parametres = array('chemin_i18n', 'i18n_url_parametre', 'i18n_langue_defaut'); |
foreach ($parametres as $param) { |
if (is_null(Config::get($param))) { |
$m = "L'utilisation de la classe I18n nécessite de définir '$param' dans un fichier de configuration."; |
self::ajouterErreur($m); |
$ok = false; |
} |
} |
return $ok; |
} |
/** |
* Ajouter une message d'erreur |
*/ |
private static function ajouterErreur($m, $e = E_USER_WARNING) { |
if (Config::get('fw_debogage') === true) { |
trigger_error($m, $e); |
} |
} |
} |
/branches/v0.2-buhl/framework/Log.php |
---|
5,11 → 5,10 |
* |
* @category PHP 5.2 |
* @package Framework |
* @author aurelien <aurelien@tela-botanica.org> |
* @copyright 2009 Tela-Botanica |
* @license http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL |
* @version SVN: $Id$ |
* @link /doc/framework/ |
* @author Aurélien PERONNET <aurelien@tela-botanica.org> |
* @copyright Copyright (c) 2009, Tela Botanica (accueil@tela-botanica.org) |
* @license GNU-GPL-v3 <http://www.gnu.org/licenses/gpl.html> |
* @license CECILL-v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt> |
*/ |
class Log { |
/branches/v0.2-buhl/framework/Application.php |
---|
3,17 → 3,12 |
/** |
* Classe fournissant des informations au Framework sur l'application. |
* |
* PHP version 5 |
* |
* @category Debogage |
* @category PHP 5.2 |
* @package Framework |
// Auteur principal : |
* @author Jean-Pascal MILCENT <jpm@tela-botanica.org> |
// Autres auteurs : |
* @license GPL v3 <http://www.gnu.org/licenses/gpl.txt> |
* @license CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt> |
* @version $Id$ |
* @copyright 1999-2009 Tela Botanica (accueil@tela-botanica.org) |
* @copyright Copyright (c) 2009, Tela Botanica (accueil@tela-botanica.org) |
* @license GNU-GPL-v3 <http://www.gnu.org/licenses/gpl.html> |
* @license CECILL-v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt> |
*/ |
class Application { |
/branches/v0.2-buhl/framework/config.defaut.ini |
---|
21,6 → 21,10 |
; Débogage |
; Indique si oui ou non on veut afficher le débogage. |
fw_debogage = true |
; Indique sous quelle forme les méssages de débogage doivent s'afficher : |
; - Debug::MODE_ECHO : le message est affiché en utilisant echo |
; - Debug::MODE_NOTICE : le message est affiché en utilisant une erreur de type notice |
fw_debogage_mode = "php:Debug::MODE_ECHO" |
; Indique si oui ou non on veut afficher le contexte de débogage. |
fw_debogage_contexte = false |
; Niveau d'erreur à employer pour le code PHP. Voir le manuel de PHP pour les différents niveaux disponibles. |
27,6 → 31,9 |
fw_debogage_niveau = 2048 |
; Indique si oui ou non on veut activer la journalisation des erreurs. |
fw_log_debogage = false |
; +------------------------------------------------------------------------------------------------------+ |
; Log |
; Indique le fuseau horaire pour le datage des logs. |
fw_timezone = Europe/Paris |
; Indique la taille max d'un fichier log (en octets) |
38,7 → 45,7 |
fw_benchmark_chrono = true |
; +------------------------------------------------------------------------------------------------------+ |
; Chemins et fichiers |
; Chemins, dossiers et fichiers |
; Nom des fichiers de config recherché. Défini par défaut dans la classe Config |
; fw_fichier_config = "config%s.ini" |
; Chemin vers le dossier du framework. Défini par défaut dans la classe Config |
107,6 → 114,13 |
sortie_encodage = "UTF-8" |
; +------------------------------------------------------------------------------------------------------+ |
; I18n |
; Indique le nom du paramêtre à rechercher dans le GET pour connaître la langue actuellement demandée |
i18n_url_parametre = "langue" |
; Indique la langue par défaut |
i18n_langue_defaut = "fr" |
; +------------------------------------------------------------------------------------------------------+ |
; URLs |
; URL de base de l'application, si elle est laissée vide, l'application fonctionnera en Stand-alone |
; Peut utiliser une objet Net_URL comme ceci : "php:$mon_objet_net_url->getUrl()" |
/branches/v0.2-buhl/framework/Chronometre.php |
---|
1,32 → 1,25 |
<?php |
// declare(encoding='UTF-8'); |
/** Classe Chronometre() - Permet de stocker et d'afficher |
* les temps d'éxécution de script. |
/** Classe Chronometre() - Permet de stocker et d'afficher les temps d'éxécution de script. |
* |
* Cette classe permet de réaliser un ensemble |
* de mesure de temps prises à |
* différents endroits d'un script. |
* Ces mesures peuvent ensuite être affichées au |
* sein d'un tableau XHTML. |
* Cette classe permet de réaliser un ensemble de mesure de temps prises à différents endroits d'un script. |
* Ces mesures peuvent ensuite être affichées au sein d'un tableau XHTML. |
* |
* |
* PHP Version 5 |
* |
* @category PHP |
* @category PHP 5.2 |
* @package Framework |
* @author Jean-Pascal MILCENT <jpm@tela-botanica.org> |
* @copyright 2009 Tela-Botanica |
* @license http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL |
* @version Release: <package_version> |
* @link /doc/framework/ |
* @copyright Copyright (c) 2009, Tela Botanica (accueil@tela-botanica.org) |
* @license GNU-GPL-v3 <http://www.gnu.org/licenses/gpl.html> |
* @license CECILL-v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt> |
*/ |
class Chronometre { |
/*** Attributs : ***/ |
private $_temps = array(); |
private static $instance = null; |
private static $temps = array(); |
/** Constructeur : **/ |
public function __construct() { |
$this->setTemps(array('depart' => microtime())); |
private function __construct() { |
self::setTemps('depart', microtime()); |
} |
/** Accesseurs : |
35,12 → 28,12 |
* |
* @return int le temps écoulé |
*/ |
public function getTemps($cle = null) { |
private static function getTemps($cle = null) { |
$temps = ''; |
if (!is_null($cle)) { |
$temps = $this->_temps[$cle]; |
$temps = self::$temps[$cle]; |
} else { |
$temps = $this->_temps; |
$temps = self::$temps; |
} |
return $temps; |
} |
51,26 → 44,34 |
* |
* @return null |
*/ |
public function setTemps($moment = array ()) { |
array_push($this->_temps, $moment); |
private static function setTemps($cle, $moment) { |
array_push(self::$temps, array($cle => $moment)); |
} |
/*** Méthodes : ***/ |
/** Méthode afficherChrono() - |
/** |
* Effectue un chronometrage. |
* |
* @param string le nom du point de chronométrage |
* @return null |
*/ |
public static function chrono($cle) { |
$moment = microtime(); |
self::verifierCreationInstance(); |
self::setTemps($cle, $moment); |
} |
/** |
* Permet d'afficher les temps d'éxécution de différentes parties d'un script. |
* |
* Cette fonction permet d'afficher un ensemble de |
* mesure de temps prises à différents endroits d'un script. |
* Ces mesures sont affichées au sein d'un tableau XHTML |
* dont on peut controler l'indentation des balises. |
* Pour un site en production, il suffit d'ajouter un style |
* #chrono {display:none;} dans la css. De cette façon, |
* le tableau ne s'affichera pas. Le webmaster lui pourra |
* rajouter sa propre feuille de style affichant le tableau. |
* Cette fonction permet d'afficher un ensemble de mesure de temps prises à différents endroits d'un script. |
* Ces mesures sont affichées au sein d'un tableau XHTML dont on peut controler l'indentation des balises. |
* Pour un site en production, il suffit d'ajouter un style #chrono {display:none;} dans la css. |
* De cette façon, le tableau ne s'affichera pas. Le webmaster lui pourra rajouter sa propre feuille de style |
* affichant le tableau. |
* Le développeur initial de cette fonction est Loic d'Anterroches. |
* Elle a été modifiée par Jean-Pascal Milcent. |
* Elle utilise une variable gobale : $_CHRONO_ |
* |
* @author Loic d'Anterroches |
* @author Jean-Pascal MILCENT <jpm@tela-botanica.org> |
79,11 → 80,10 |
* @param int $indentation le pas d'indentation. |
* @return string la chaine XHTML de mesure des temps. |
*/ |
public function afficherChrono($indentation_origine = 8, $indentation = 4) { |
public static function afficherChrono($indentation_origine = 8, $indentation = 4) { |
self::verifierCreationInstance(); |
// Création du chrono de fin |
$GLOBALS['_SCRIPT_']['chrono']->setTemps(array ( |
'fin' => microtime() |
)); |
self::setTemps('fin', microtime()); |
// Début création de l'affichage |
$sortie = str_repeat(' ', $indentation_origine) . |
105,13 → 105,13 |
$total_tps_ecoule = 0; |
// Récupération de la premiére mesure |
$tab_depart = & $this->getTemps(0); |
$tab_depart = self::getTemps(0); |
list ($usec, $sec) = explode(' ', $tab_depart['depart']); |
// Ce temps correspond à tps_fin |
$tps_debut = ((float) $usec + (float) $sec); |
foreach ($this->getTemps() as $tab_temps) { |
foreach (self::getTemps() as $tab_temps) { |
foreach ($tab_temps as $cle => $valeur) { |
list ($usec, $sec) = explode(' ', $valeur); |
$tps_fin = ((float) $usec + (float) $sec); |
148,5 → 148,14 |
return $sortie; |
} |
/** |
* Vérifie si l'instance de classe à été crée, si non la crée |
*/ |
private static function verifierCreationInstance() { |
if (empty(self::$instance)) { |
self::$instance = new Chronometre(); |
} |
} |
} |
?> |
/branches/v0.2-buhl/framework/Config.php |
---|
5,15 → 5,12 |
* Elle offre l'accès en lecture seule aux paramètres de config. |
* C'est une Singleton. |
* |
* PHP Version 5 |
* |
* @category PHP |
* @category PHP 5.2 |
* @package Framework |
* @author Jean-Pascal MILCENT <jpm@tela-botanica.org> |
* @copyright 2009 Tela-Botanica |
* @license GPL-v3 et CECILL-v2 |
* @version SVN: <svn_id> |
* @link /doc/framework/ |
* @copyright Copyright (c) 2009, Tela Botanica (accueil@tela-botanica.org) |
* @license GNU-GPL-v3 <http://www.gnu.org/licenses/gpl.html> |
* @license CECILL-v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt> |
*/ |
class Config { |
93,7 → 90,7 |
* @param string $fichier_ini nom du fichier ini à parser |
* @return array tableau contenant les paramètres du fichier ini |
*/ |
private static function parserFichierIni($fichier_ini) { |
public static function parserFichierIni($fichier_ini) { |
$retour = false; |
if (file_exists($fichier_ini)) { |
$ini = parse_ini_file($fichier_ini, true); |
/branches/v0.2-buhl/framework/Modele.php |
---|
8,15 → 8,12 |
* |
* PHP Version 5 |
* |
* @category Class |
* @category PHP 5.2 |
* @package Framework |
* @author aurelien <aurelien@tela-botanica.org> |
* @copyright 2009 Tela-Botanica |
* @license http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL |
* @license http://www.gnu.org/licenses/gpl.html Licence GNU-GPL |
* @version SVN: $$Id$$ |
* @link /doc/framework/ |
* |
* @author Aurélien PERONNET <aurelien@tela-botanica.org> |
* @copyright Copyright (c) 2009, Tela Botanica (accueil@tela-botanica.org) |
* @license GNU-GPL-v3 <http://www.gnu.org/licenses/gpl.html> |
* @license CECILL-v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt> |
*/ |
abstract class Modele { |
/branches/v0.2-buhl/framework/Debug.php |
---|
5,20 → 5,18 |
* L'affichage et l'utilisation de ces fonctions sont améliorés via cette classe. |
* Cette classe est inspirée de la classe Zend_Debug. |
* |
* PHP version 5 |
* |
* @category Debogage |
* @category PHP 5.2 |
* @package Framework |
// Auteur principal : |
* @author Jean-Pascal MILCENT <jpm@tela-botanica.org> |
// Autres auteurs : |
* @license GPL v3 <http://www.gnu.org/licenses/gpl.txt> |
* @license CECILL v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-en.txt> |
* @version $$Id$$ |
* @copyright 1999-2009 Tela Botanica (accueil@tela-botanica.org) |
* @copyright Copyright (c) 2009, Tela Botanica (accueil@tela-botanica.org) |
* @license GNU-GPL-v3 <http://www.gnu.org/licenses/gpl.html> |
* @license CECILL-v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt> |
*/ |
class Debug { |
const MODE_ECHO = 'echo'; |
const MODE_NOTICE = 'e_user_notice'; |
/** |
* mode de php (cli ou sapi) |
*/ |
42,7 → 40,7 |
* @param boolean $echo si true on affiche le résultat, si false on ne renvoie que la chaine sans l'afficher |
* @return string la chaine à afficher representant le dump ou null si echo |
*/ |
public static function dump($variable, $mot_cle = null, $echo = true) { |
public static function dump($variable, $mot_cle = null, $echo = false) { |
// var_dump de la variable dans un buffer et récupération de la sortie |
ob_start(); |
var_dump($variable); |
56,13 → 54,13 |
} |
/** |
* Equivalent de print_r |
* Equivalent de print_r. |
* @param mixed $variable la variable à afficher |
* @param string $mot_cle le mot cle à associer |
* @param boolean $echo faire un echo ou non |
* @return string la chaine contenant la variable printée ou null si echo |
*/ |
public static function printr($variable, $mot_cle = null, $echo = true) { |
public static function printr($variable, $mot_cle = null, $echo = false) { |
// Récupération de la sortie |
$sortie = print_r($variable, true); |
85,10 → 83,14 |
$sortie = self::traiterSortieSuivantMode($mot_cle, $sortie); |
// Affichage et/ou retour |
self::verifierParametresConfig(); |
if (Config::get('fw_debogage') == true) { |
if ($echo) { |
if ($echo === true || Config::get('fw_debogage_mode') == self::MODE_ECHO) { |
echo $sortie; |
return null; |
} else if (Config::get('fw_debogage_mode') == self::MODE_NOTICE) { |
trigger_error($sortie, E_USER_NOTICE); |
return null; |
} else { |
return $sortie; |
} |
119,5 → 121,23 |
} |
return $sortie; |
} |
/** |
* Vérifie que tous les paramêtres de config nécessaires au fonctionnement de cette classe existe dans les fichiers |
* de configurations. |
*/ |
private static function verifierParametresConfig() { |
$ok = true; |
$parametres = array('fw_debogage', 'fw_debogage_mode'); |
foreach ($parametres as $param) { |
if (is_null(Config::get($param))) { |
$classe = get_class(); |
$m = "L'utilisation de la classe $classe nécessite de définir '$param' dans un fichier de configuration."; |
trigger_error($m, E_USER_WARNING); |
$ok = false; |
} |
} |
return $ok; |
} |
} |
?> |
/branches/v0.2-buhl/framework/GestionnaireException.php |
---|
9,11 → 9,8 |
* @author Aurélien PERONNET <aurelien@tela-botanica.org> |
* @author Jean-Pascal MILCENT <jmp@tela-botanica.org> |
* @copyright Copyright (c) 2009, Tela Botanica (accueil@tela-botanica.org) |
* @license http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL |
* @license http://www.gnu.org/licenses/gpl.html Licence GNU-GPL |
* @version $Id$$ |
* @link /doc/framework/ |
* |
* @license GNU-GPL-v3 <http://www.gnu.org/licenses/gpl.html> |
* @license CECILL-v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt> |
*/ |
class GestionnaireException { |
53,20 → 50,7 |
self::$afficher = Config::get('fw_debogage'); |
} |
/** |
* Renvoie le nombre d'exceptions et d'erreurs levées. |
* @see getExceptions() pour obtenir les exceptions formatées. |
* @since 0.3 |
* @return int le nombre d'exception actuellement levées |
*/ |
public static function getExceptionsNbre() { |
return count(self::$exceptions); |
} |
/** |
* Renvoie le booleen définissant si l'on affiche le contexte ou non |
* @return bool true si on affiche le contexte sinon false. |
*/ |
/** Renvoie le booleen définissant si l'on affiche le contexte ou non */ |
public static function getContexte() { |
return self::$contexte; |
} |
80,17 → 64,15 |
} |
/** |
* Fonction de gestion des exceptions, remplace le handler par défaut. |
* Si une boucle génère de multiple exception (ou erreur) identique une seule sera stockée. |
* Fonction de gestion des exceptions, remplace le handler par défaut |
* @param Exception $e l'exception à traiter |
*/ |
public static function gererException(Exception $e) { |
$cle = hash('md5', $e->getMessage().'-'.$e->getFile().'-'.$e->getLine()); |
if (!isset(self::$exceptions[$cle])) { |
self::$exceptions[$cle] = $e; |
// pour le moment on se contente de l'ajouter au tableau et de les afficher |
self::$exceptions[] = $e; |
// Log si nécéssaire |
self::loggerException($e); |
} |
} |
/** |
* Gère les erreurs en les convertissant en exceptions (remplace la fonction gestion d'erreurs native de php) |
104,64 → 86,45 |
// Si un rapport d'erreur existe, création d'une exception |
if (error_reporting() != 0) { |
$e = new ErrorException($message, 0, $niveau, $fichier, $ligne); |
self::gererException($e); |
// que l'on donne au tableau d'exceptions |
self::$exceptions[] = $e; |
// Log si nécéssaire |
self::loggerException($e); |
} |
return null; |
} |
/** |
* Renvoie les exceptions au format (X)HTML ou bien au format texte suivant le mode d'utilisation de PHP. |
* @since 0.3 |
* @deprecated |
* @see getExceptionsFormatees() |
* @return string les exceptions formatées en texte ou (X)HTML. |
* Renvoie les exceptions au format (X)HTML |
* ou bien au format texte suivant le mode d'utilisation de PHP |
*/ |
public static function getExceptions() { |
return self::getExceptionsFormatees(); |
} |
/** |
* Renvoie les exceptions au format (X)HTML ou bien au format texte suivant le mode d'utilisation de PHP. |
* @since 0.3 |
* @return string les exceptions formatées en texte ou (X)HTML. |
*/ |
public static function getExceptionsFormatees() { |
$retour = ''; |
if (self::getExceptionsNbre() > 0) { |
foreach (self::$exceptions as $cle => $e) { |
switch (self::$mode) { |
case self::MODE_CLI : |
$retour .= self::formaterExceptionTxt($e); |
$retour .= $e->getMessage()."\n"; |
$retour .= 'Fichier : '.$e->getFile()."\n"; |
$retour .= 'Ligne : '.$e->getLine()."\n"; |
if (self::getContexte()) { |
$retour .= 'Contexte : '."\n".print_r($e->getTraceAsString(), true)."\n"; |
} |
break; |
default: |
$retour .= self::formaterExceptionXhtml($e); |
$retour .= '<div class="debogage">'."\n"; |
$retour .= $e->getMessage()."\n"; |
$retour .= '<span class="debogage_fichier">'.'Fichier : '.$e->getFile().'</span>'."\n"; |
$retour .= '<span class="debogage_ligne">'.'Ligne : '.$e->getLine().'</span>'."\n"; |
if (self::getContexte()) { |
$retour .= '<pre>'."\n"; |
$retour .= '<strong>Contexte : </strong>'."\n".print_r($e->getTraceAsString(), true)."\n"; |
$retour .= '</pre>'."\n"; |
} |
// Nous vidons le tableau des exceptions au fur et à mesure pour éviter le réaffichage avec le destructeur. |
unset(self::$exceptions[$cle]); |
$retour .= '</div>'."\n"; |
} |
} |
return $retour; |
} |
/** |
* Renvoie le tableau d'objets Exception générées par le script PHP triées du niveau de sévérité le plus élevé au moins élevé. |
* Format du tableau : |
* array{sévérité_1 = array{Exception1, Exception2, Exception3,...}, sévérité_1 = array{Exception1, Exception2, ...}, ...}; |
* ATTENTION : si vous utilisez cette méthode, c'est à vous de gérer l'affichage des Exceptions. Le gestionnaire d'exception |
* n'enverra plus rien au navigateur ou à la console. |
* @since 0.3 |
* @return array le tableau trié d'objet Exception. |
*/ |
public static function getExceptionsTriees() { |
$retour = array(); |
if (self::getExceptionsNbre() > 0) { |
foreach (self::$exceptions as $cle => $e) { |
$retour[$e->getSeverity()][] = $e; |
// Nous vidons le tableau des exceptions au fur et à mesure pour éviter le réaffichage avec le destructeur. |
// Nous vidons le tableau des exceptions au fur et à mesure |
unset(self::$exceptions[$cle]); |
} |
ksort($retour); |
} |
return $retour; |
} |
169,58 → 132,24 |
* Logue une exception donnée sous une forme lisible si self::logger vaut true. |
* @param Exception $e l'exception à logger |
*/ |
private static function loggerException(Exception $e) { |
private static function loggerException($e) { |
if (self::$logger) { |
$message = self::formaterExceptionTxt($e); |
Log::ajouterEntree('erreurs', $message); |
} |
} |
/** |
* Formate en texte une exception passée en paramètre. |
* @since 0.3 |
* @param Exception l'exception à formater. |
*/ |
public static function formaterExceptionTxt(Exception $e) { |
$message = ''; |
$message .= $e->getMessage()."\n"; |
$message .= 'Fichier : '.$e->getFile()."\n"; |
$message .= 'Ligne : '.$e->getLine()."\n"; |
$erreur = ''; |
$erreur .= $e->getMessage()."\n"; |
$erreur .= 'Fichier : '.$e->getFile()."\n"; |
$erreur .= 'Ligne : '.$e->getLine()."\n"; |
if (self::getContexte()) { |
$message .= 'Contexte : '."\n".print_r($e->getTraceAsString(), true)."\n"; |
$erreur .= 'Contexte : '."\n".print_r($e->getTraceAsString(), true)."\n"; |
} |
$message .= "\n"; |
return $message; |
$erreur .= "\n"; |
Log::ajouterEntree('erreurs', $erreur); |
} |
/** |
* Formate en (X)HTML une exception passée en paramètre. |
* @since 0.3 |
* @param Exception l'exception à formater. |
*/ |
public static function formaterExceptionXhtml(Exception $e) { |
$message = ''; |
$message .= '<div class="debogage">'."\n"; |
$message .= $e->getMessage()."\n"; |
$message .= '<span class="debogage_fichier">'.'Fichier : '.$e->getFile().'</span>'."\n"; |
$message .= '<span class="debogage_ligne">'.'Ligne : '.$e->getLine().'</span>'."\n"; |
if (self::getContexte()) { |
$message .= '<pre>'."\n"; |
$message .= '<strong>Contexte : </strong>'."\n".print_r($e->getTraceAsString(), true)."\n"; |
$message .= '</pre>'."\n"; |
} |
$message .= '</div>'."\n"; |
return $message; |
} |
/** |
* Lors de la destruction de la classe si des exceptions n'ont pas été affichées, et si le débogage est à true, elles sont |
* affichées. |
*/ |
public function __destruct() { |
// Si des erreurs n'ont pas été affichée nous forçons leur affichage |
if (self::$afficher && self::getExceptionsNbre() > 0) { |
echo self::getExceptionsFormatees(); |
if (self::$afficher && count(self::$exceptions) > 0) { |
echo self::getExceptions(); |
} |
} |
/branches/v0.2-buhl/framework/Controleur.php |
---|
5,16 → 5,13 |
* qui devrait être appelée de l'extérieur. |
* Elle est abstraite donc doit obligatoirement être étendue. |
* |
* @category php5 |
* @category PHP 5.2 |
* @package Framework |
* @author Aurélien PERONNET <aurelien@tela-botanica.org> |
* @author Jean-Pascal MILCENT <jpm@tela-botanica.org> |
* @copyright 2009 Tela-Botanica |
* @license http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt Licence CECILL |
* @license http://www.gnu.org/licenses/gpl.html Licence GNU-GPL |
* @version SVN: $Id$ |
* @link /doc/framework/ |
* |
* @copyright Copyright (c) 2009, Tela Botanica (accueil@tela-botanica.org) |
* @license GNU-GPL-v3 <http://www.gnu.org/licenses/gpl.html> |
* @license CECILL-v2 <http://www.cecill.info/licences/Licence_CeCILL_V2-fr.txt> |
*/ |
abstract class Controleur { |
/** Variable statique indiquant que les tableaux _GET et _POST ont déjà été encodé au format de l'appli. */ |
113,9 → 110,35 |
$_GET = $this->encoderTableau($_GET, Config::get('appli_encodage'), Config::get('sortie_encodage')); |
self::$encodage = true; |
} |
// traitement des magic quotes |
$this->verifierEtTraiterSlashTableauRequete(); |
} |
/** |
* Procédure vérifiant l'activation des magic quotes et remplace les slash dans les tableaux de requete |
*/ |
private 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); |
} |
} |
} |
/** |
* Fonction récursive transcodant toutes les valeurs d'un tableau de leur encodage d'entrée vers un encodage de sortie donné |
* @param $tableau Array Un tableau de données à encoder |
* @param $encodage_sortie String l'encodage vers lequel on doit transcoder |