Gedit plugin: DBGp Debugging Client
This plugin allows you to use gedit-3 as a debugging-client using the DBGp protocol (e.g.: XDebug).
- Using DBGp-proxies
- Multiple profiles
- Path mapping
- Breakpoints (conditional)
- Inspecting and manipulating variables
- Stepping through your code
This plugin is licenced under the GNU General Public Licence version 3. If you do not know what that means, see the file 'LICENCE'.
- notify-osd (will be optional in a future release, but not yet)
I have successfully tested this plugin under the following setups:
- Ubuntu 14.04 / Gedit 3.10
- Ubuntu 14.04 / Gedit 3.12
- Fedora 23 / Gedit 3.18
Clone the git-repository
Execute the following command:
git clone https://github.com/addiks/gedit-dbgp-plugin.git
Download the zip-archive
Extract the zip-archive anywhere you want.
- Move, copy or link the folder you downloaded to ~/.local/share/gedit/plugins/addiks-dbgp
- Restart gedit if it is running.
- In the menu, go to: Edit > Settings > Plugins
- Make sure the checkbox next to "Addiks - DBGp client (XDebug)" is active.
First thing you should do is to set up the profiles.
- Open in the menu: Debugging > Manage profiles
- For every 'target' to debug: 1. If the target is using a debugging-proxy, activate the checkbox "connect to DBGp" and enter the hostname (or IP) and port (usually 9001). 2. If the target is not on your computer, click on "Configure path mapping" and set up the absolute path's to map from remote (target) to local (in your workspace) 3. (Optional) Enter the URL of the WWW-system to debug (if any). 4. Enter the port to listen for connections (usually 9000) 5. Define an IDE-Key for the profile. The IDE-Key must be unique among all profiles and all other IDE's using the same proxy.
First click on the menu in: Debugging > Start listening for debugging sessions This will open all ports from all profiles and register with all DBGp-proxies.
Also, this will add a new gutter on every open gedit-window. (a gutter is some sidebar-thingy like the one containing the line-numbers) Click on the gutter where you want to add breakpoints (just above where you want to debug your code).
HTTP over XDebug
To start the debugging-session, simple open the menu "Debugging" > "XDebug / HTTP" "Send start-debugging request to: my-profile-name". If everything (including the server *) is properly configured, the debug session should start right away.
(*: Make sure xdebug in apache-php is propery configured to connect either directly to gedit or to a proxy that is configured in gedit.)
If you see the session-window open and close directly afterwards, you probably have not defined any breakpoints.
When you are done debugging, click on the menu in: Debugging > Stop listening for debugging sessions
PHP-CLI over XDebug
Execute this to start a debugging-session for a PHP-script called over CLI (command line interface):
php -d xdebug.remote_autostart=1 yourscript.php
Make sure xdebug in this cli is propery configured to connect either directly to gedit or to a proxy that is configured in gedit.