diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
index 54ffd717f00..39331088285 100644
--- a/reference/configuration/framework.rst
+++ b/reference/configuration/framework.rst
@@ -208,25 +208,16 @@ ide
**type**: ``string`` **default**: ``null``
-Symfony can turn file paths seen in dumps and exception messages into links
-that will open in your preferred text editor or IDE.
+Symfony turns file paths seen in variable dumps and exception messages into
+links that open those files right inside your browser. If you prefer to open
+those files in your favorite IDE or text editor, set this option to any of the
+following values: ``phpstorm`` (requires `PhpStormProtocol`_), ``sublime``,
+``textmate``, ``macvim`` and ``emacs``.
-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
-``%f`` where the file path is expected and ``%l`` for the line number. When using
-the ``ide`` configuration key, percentages signs (``%``) must be escaped by
-doubling them. For example, if you use PHPstorm on the Mac OS platform, you will
-do something like:
+If you use another editor, the expected configuration value is a URL template
+that contains an ``%f`` placeholder where the file path is expected and ``%l``
+placeholder for the line number (percentage signs (``%``) must be escaped by
+doubling them to prevent Symfony from interpreting them as container parameters).
.. configuration-block::
@@ -256,6 +247,22 @@ do something like:
'ide' => 'phpstorm://open?file=%%f&line=%%l',
));
+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. The
+format to use is the same as for the ``framework.ide`` option, but without the
+need to escape the percent signs (``%``) by doubling them.
+
+.. note::
+
+ If both ``framework.ide`` and ``xdebug.file_link_format`` are defined,
+ Symfony uses the value of the ``framework.ide`` option.
+
+.. tip::
+
+ Setting the ``xdebug.file_link_format`` ini option works even if the Xdebug
+ extension is not enabled.
+
.. tip::
When running your app in a container or in a virtual machine, you can tell
@@ -271,12 +278,6 @@ do something like:
.. versionadded:: 3.2
Guest to host mappings were introduced in Symfony 3.2.
-.. tip::
-
- Symfony contains preconfigured URLs for some popular IDEs, you can set them
- using the following values: ``phpstorm`` (requires `PhpStormProtocol`_),
- ``sublime``, ``textmate``, ``macvim`` or ``emacs``.
-
.. _reference-framework-test:
test
pFad - Phonifier reborn
Pfad - The Proxy pFad of © 2024 Garber Painting. All rights reserved.
Note: This service is not intended for secure transactions such as banking, social media, email, or purchasing. Use at your own risk. We assume no liability whatsoever for broken pages.
Alternative Proxies:
Alternative Proxy
pFad Proxy
pFad v3 Proxy
pFad v4 Proxy