Logger.php

Go to the documentation of this file.

<?php

class Elgg_Logger {

    const OFF = 0;
    const ERROR = 400;
    const WARNING = 300;
    const NOTICE = 250;
    const INFO = 200;

    protected static $levels = array(
        0 => 'OFF',
        200 => 'INFO',
        250 => 'NOTICE',
        300 => 'WARNING',
        400 => 'ERROR',
    );

    protected $level = self::ERROR;

    protected $display = false;

    protected $hooks;

    public function __construct(Elgg_PluginHooksService $hooks) {
        $this->hooks = $hooks;
    }

    public function setLevel($level) {
        // @todo Elgg has used string constants for logging levels
        if (is_string($level)) {
            $levelStringsToInts = array_flip(self::$levels);
            $level = $levelStringsToInts[$level];
        }
        $this->level = $level;
    }

    public function getLevel() {
        return $this->level;
    }

    public function setDisplay($display) {
        $this->display = $display;
    }

    public function log($message, $level = self::NOTICE) {
        if ($this->level == self::OFF || $level < $this->level) {
            return false;
        }

        if (!array_key_exists($level, self::$levels)) {
            return false;
        }

        $levelString = self::$levels[$level];

        // notices and below never displayed to user
        $display = $this->display && $level > self::NOTICE;

        $this->process("$levelString: $message", $display, $level);

        return true;
    }

    public function error($message) {
        return $this->log($message, self::ERROR);
    }

    public function warn($message) {
        return $this->log($message, self::WARNING);
    }

    public function notice($message) {
        return $this->log($message, self::NOTICE);
    }

    public function info($message) {
        return $this->log($message, self::INFO);
    }

    public function dump($data, $display = true) {
        $this->process($data, $display, self::ERROR);
    }

    protected function process($data, $display, $level) {
        global $CONFIG;

        // plugin can return false to stop the default logging method
        $params = array(
            'level' => $level,
            'msg' => $data,
            'display' => $display,
            'to_screen' => $display,
        );

        if (!$this->hooks->trigger('debug', 'log', $params, true)) {
            return;
        }

        // Do not want to write to screen before page creation has started.
        // This is not fool-proof but probably fixes 95% of the cases when logging
        // results in data sent to the browser before the page is begun.
        if (!isset($CONFIG->pagesetupdone)) {
            $display = false;
        }

        // Do not want to write to JS or CSS pages
        if (elgg_in_context('js') || elgg_in_context('css')) {
            $display = false;
        }

        if ($display == true) {
            echo '<pre class="elgg-logger-data">';
            echo htmlspecialchars(print_r($data, true), ENT_QUOTES, 'UTF-8');
            echo '</pre>';
        } else {
            error_log(print_r($data, true));
        }
    }
}