How do you debug plugins?

Question

I am pretty new to plugin authoring and was having a hard time debuging.

I used lots of echo and it is sloppy and ugly.

I am sure there is a better way to do this, maybe an IDE with a debugger that I can run the entire site in including the plugin?

Answer 1

Go into wp-config.php and change define('WP_DEBUG', false); to define('WP_DEBUG', true);. Also, install Andrew Nacin's Log Deprecated Notices plugin.

Answer 2

If you're getting errors printed, then x-debug is a brilliant PHP extension that adds modern backtraces to PHP.

If you're trying to work out what's going on where there are no errors, my favourite approach is to define a function which logs its output to a file. So I do plog($variable) and that appears in the log file which I can then examine. This is especially useful when you're trying to work out what happened before header() is called, or other situations where you can't print to STDOUT.

Answer 3

Use xdebug + NetBeans IDE. When fully configured - which is easy to do - you can set break points in your plugin and watch variables at the break points. I think it is the best way to debug plugins or any php applications for that matter.

Answer 4

I debug the old fashioned way, error_log()ing and var_dumping. I find that is the most efficient way for me, I have a couple of wrapper functions to handle different types of data, as error_loging arrays and objects can be a pain. Also, using print_r() in can be tricky to read when it is not in a <pre>. I have tj_log() for error logging, and tj() for showing output (which basically shows any data type in a presentable mannor:

function tj( $code ) {

    ?>
    <style>
        .tj_debug { word-wrap: break-word; white-space: pre; text-align: left; position: relative; background-color: rgba(0, 0, 0, 0.8); font-size: 11px; color: #a1a1a1; margin: 10px; padding: 10px; margin: 0 auto; width: 80%; overflow: auto; -moz-box-shadow:0 10px 40px rgba(0, 0, 0, 0.75); -webkit-box-shadow:0 10px 40px rgba(0, 0, 0, 0.75); -moz-border-radius: 5px; -webkit-border-radius: 5px; text-shadow: none; }
    </style>
    <br /><pre class="tj_debug">

    <?php
    if ( is_null( $code ) || is_string($code) || is_int( $code ) || is_bool($code) || is_float( $code ) ) :
        var_dump( $code );

    else :
        print_r( $code );

    endif;

    echo '</pre><br />';

}

function tj_log( $code ) {

    if ( is_null( $code ) || is_string($code) || is_int( $code ) || is_bool($code) || is_float( $code ) ) :
        $code = var_export( $code, true );

    else :
        $code = print_r( $code, true );

    endif;

    error_log( $code );

}

So then I just do: tj( $current_user ); or whatever.

Answer 5

After tinkering with a number of IDE's, I settled into plain old Notepad++ with an ultra-customized Syntax Highlighting color scheme.

I have a macro set up such that when I hit Shift-Ctrl-X , the following code gets output where my cursor is:

echo "<pre>";
var_dump($);
echo "</pre>";
exit();

It's simple, but I can generally hunt down 90% of my bugs with this macro plus WP_DEBUG enabled.

Answer 6

I wrote a little class for make a logfile, is very useful when you are debugging ajax calls.

http://github.com/hunk/Magic-Fields/blob/master/tools/debug.php

You only needs do something like:

Debug::log("This is a debug message");

When that line is executed a the message will be added in the log file and after that you can use the tail command (if you are using some unix's style operative system)

tail -f mylogfile.log

If you can pass to this function a array or a object as well.

note you needs change the line 20 for a path where you want save your log file

Answer 7

I use Aptane IDE on Linux and UltraEdit on Windows, and this one also has a PHP-parser. Also, I view all hints from xDebug with the constant WP_DEBUG defined in wp-config.php.

See also my post on this topic and feel free to comment and give feedback about your development tools.

Answer 8

I recommend checking out FirePHP. You can send debug info to Firefox's Firebug over HTTP headers, which usually makes for cleaner debug output.

Answer 9

Not that bad too: Eclipse It's close to PhpStorm + free.

Answer 10

Krumo - the styled php debug class

Another really nice thing is the "krumo" php class. It's implemented in ½ min and offers an easy way to debug all sort of variables:

• objects,
• arrays,
• strings/float/integer/etc.

Plus it helps with backtracing, shows loaded classes or included files and everything on demand.

Plus it's FREE!

^{Screenshot shows the javascript driven folding}

Download

Krumo @sourceforge

Answer 11

There are two IDEs I can recommend and I've used both extensively: PhpED (Windows only) and PhpStorm+XDEBUG (Mac, Windows and Linux.) I'm on Mac now so can only use the latter.

Both of them ROCK! The good news that PhpStorm is $49 before September 2010 and only $99 after that. If I was on Windows and had to choose again, not sure which I would choose.

Frankly I can't help but feel that any plugin developer not using one of these two tools is severely handicapped, especially if they are relatively new to developing WordPress plugins.

Answer 12

I use a $13 plugin called LogPress you can buy on ThemeForest and it is an absolute God-send. You can debug everything relating to their plugins and site. Supports Firebug console logging and a whole lot more. I can't live without it, that is how much I use this plugin.

This plugin is probably the best money I have ever spent and it has saved countless hours in my Wordpress plugin development.

Answer 13

I'm using phpED and xdebug but for me (and seems for somebody else) it's impossible to debug the plugins or theme's file! The debugger only stops on the breakpoints that are in the main or original "core" files! anybody can help me?