Skip to content

Commit 138f29a

Browse files
committed
minor #7201 Simplified the framework configuration reference (javiereguiluz, weaverryan)
This PR was merged into the 2.7 branch. Discussion ---------- Simplified the framework configuration reference I propose two main changes: * Show how can users display the default config and their own config. * Remove the dump of the default config values. I never liked the config dump because in my opinion: * It simply adds "noise" and doesn't explain anything * It's hard to maintain it updated * The same can easily be achieved with a dedicated console command * Removing it will simplify the work of doc maintainers and it'll reduce the merge conflicts * These references are very useful for the config option descriptions, not for just listing those options Thoughts? Thanks! PS: if you agree, I'll update the rest of the references. Commits ------- a71ef9d Shortened command... easier to remember ;) 2d68dc3 Last fixes b91b196 Restored the "Full Default Configuration" dump 396548c Fixed an indentation issue 8076c40 Simplified the framework configuration reference
2 parents 2fe2136 + a71ef9d commit 138f29a

File tree

1 file changed

+14
-9
lines changed

1 file changed

+14
-9
lines changed

reference/configuration/framework.rst

Lines changed: 14 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -4,18 +4,23 @@
44
FrameworkBundle Configuration ("framework")
55
===========================================
66

7-
The FrameworkBundle contains most of the "base" framework functionality
8-
and can be configured under the ``framework`` key in your application
9-
configuration. When using XML, you must use the
10-
``http://symfony.com/schema/dic/symfony`` namespace.
7+
The FrameworkBundle defines the main framework configuration, from sessions and
8+
translations to forms, validation, routing and more. All these options are
9+
configured under the ``framework`` key in your application configuration.
1110

12-
This includes settings related to sessions, translation, forms, validation,
13-
routing and more.
11+
.. code-block:: terminal
1412
15-
.. tip::
13+
# displays the default config values defined by Symfony
14+
$ php bin/console config:dump framework
15+
16+
# displays the actual config values used by your application
17+
$ php bin/console debug:config framework
18+
19+
.. note::
1620

17-
The XSD schema is available at
18-
``http://symfony.com/schema/dic/symfony/symfony-1.0.xsd``.
21+
When using XML, you must use the ``http://symfony.com/schema/dic/symfony``
22+
namespace and the related XSD schema is available at:
23+
``http://symfony.com/schema/dic/symfony/symfony-1.0.xsd``
1924

2025
Configuration
2126
-------------

0 commit comments

Comments
 (0)