We have a production environment based on symlink.

We are deploying new version of an application to a new directory whose name corresponds to SVN revisions number (in ex. 1, 2, 3) and change symlink 'current' so that it points to the newest code version.

Apache's Document Root is set to: /var/www/app/$app-name/current/

Example:

/var/www/
         www.example.org/
                         1/
                           index.php
                         2/
                           index.php
                         3/
                           index.php
                         current => 3

When we try to debug the application we encounter a problem with directory mapping, because symlink current is resolved by xDebug to return the real path, for example: /var/www/www.example.org/3/... instead of the expected /var/www/www.example.org/current/...

We made a small modification to xdebug that allows for optional disabling of symlink resolution.