Difference between revisions of "Configuring Xdebug for PHP development/Windows"

From Joomla! Documentation

< Configuring Xdebug for PHP development
Line 16: Line 16:
 
You enable the plugin by adding (or uncommenting) the following line to your config-file:
 
You enable the plugin by adding (or uncommenting) the following line to your config-file:
 
<source lang="ini">
 
<source lang="ini">
 +
; Example for XAMPP
 
zend_extension = "\xampp\php\ext\php_xdebug.dll"
 
zend_extension = "\xampp\php\ext\php_xdebug.dll"
 +
 +
; Example on Linux Debian
 +
zend_extension=/usr/lib/php5/20090626/xdebug.so
 
</source>
 
</source>
  

Revision as of 06:52, 28 June 2012

Configuring Xdebug is spitted into two parts:

Serverside (extension in PHP)[edit]

Installation[edit]

First check if this extension is already installed. Create a new file with the content <?php phpinfo(); ?>, save it in your webfolder (f.e. C:\xampp\htdocs\phpinfo.php) and call it using your browser (f.e. http://localhost/phpinfo.php). The command PHPINFO will show you all information about installed plugins, their configuration and so on. If you see a headline called Xdebug, it is already downloaded and enabled.

On a linux-system it depends on your distribution. Most of the distribution have packages ready that you can just download and install right-away. An example is Debian (or Ubunut). The package there is called php5-xdebug. This command will download and enable the plugin.

To get the extension for a Windows-System, you have to download the DLL-file from http://xdebug.org/download.php that fit's to your PHP version, move it into the ext folder of your PHP-installation. If the file php_xdebug.dll exists, leave it there. It's most likely the right version, just that it's not enabled. This was f.e. the case for the last XAMPP package I used.

Enable Xdebug[edit]

On windows-systems you most likely just have one php.ini file for all configuration whereas on several Linux distributions you have a directory called conf.d in addition. If you have installed Xdebug on a Linux based system, you'll probably find a file xdebug.ini in there. Use this file instead if you have it (just not to mess-up the main config-file).

You enable the plugin by adding (or uncommenting) the following line to your config-file:

; Example for XAMPP
zend_extension = "\xampp\php\ext\php_xdebug.dll"

; Example on Linux Debian
zend_extension=/usr/lib/php5/20090626/xdebug.so

Please make sure you use zend_extension instead of extension which (not as extension) requires the full path to the extension-file.

Configuration[edit]

Please also read this introduction for configuration-details: http://xdebug.org/docs/remote

Here is an example of the configuration I use and some comments around that:

; location of my configuration-file
zend_extension=/usr/lib/php5/20090626/xdebug.so

; Enables colors if you use xdebug on the console
xdebug.cli_color=1

; Enable profiler by a trigger (f.e. cookie or GET-param)
xdebug.profiler_enable_trigger=1
xdebug.profiler_output_dir=/var/www/log/

; Debugger will try to connect back to the machine sending the HTTP-Request
xdebug.remote_connect_back=1

; Enables the debugger
xdebug.remote_enable=1

Clientside (configure your IDE)[edit]

If your IDE is not listed on http://xdebug.org/docs/remote#clients, you'll probably find a tutorial in the manual of your IDE. Feel free to add helpful tutorials here.