From 3a0c0d8199d9d76c562efbf137e5e685bf3bc42f Mon Sep 17 00:00:00 2001 From: Nicolas Grekas Date: Fri, 30 Sep 2016 12:03:04 +0100 Subject: [PATCH] [Framework] Update link-to-source mapping definition --- reference/configuration/framework.rst | 11 ++++++++--- 1 file changed, 8 insertions(+), 3 deletions(-) diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst index ac4dcedc0a4..ba624ae35f6 100644 --- a/reference/configuration/framework.rst +++ b/reference/configuration/framework.rst @@ -212,6 +212,11 @@ Since every developer uses a different IDE, the recommended way to enable this feature is to configure it on a system level. This can be done by setting the ``xdebug.file_link_format`` option in your ``php.ini`` configuration file. +.. tip:: + + Setting the ``xdebug.file_link_format`` ini option works even if the Xdebug + extension is not enabled. + Alternatively, you can use this ``ide`` configuration key. In both cases, the expected configuration value is a URL template that contains an @@ -252,13 +257,13 @@ do something like: When running your app in a container or in a virtual machine, you can tell Symfony to map files from the guest to the host by changing their prefix. - This map should be specified at the end of the URL template after a ``#`` - using JSON-like key/values:: + This map should be specified at the end of the URL template, using ``&`` and + ``>`` as guest-to-host separators:: // /path/to/guest/.../file will be opened // as /path/to/host/.../file on the host // and /foo/.../file as /bar/.../file also - 'myide://%f:%l#"/path/to/guest/":"/path/to/host/","/foo/":"/bar/"...' + 'myide://%f:%l&/path/to/guest/>/path/to/host/&/foo/>/bar/&...' .. versionadded:: 3.2 Guest to host mappings were introduced in Symfony 3.2.