Subversion Repositories Applications.framework

<?php
// declare(encoding='UTF-8');
/**
* Classe fournissant des fonctions de débogage équivalante à var_dump et print_r.
* 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.
*
* @package Framework
* @category Debogage
// 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)
*/
class Debug {

        protected static $mode = null;

        public static function getMode() {
                if (self::$mode === null) {
                        self::$mode = PHP_SAPI;
                }
                return self::$mode;
        }

        public static function dump($variable, $mot_cle = null, $echo = true) {
                // var_dump de la variable dans un buffer et récupération de la sortie
                ob_start();
                var_dump($variable);
                $sortie = ob_get_clean();

                // Pré-traitement de la sortie
                $sortie = preg_replace("/\]\=\>\n(\s+)/m", "] => ", $sortie);

                // Traitement général du débogage
                return self::traiterDebogage($mot_cle, $sortie, $echo);
        }

        public static function printr($variable, $mot_cle = null, $echo = true) {
                // Récupération de la sortie
                $sortie = print_r($variable, true);

                // Traitement général du débogage
                return self::traiterDebogage($mot_cle, $sortie, $echo);
        }

        private static function traiterDebogage($mot_cle, $sortie, $echo) {
                // Formate le mot-clé
                $mot_cle = self::formaterMotCle($mot_cle);

                // Traitement de la sortie
                $sortie = self::traiterSortieSuivantMode($mot_cle, $sortie);

                // Affichage et/ou retour
                if ($echo) {
                        echo $sortie;
                        return null;
                } else {
                        return $sortie;
                }
        }

        private static function formaterMotCle($mot_cle) {
                return ($mot_cle === null) ? '' : rtrim($mot_cle).' ';
        }

        private static function traiterSortieSuivantMode($mot_cle, $sortie) {
                $corps = $mot_cle.PHP_EOL.$sortie;
                if (self::getMode() == 'cli') {
                        $sortie = PHP_EOL.$corps.PHP_EOL;
                } else {
                        $sortie = '<pre>'.$corps.'</pre>';
                }
                return $sortie;
        }
}
?>