#native_company# #native_desc#

Debugger with verbose levels

By Mulder
on April 20, 2002

Version: 0.1

Type: Class

Category: Other

License: GNU General Public License

Description: Allows you to put debug messages in your code and mark them with a specific debug level. Later, when you want to output your debug messages, you can squelch out the messages with levels you don’t want to see.

This is different than other debug classes because it is not stepping through your code like a real debugger. It is only going to print the messages that you make up and that you have planted in your code. But some times you don’t want to see all your debug messages, just the serious ones. Sometimes you want to see a lot more.

   debugger.php -- debugging messages with varying verbosity
         debug->add_message($message, $loglevel, __LINE__, __FILE__);

When you put debug messages in your code, you should mark them as level 0 if
they are very important. If they are only notices or not very important, mark them with
a higher number. 

The debug report($threshhold) function will show you all debug messages 
that are marked with a number less than the $threshhold you ask for.


class debug {

        // define properties
        var $classname = "debug";
        var $debug_messages = array();

Define the methods

   1st method is the constructor, which has the same name
   as the class and is called on every instantiation of the class
        function debug () {
        // public: Constructor
        // this doesn't do anything else
        function report($threshold = 0) {
                public: report ($threshold)
                $threshold: show all debug messages logged with this threshold or less

        $debugmsgs = $this->debug_messages; // easier to type
        $ret = "";
        /* The data structure looks like this:
           $debugmsgs = array(
                              array(5, "a warning"),
                              array(1, "an error"),
                              array(10, "just a notice")
        $j = 0;
        for($i=0; $i<sizeof($debugmsgs); $i++) {
             if($threshold >=  $debugmsgs[$i][0]) {
                  $ret .= "<li>". $debugmsgs[$i][1] ."<br>n";
             } // end loop thru debug message pile
        echo "Total Debug Calls: $i <br>n".
             "Total Debug Calls at LogLevel-$threshold or below<b>:</b> $j <br><hr>n".  $ret;
        } // end function report()

        function add_message($msg = "", $loglevel = 0, $line = "", $file = "") {
                public: add_message ($msg, $loglevel, $line, $file)
                $msg: debug message 
                $loglevel: mark the message as this integer level of log. for use with reporting thresholds
                           if you only want a message to be reported when you ask for maximum verbosity, set the
                           loglevel higher. If you want it to report your message when it's not being so verbose 
                           make the loglevel lower.
                $line: optional line number (use __LINE__)
                $file: optional executing file name (use __FILE__)

                $l = ($line != "" ? "on line <b>$line</b>: " : "");
                $f = ($file != "" ? "<b>$file</b>, " : "");
                $this->debug_messages[] = array($loglevel, "$f $l $msg");
        } // report

} // debug.php
Example: http://superprivate.com/dtest.php

$num = intval($num);

$dbg = new debug ();

$dbg->add_message("0 could be a panic debug message - for something fatal", 0, __LINE__, "/bla/". basename(__FILE__));
$dbg->add_message("2 could be a debug message for something important", 2, __LINE__, "/bla/". basename(__FILE__));
$dbg->add_message("4 could be debug message for something like a warning", 4, __LINE__, "/bla/". basename(__FILE__));
$dbg->add_message("debug level 4 message without line number or filename", 4);
$dbg->add_message("6 could be a warning or mere notice", 6, __LINE__, "/bla/". basename(__FILE__));
$dbg->add_message("8 could be a message you may not always care to hear", 8, __LINE__, "/bla/". basename(__FILE__));
$dbg->add_message("10 could be a message you want to keep quiet most of the time", 10, __LINE__, "/bla/". basename(__FILE__));
$dbg->add_message("debug level 10 message without the filename", 10, __LINE__);