b873a91ca87c62d1c613b3ad0444637acadfa37d
[core.git] / inc / classes / main / debug / class_DebugErrorLogOutput.php
1 <?php
2 /**
3  * A debug output class for PHP's error_log() command
4  *
5  * @author              Roland Haeder <webmaster@ship-simu.org>
6  * @version             0.0.0
7  * @copyright   Copyright (c) 2007 - 2009 Roland Haeder, this is free software
8  * @license             GNU GPL 3.0 or any newer version
9  * @link                http://www.ship-simu.org
10  *
11  * This program is free software: you can redistribute it and/or modify
12  * it under the terms of the GNU General Public License as published by
13  * the Free Software Foundation, either version 3 of the License, or
14  * (at your option) any later version.
15  *
16  * This program is distributed in the hope that it will be useful,
17  * but WITHOUT ANY WARRANTY; without even the implied warranty of
18  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
19  * GNU General Public License for more details.
20  *
21  * You should have received a copy of the GNU General Public License
22  * along with this program. If not, see <http://www.gnu.org/licenses/>.
23  */
24 class DebugErrorLogOutput extends BaseFrameworkSystem implements Debugger, OutputStreamer {
25         /**
26          * Protected constructor
27          *
28          * @return      void
29          */
30         protected function __construct () {
31                 // Call parent constructor
32                 parent::__construct(__CLASS__);
33         }
34
35         /**
36          * Creates an instance of this class
37          *
38          * @return      $debugInstance  The prepared debug instance
39          */
40         public final static function createDebugErrorLogOutput () {
41                 // Get a new instance
42                 $debugInstance = new DebugErrorLogOutput();
43
44                 // Return it
45                 return $debugInstance;
46         }
47
48         /**
49          * Outputs the given data without HTML tags
50          *
51          * @param       $output         The HTML'ed output
52          * @return      void
53          */
54         public final function outputStream ($output) {
55                 // Split multiple lines into and array to put them out line-by-line
56                 $errorLines = explode("\n", $output);
57                 foreach ($errorLines as $err) {
58                         $err = trim($err);
59                         // Log only none-empty lines
60                         if (!empty($err)) {
61                                 // Log this line
62                                 error_log(html_entity_decode(strip_tags($err)), 0);
63                         }
64                 }
65         }
66
67         /**
68          * Assigns a variable for output
69          *
70          * @param       $var    The variable we shall assign
71          * @param       $value  The value to store in the variable
72          * @return      void
73          */
74         public final function assignVariable ($var, $value) {
75                 // Empty stub!
76                 trigger_error(__METHOD__.": Stub!");
77         }
78
79         /**
80          * Output the code
81          *
82          * @return      void
83          */
84         public final function output ($outStream = false) {
85                 // Empty output will be silently ignored
86                 if ($outStream !== false) {
87                         $this->outputStream($outStream);
88                 }
89         }
90 }
91
92 // [EOF]
93 ?>