An improved PHP debugger
Python Vim script
Switch branches/tags
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


This is a VIM plugin to enable php debuging with Xdebug, to enable python debugging with Komodo-PythonRemoteDebugging-Client, which originates from But most of the code, especially the debugger backend has been rewritten.

Generally speaking, this is a plugin to make VIM working as a DBGP server, so that VIM can talk with DBGP clients like Xdebug and Komodo.

PHP debugging Tested with:

  • XDebug 2.2 - PHP 5.4 - GVIM 7.3 - Python 2.7 @ Windows 7
  • XDebug 2.0 - PHP 5.2 - VIM 7.3 - Python 2.7 @ Linux
  • XDebug 2.2 - PHP 5.2 - VIM 7.3 - Python 2.7 @ Linux
  • XDebug 2.0 - PHP 5.2 - VIM 7.3 - Python 2.3 @ Linux (Only early version of this plugin works with python2.3)
  • XDebug 2.1 - PHP 5.3 - MacVIM 7.3 - Python 2.7 @ OS X 10.8

Python debugging Tested with:

  • Komodo Python Remote Debugging Client - Python 2.7 - MacVIM 7.3 @ Mac OS X 10.8
  • Komodo Python Remote Debugging Client - Python 2.7 - GVIM 7.3 @ Windows 7
  • Komodo Python Remote Debugging Client - Python 2.7 - VIM 7.3 @ Linux

Screen shot

Debugging PHP DBGPavim-php Debugging Python DBGPavim-python

More at


Non blocking debugger backend.

So that VIM users do not need to wait for connection from server. No timeouts; users press F5 to start debugger backend and use VIM normally. Debug backend won't stop users from interacting with VIM. Users can press F6 to stop debugger backend at any time.

Catch all connections from apache server.

This is very important for a large website, especially for pages that contain AJAX requests. In that case, one reload of a page may trigger dozens of HTTP requests, each of them going to a different URL. The new debugger backend will catch all connections from the server.

If you would not like catch all connections from HTTP server, then add below line to your vimrc:

let g:dbgPavimOnce = 1

This setting makes your site accessible when you're in debugging. By default, your site is blocked when you're in debugging, because all connections are caught by debugger backend.

Break only at breakpoints

The debugger backend breaks only at breakpoints by default. If you would like the debugger backend to break at entry, then add below line to your vimrc:

let g:dbgPavimBreakAtEntry = 1

New commands and function keys

In normal mode

<F5>      => start debugger backend
<F6>      => stop debugger backend
<F8>      => toggle dbgPavimBreakAtEntry, when g:dbgPavimBreakAtEntry=0, debugger backend breaks only at breakpoints.
<F10>     => toggle breakpoint at current line

:Bl        => to list all breakpoints
:Bp [expr] => toggle breakpoint on current line, if expr is provided, that is conditional breakpoint, for example, `:Bp ($i > 3)` only breaks when $i is larger than 3.
:Dp [args] => to debug current file from CLI, it will run 'php -dxdebug.remote_autostart=1 -dxdebug.remote_port=<your_port> <curret_file_in_vim> [args]'

:Wc [$foo] => to toggle watch on variable $foo, if no parameter is provided, it will toggle watch on CONTEXT.
:We [foo]  => to eval expression `foo` automatically after each step.
:Wl        => to list all watched variables. By default, you can get output like *CONTEXT*, which means context are automatically populated each step in WATCH WINDOW.

In debugging mode

<F1>      => toggle help window
<F2>      => step into
<F3>      => step over
<F4>      => step out
<F5>      => start debugging / run
<F6>      => stop debugging
<F7>      => evalute expression and display result. cursor is automatically move to watch window. type line and just press `Enter`.
<F9>      => toggle layout
<F11>     => shows all variables
<F12>     => shows variable on current cursor

You can define your own key mappings as below:

let g:dbgPavimKeyRun = '<F8>'
let g:dbgPavimKeyStepOver = '<F10>'
let g:dbgPavimKeyStepInto = '<F11>'
let g:dbgPavimKeyStepOut = '<F12>'
let g:dbgPavimKeyPropertyGet = '<F3>'
let g:dbgPavimKeyContextGet = '<F4>'
let g:dbgPavimKeyToggleBp = '<F9>'
let g:dbgPavimKeyToggleBae = '<F5>'
let g:dbgPavimKeyRelayout = '<F2>'

:Pg        => to print value of complex variables like $this->savings[3]
:Up        => goto upper level of stack
:Dn        => goto lower level of stack

In Watch window

If you press `Enter` at a line which ends with plus to expand it.

If you press `Enter` at a line of output from command `:Bl`, that breakpoint will be located.

In Stack window

If you press `Enter` at a line, stack level will be set.

Windows Support

Status line for debugger backend

After user press F5 to start debugger backend, a string like "bap-LISN-9000" will show up at the right side of status line. Here 9000 is the listening port of debugger, which is set by g:dbgPavimPort.

The status string looks like:


bae       => means Break At Entry
bap       => means Break only At breakPoints

LISN      => means the debugger backend is listening.
PENDn     => means there are n connections waiting for debugging.
CONN      => means debug session has been established, and being debugged.
CLSD      => means the debugger backend has stopped.

New layout of windows

Remote debugging

In case that you need run VIM on a different machine from server where apache httpd runs, configuration for DBGPavim:

let g:dbgPavimPathMap = [['D:/works/php','/var/www'],]

A change to the Apache configuration is also necessary:

php_value xdebug.remote_host <ip_address_where_you_run_vim>


  • Make sure your vim has python (at least 2.3) supported. To check, run :version in vim.

If your VIM doesn't support python, download VIM source package from, then build your own VIM:

./configure --prefix=/opt/vim --enable-pythoninterp --with-python-config-dir=/usr/lib/python2.4/config
make install
  • Install xdebug for php, and edit php.ini
  • Edit your ~/.vimrc

      let g:dbgPavimPort = 9009
      let g:dbgPavimBreakAtEntry = 0
  • Edit your apche configure file

In your VirtualHost section, set debugger port same as the one in your vimrc:

php_value xdebug.remote_port 9009
  • Save and dbgpavim.vim to your ~/.vim/plugin

  • Open your php file, use :Bp to set breakpoints

  • Now, press F5 to start debugger backend

  • Back to your browser, add XDEBUG_SESSION_START=1 to your URL, for example, http://localhost/index.php?XDEBUG_SESSION_START=1.

If you are tired of adding XDEBUG_SESSION_START=1 in query string, there is a XDEBUG_SESSION helper at, a user script for Google Chrome. It also works for Firefox via GreaseMonkey.

Or modify your apache configuration (httpd.conf) --

  php_value xdebug.remote_port 9009
  php_value xdebug.remote_autostart 1

CLI debugging

  • If you would like to debug from CLI, start your php script like

    php -dxdebug.remote_autostart=1 -dxdebug.remote_port=9009 test.php

  • There is new command :Dp to debug current file:

    php -dxdebug.remote_autostart=1 -dxdebug.remote_port=9009

Python debugging

DBGPavim is both a DBGP protocol server and VIM debugger backend, so it can help to debug Python code.

I haved tried it with:

  • Komodo Python Remote Debugging Client --Python 2.7 - MacVim 7.3 @ Mac OS X 10.8
  1. Download Komodo Python Remote Debugging Client from, for Mac, it's Komodo-PythonRemoteDebugging-7.1.2-73175-macosx-x86.tar.gz (Refer to

  2. Open the python script file with VIM, and Press to listen.

  3. extract the package, and run

    bin/pydbgp -d /works/scriptbundle/python/

  4. then the others are same as php debugging.