Xdebug file links open in PhpStorm

[erikhansen]

This PR implements support for xdebug's file_link_format to open a file in PhpStorm.

[erikhansen]

Important note: If you've setup a PhpStorm project to map to the source directory (e.g. /Volumes/Server/sites/example.dev/), when you click on a file link, it will still open in PhpStorm, but it will be opened outside of the context of the project. The file will be a different color to indicate that it isn't inside the project context. If you try to set breakpoints in the file, they will not work.

Will not work:

Will work:

Update: I wrote the section below before I realized that you must have your PhpStorm project setup at /Volumes/Server/sites/example.dev/ in order to debug automated tests or CRON jobs. Follow the below steps at your own risk.

Here are two ways to make PhpStorm open your project at the /server/sites/example.dev path:

1. Use the "File > Open Directory…" option in PhpStorm and then navigate to the project directory via the /server/sites/example.dev path.
2. Run pstorm /server/sites/example.dev on the command line. Note: Don't cd to the /server/sites/example.dev directory and run pstorm ., as PhpStorm will set the project directory to the source directory (e.g. /Volumes/Server/sites/example.dev/).

If you have existing PhpStorm projects setup with the source directory, just close them and re-open them using one of the methods above and the path mapping should change to the /server/sites/example.dev path.