blob: a4dd47f864bd9f97c314bb5672c7738c54591246 [file] [log] [blame]
Andrey Andreevc5536aa2012-11-01 17:33:58 +02001<?php
Derek Allard2067d1a2008-11-13 22:59:24 +00002/**
3 * CodeIgniter
4 *
Phil Sturgeon07c1ac82012-03-09 17:03:37 +00005 * An open source application development framework for PHP 5.2.4 or newer
Derek Allard2067d1a2008-11-13 22:59:24 +00006 *
Derek Jonesf4a4bd82011-10-20 12:18:42 -05007 * NOTICE OF LICENSE
Andrey Andreev76cc9202011-12-22 20:02:04 +02008 *
Derek Jonesf4a4bd82011-10-20 12:18:42 -05009 * Licensed under the Open Software License version 3.0
Andrey Andreev76cc9202011-12-22 20:02:04 +020010 *
Derek Jonesf4a4bd82011-10-20 12:18:42 -050011 * This source file is subject to the Open Software License (OSL 3.0) that is
12 * bundled with this package in the files license.txt / license.rst. It is
13 * also available through the world wide web at this URL:
14 * http://opensource.org/licenses/OSL-3.0
15 * If you did not receive a copy of the license and are unable to obtain it
16 * through the world wide web, please send an email to
17 * licensing@ellislab.com so we can send you a copy immediately.
18 *
Derek Allard2067d1a2008-11-13 22:59:24 +000019 * @package CodeIgniter
Derek Jonesf4a4bd82011-10-20 12:18:42 -050020 * @author EllisLab Dev Team
Greg Aker0defe5d2012-01-01 18:46:41 -060021 * @copyright Copyright (c) 2008 - 2012, EllisLab, Inc. (http://ellislab.com/)
Derek Jonesf4a4bd82011-10-20 12:18:42 -050022 * @license http://opensource.org/licenses/OSL-3.0 Open Software License (OSL 3.0)
Derek Allard2067d1a2008-11-13 22:59:24 +000023 * @link http://codeigniter.com
24 * @since Version 1.0
25 * @filesource
26 */
Andrey Andreevc5536aa2012-11-01 17:33:58 +020027defined('BASEPATH') OR exit('No direct script access allowed');
Derek Allard2067d1a2008-11-13 22:59:24 +000028
Derek Allard2067d1a2008-11-13 22:59:24 +000029/**
30 * Logging Class
31 *
32 * @package CodeIgniter
33 * @subpackage Libraries
34 * @category Logging
Derek Jonesf4a4bd82011-10-20 12:18:42 -050035 * @author EllisLab Dev Team
Derek Allard2067d1a2008-11-13 22:59:24 +000036 * @link http://codeigniter.com/user_guide/general/errors.html
37 */
38class CI_Log {
39
Timothy Warrenb82bc3a2012-04-27 09:12:58 -040040 /**
41 * Path to save log files
42 *
43 * @var string
44 */
Greg Aker2eaa4072010-12-21 11:44:08 -060045 protected $_log_path;
Andrey Andreev56454792012-05-17 14:32:19 +030046
Timothy Warrenb82bc3a2012-04-27 09:12:58 -040047 /**
48 * Level of logging
49 *
50 * @var int
51 */
Nithin333f9f92011-08-21 16:52:06 -040052 protected $_threshold = 1;
Andrey Andreev56454792012-05-17 14:32:19 +030053
Timothy Warrenb82bc3a2012-04-27 09:12:58 -040054 /**
55 * Highest level of logging
56 *
57 * @var int
58 */
Nithin333f9f92011-08-21 16:52:06 -040059 protected $_threshold_max = 0;
Andrey Andreev56454792012-05-17 14:32:19 +030060
Timothy Warrenb82bc3a2012-04-27 09:12:58 -040061 /**
62 * Array of threshold levels to log
63 *
64 * @var array
65 */
Nithin333f9f92011-08-21 16:52:06 -040066 protected $_threshold_array = array();
Andrey Andreev56454792012-05-17 14:32:19 +030067
Timothy Warrenb82bc3a2012-04-27 09:12:58 -040068 /**
69 * Format of timestamp for log files
70 *
71 * @var string
72 */
Nithin333f9f92011-08-21 16:52:06 -040073 protected $_date_fmt = 'Y-m-d H:i:s';
Andrey Andreev56454792012-05-17 14:32:19 +030074
Timothy Warrenb82bc3a2012-04-27 09:12:58 -040075 /**
76 * Whether or not the logger can write to the log files
77 *
78 * @var bool
79 */
Andrey Andreev443bbd92012-04-03 15:49:11 +030080 protected $_enabled = TRUE;
Andrey Andreev56454792012-05-17 14:32:19 +030081
Timothy Warrenb82bc3a2012-04-27 09:12:58 -040082 /**
83 * Predefined logging levels
84 *
85 * @var array
86 */
Andrey Andreev443bbd92012-04-03 15:49:11 +030087 protected $_levels = array('ERROR' => 1, 'DEBUG' => 2, 'INFO' => 3, 'ALL' => 4);
Derek Allard2067d1a2008-11-13 22:59:24 +000088
Timothy Warrenb82bc3a2012-04-27 09:12:58 -040089 /**
90 * Initialize Logging class
91 *
Andrey Andreev56454792012-05-17 14:32:19 +030092 * @return void
Timothy Warrenb82bc3a2012-04-27 09:12:58 -040093 */
Greg Akera9263282010-11-10 15:26:43 -060094 public function __construct()
Derek Allard2067d1a2008-11-13 22:59:24 +000095 {
96 $config =& get_config();
Barry Mienydd671972010-10-04 16:33:58 +020097
Alex Bilbied261b1e2012-06-02 11:12:16 +010098 $this->_log_path = ($config['log_path'] !== '') ? $config['log_path'] : APPPATH.'logs/';
Barry Mienydd671972010-10-04 16:33:58 +020099
Greg Aker2eaa4072010-12-21 11:44:08 -0600100 if ( ! is_dir($this->_log_path) OR ! is_really_writable($this->_log_path))
Derek Allard2067d1a2008-11-13 22:59:24 +0000101 {
102 $this->_enabled = FALSE;
103 }
Barry Mienydd671972010-10-04 16:33:58 +0200104
Derek Allard2067d1a2008-11-13 22:59:24 +0000105 if (is_numeric($config['log_threshold']))
106 {
Andrey Andreev76cc9202011-12-22 20:02:04 +0200107 $this->_threshold = (int) $config['log_threshold'];
Derek Allard2067d1a2008-11-13 22:59:24 +0000108 }
Nithin333f9f92011-08-21 16:52:06 -0400109 elseif (is_array($config['log_threshold']))
110 {
111 $this->_threshold = $this->_threshold_max;
112 $this->_threshold_array = array_flip($config['log_threshold']);
113 }
Barry Mienydd671972010-10-04 16:33:58 +0200114
Alex Bilbied261b1e2012-06-02 11:12:16 +0100115 if ($config['log_date_format'] !== '')
Derek Allard2067d1a2008-11-13 22:59:24 +0000116 {
117 $this->_date_fmt = $config['log_date_format'];
118 }
119 }
Barry Mienydd671972010-10-04 16:33:58 +0200120
Derek Allard2067d1a2008-11-13 22:59:24 +0000121 // --------------------------------------------------------------------
Barry Mienydd671972010-10-04 16:33:58 +0200122
Derek Allard2067d1a2008-11-13 22:59:24 +0000123 /**
124 * Write Log File
125 *
126 * Generally this function will be called using the global log_message() function
127 *
Derek Allard2067d1a2008-11-13 22:59:24 +0000128 * @param string the error level
129 * @param string the error message
130 * @param bool whether the error is a native PHP error
131 * @return bool
Barry Mienydd671972010-10-04 16:33:58 +0200132 */
Greg Aker2eaa4072010-12-21 11:44:08 -0600133 public function write_log($level = 'error', $msg, $php_error = FALSE)
Barry Mienydd671972010-10-04 16:33:58 +0200134 {
Derek Allard2067d1a2008-11-13 22:59:24 +0000135 if ($this->_enabled === FALSE)
136 {
137 return FALSE;
138 }
Barry Mienydd671972010-10-04 16:33:58 +0200139
Derek Allard2067d1a2008-11-13 22:59:24 +0000140 $level = strtoupper($level);
Barry Mienydd671972010-10-04 16:33:58 +0200141
Andrey Andreev76cc9202011-12-22 20:02:04 +0200142 if (( ! isset($this->_levels[$level]) OR ($this->_levels[$level] > $this->_threshold))
Andrey Andreev443bbd92012-04-03 15:49:11 +0300143 && ! isset($this->_threshold_array[$this->_levels[$level]]))
Derek Allard2067d1a2008-11-13 22:59:24 +0000144 {
Andrey Andreev76cc9202011-12-22 20:02:04 +0200145 return FALSE;
Derek Allard2067d1a2008-11-13 22:59:24 +0000146 }
Barry Mienydd671972010-10-04 16:33:58 +0200147
Nithin333f9f92011-08-21 16:52:06 -0400148
Greg Aker3a746652011-04-19 10:59:47 -0500149 $filepath = $this->_log_path.'log-'.date('Y-m-d').'.php';
Derek Jones4b9c6292011-07-01 17:40:48 -0500150 $message = '';
Barry Mienydd671972010-10-04 16:33:58 +0200151
Derek Allard2067d1a2008-11-13 22:59:24 +0000152 if ( ! file_exists($filepath))
153 {
Jeroen van der Gulik2835e082011-12-04 14:19:38 +0100154 $newfile = TRUE;
Andrey Andreevc5536aa2012-11-01 17:33:58 +0200155 $message .= '<'."?php if defined('BASEPATH') OR exit('No direct script access allowed'); ?".">\n\n";
Derek Allard2067d1a2008-11-13 22:59:24 +0000156 }
Barry Mienydd671972010-10-04 16:33:58 +0200157
Derek Allard2067d1a2008-11-13 22:59:24 +0000158 if ( ! $fp = @fopen($filepath, FOPEN_WRITE_CREATE))
159 {
160 return FALSE;
161 }
162
Andrey Andreev56454792012-05-17 14:32:19 +0300163 $message .= $level.' '.($level === 'INFO' ? ' -' : '-').' '.date($this->_date_fmt).' --> '.$msg."\n";
Barry Mienydd671972010-10-04 16:33:58 +0200164
165 flock($fp, LOCK_EX);
Derek Allard2067d1a2008-11-13 22:59:24 +0000166 fwrite($fp, $message);
167 flock($fp, LOCK_UN);
168 fclose($fp);
Barry Mienydd671972010-10-04 16:33:58 +0200169
Andrey Andreev443bbd92012-04-03 15:49:11 +0300170 if (isset($newfile) && $newfile === TRUE)
Jeroen van der Gulik2835e082011-12-04 14:19:38 +0100171 {
172 @chmod($filepath, FILE_WRITE_MODE);
173 }
Andrey Andreev443bbd92012-04-03 15:49:11 +0300174
Derek Allard2067d1a2008-11-13 22:59:24 +0000175 return TRUE;
176 }
177
178}
Derek Allard2067d1a2008-11-13 22:59:24 +0000179
180/* End of file Log.php */
Andrey Andreev443bbd92012-04-03 15:49:11 +0300181/* Location: ./system/libraries/Log.php */