2 if(!defined('sugarEntry') || !sugarEntry) die('Not A Valid Entry Point');
3 /*********************************************************************************
4 * SugarCRM Community Edition is a customer relationship management program developed by
5 * SugarCRM, Inc. Copyright (C) 2004-2012 SugarCRM Inc.
7 * This program is free software; you can redistribute it and/or modify it under
8 * the terms of the GNU Affero General Public License version 3 as published by the
9 * Free Software Foundation with the addition of the following permission added
10 * to Section 15 as permitted in Section 7(a): FOR ANY PART OF THE COVERED WORK
11 * IN WHICH THE COPYRIGHT IS OWNED BY SUGARCRM, SUGARCRM DISCLAIMS THE WARRANTY
12 * OF NON INFRINGEMENT OF THIRD PARTY RIGHTS.
14 * This program is distributed in the hope that it will be useful, but WITHOUT
15 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
16 * FOR A PARTICULAR PURPOSE. See the GNU Affero General Public License for more
19 * You should have received a copy of the GNU Affero General Public License along with
20 * this program; if not, see http://www.gnu.org/licenses or write to the Free
21 * Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
24 * You can contact SugarCRM, Inc. headquarters at 10050 North Wolfe Road,
25 * SW2-130, Cupertino, CA 95014, USA. or at email address contact@sugarcrm.com.
27 * The interactive user interfaces in modified source and object code versions
28 * of this program must display Appropriate Legal Notices, as required under
29 * Section 5 of the GNU Affero General Public License version 3.
31 * In accordance with Section 7(b) of the GNU Affero General Public License version 3,
32 * these Appropriate Legal Notices must retain the display of the "Powered by
33 * SugarCRM" logo. If the display of the logo is not reasonably feasible for
34 * technical reasons, the Appropriate Legal Notices must display the words
35 * "Powered by SugarCRM".
36 ********************************************************************************/
44 //this the the current log level
45 private $_level = 'fatal';
47 //this is a list of different loggers that have been loaded
48 private static $_loggers = array();
50 //this is the instance of the LoggerManager
51 private static $_instance = NULL;
53 //these are the mappings for levels to different log types
54 private static $_logMapping = array(
55 'default' => 'SugarLogger',
58 //these are the log level mappings anything with a lower value than your current log level will be logged
59 private static $_levelMapping = array(
70 //only let the getLogger instantiate this object
71 private function __construct()
73 $level = SugarConfig::getInstance()->get('logger.level', $this->_level);
75 $this->setLevel($level);
77 if ( empty(self::$_loggers) )
78 $this->_findAvailableLoggers();
82 * Overloaded method that handles the logging requests.
84 * @param string $method
85 * @param string $message - also handles array as parameter, though that is deprecated.
87 public function __call(
92 if ( !isset(self::$_levelMapping[$method]) )
93 $method = $this->_level;
94 //if the method is a direct match to our level let's let it through this allows for custom levels
95 if($method == $this->_level
96 //otherwise if we have a level mapping for the method and that level is less than or equal to the current level let's let it log
97 || (!empty(self::$_levelMapping[$method])
98 && self::$_levelMapping[$this->_level] >= self::$_levelMapping[$method]) ) {
99 //now we get the logger type this allows for having a file logger an email logger, a firebug logger or any other logger you wish you can set different levels to log differently
100 $logger = (!empty(self::$_logMapping[$method])) ?
101 self::$_logMapping[$method] : self::$_logMapping['default'];
102 //if we haven't instantiated that logger let's instantiate
103 if (!isset(self::$_loggers[$logger])) {
104 self::$_loggers[$logger] = new $logger();
106 //tell the logger to log the message
107 self::$_loggers[$logger]->log($method, $message);
112 * Used for doing design-by-contract assertions in the code; when the condition fails we'll write
113 * the message to the debug log
115 * @param string $message
116 * @param boolean $condition
118 public function assert(
124 $this->__call('debug', $message);
128 * Sets the logger to the level indicated
130 * @param string $name name of logger level to set it to
132 public function setLevel(
136 if ( isset(self::$_levelMapping[$name]) )
137 $this->_level = $name;
141 * Returns a logger instance
143 public static function getLogger()
145 if(!LoggerManager::$_instance){
146 LoggerManager::$_instance = new LoggerManager();
148 return LoggerManager::$_instance;
152 * Sets the logger to use a particular backend logger for the given level. Set level to 'default'
153 * to make it the default logger for the application
155 * @param string $level name of logger level to set it to
156 * @param string $logger name of logger class to use
158 public static function setLogger(
163 self::$_logMapping[$level] = $logger;
167 * Finds all the available loggers in the application
169 protected function _findAvailableLoggers()
171 $locations = array('include/SugarLogger','custom/include/SugarLogger');
172 foreach ( $locations as $location ) {
173 if (sugar_is_dir($location) && $dir = opendir($location)) {
174 while (($file = readdir($dir)) !== false) {
177 || $file == "LoggerTemplate.php"
178 || $file == "LoggerManager.php"
179 || !is_file("$location/$file")
182 require_once("$location/$file");
183 $loggerClass = basename($file, ".php");
184 if ( class_exists($loggerClass) && class_implements($loggerClass,'LoggerTemplate') )
185 self::$_loggers[$loggerClass] = new $loggerClass();
191 public static function getAvailableLoggers()
193 return array_keys(self::$_loggers);
196 public static function getLoggerLevels()
198 $loggerLevels = self::$_levelMapping;
199 foreach ( $loggerLevels as $key => $value )
200 $loggerLevels[$key] = ucfirst($key);
202 return $loggerLevels;