8000 Deprecated not passing the root node name to config tree builders · symfony/symfony-docs@d70a0a6 · GitHub
[go: up one dir, main page]
Skip to content

Commit d70a0a6

Browse files
javiereguiluzjaviereguiluz
committed
Deprecated not passing the root node name to config tree builders
1 parent d4310d9 commit d70a0a6

File tree

3 files changed

+21
-17
lines changed

3 files changed

+21
-17
lines changed

‎bundles/configuration.rst

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -175,10 +175,9 @@ The ``Configuration`` class to handle the sample configuration looks like::
175175
{
176176
public function getConfigTreeBuilder()
177177
{
178-
$treeBuilder = new TreeBuilder();
179-
$rootNode = $treeBuilder->root('acme_social');
178+
$treeBuilder = new TreeBuilder('acme_social');
180179

181-
$rootNode
180+
$treeBuilder->getRootNode()
182181
->children()
183182
->arrayNode('twitter')
184183
->children()
@@ -193,6 +192,9 @@ The ``Configuration`` class to handle the sample configuration looks like::
193192
}
194193
}
195194

195+
.. versionadded:: 4.2
196+
Not passing the root node name to ``TreeBuilder`` was deprecated in Symfony 4.2.
197+
196198
.. seealso::
197199

198200
The ``Configuration`` class can be much more complicated than shown here,

‎components/config/definition.rst

Lines changed: 11 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -59,15 +59,18 @@ implements the :class:`Symfony\\Component\\Config\\Definition\\ConfigurationInte
5959
{
6060
public function getConfigTreeBuilder()
6161
{
62-
$treeBuilder = new TreeBuilder();
63-
$rootNode = $treeBuilder->root('database');
62+
$treeBuilder = new TreeBuilder('database');
6463

6564
// ... add node definitions to the root of the tree
65+
// $treeBuilder->getRootNode()->...
6666

6767
return $treeBuilder;
6868
}
6969
}
7070

71+
.. versionadded:: 4.2
72+
Not passing the root node name to ``TreeBuilder`` was deprecated in Symfony 4.2.
73+
7174
Adding Node Definitions to the Tree
7275
-----------------------------------
7376

@@ -534,10 +537,9 @@ tree with ``append()``::
534537

535538
public function getConfigTreeBuilder()
536539
{
537-
$treeBuilder = new TreeBuilder();
538-
$rootNode = $treeBuilder->root('database');
540+
$treeBuilder = new TreeBuilder('database');
539541

540-
$rootNode
542+
$treeBuilder->getRootNode()
541543
->children()
542544
->arrayNode('connection')
543545
->children()
@@ -564,10 +566,9 @@ tree with ``append()``::
564566

565567
public function addParametersNode()
566568
{
567-
$treeBuilder = new TreeBuilder();
568-
$node = $treeBuilder->root('parameters');
569+
$treeBuilder = new TreeBuilder('parameters');
569570

570-
$node
571+
$treeBuilder->getRootNode()
571572
->isRequired()
572573
->requiresAtLeastOneElement()
573574
->useAttributeAsKey('name')
@@ -795,10 +796,9 @@ Configuring the Node Path Separator
795796

796797
Consider the following config builder example::
797798

798-
$treeBuilder = new TreeBuilder();
799-
$rootNode = $treeBuilder->root('database');
799+
$treeBuilder = new TreeBuilder('database');
800800

801-
$rootNode
801+
$treeBuilder->getRootNode()
802802
->children()
803803
->arrayNode('connection')
804804
->children()

‎configuration/using_parameters_in_dic.rst

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -109,10 +109,9 @@ be injected with this parameter via the extension as follows::
109109

110110
public function getConfigTreeBuilder()
111111
{
112-
$treeBuilder = new TreeBuilder();
113-
$rootNode = $treeBuilder->root('my_bundle');
112+
$treeBuilder = new TreeBuilder('my_bundle');
114113

115-
$rootNode
114+
$treeBuilder->getRootNode()
116115
->children()
117116
// ...
118117
->booleanNode('logging')->defaultValue($this->debug)->end()
@@ -124,6 +123,9 @@ be injected with this parameter via the extension as follows::
124123
}
125124
}
126125

126+
.. versionadded:: 4.2
127+
Not passing the root node name to ``TreeBuilder`` was deprecated in Symfony 4.2.
128+
127129
And set it in the constructor of ``Configuration`` via the ``Extension`` class::
128130

129131
namespace App\DependencyInjection;

0 commit comments

Comments
 (0)
0