Merge branch '3.4'

* 3.4: (81 commits)
  Fixed a RST syntax issue
  Mention that ACL is deprecated in the security config reference
  Update questionhelper.rst
  Remove TableHelper Page
  [#8416] Minor tweaks
  Minor tweaks to #8502
  Documented the new config prototype shortcuts
  Document the new RequestExceptionInterface
  Docs re-org and removal of small sections
  Processed xabbuh comments
  Fixes
  Fixed a grammar issue
  remove deprecated feature description
  Fix a small typo error (number.rst)
  Remove deprecated proxy argument
  Fix instance of class in express language in DI
  Missing use reference
  Unused Private param in documentation
  Doctrine event listener could persist a null value
  Added about command in debug page
  ...

Author: weaverryan

_build/redirection_map

@@ -77,13 +77,20 @@
 /book/configuration /configuration
 /book/propel /propel/propel
 /book/performance /performance
-/cookbook/assetic/apply_to_option /assetic/apply_to_option
-/cookbook/assetic/asset_management /assetic/asset_management
-/cookbook/assetic/index /assetic
-/cookbook/assetic/jpeg_optimize /assetic/jpeg_optimize
-/cookbook/assetic/php /assetic/php
-/cookbook/assetic/uglifyjs /assetic/uglifyjs
-/cookbook/assetic/yuicompressor /assetic/yuicompressor
+/cookbook/assetic/apply_to_option /frontend/assetic/apply_to_option
+/cookbook/assetic/asset_management /frontend/assetic/asset_management
+/cookbook/assetic/index /frontend/assetic
+/cookbook/assetic/jpeg_optimize /frontend/assetic/jpeg_optimize
+/cookbook/assetic/php /frontend/assetic/php
+/cookbook/assetic/uglifyjs /frontend/assetic/uglifyjs
+/cookbook/assetic/yuicompressor /frontend/assetic/yuicompressor
+/assetic /frontend/assetic
+/assetic/apply_to_option /frontend/assetic/apply_to_option
+/assetic/asset_management /frontend/assetic/asset_management
+/assetic/jpeg_optimize /frontend/assetic/jpeg_optimize
+/assetic/php /frontend/assetic/php
+/assetic/uglifyjs /frontend/assetic/uglifyjs
+/assetic/yuicompressor /frontend/assetic/yuicompressor
 /cookbook/bundles/best_practices /bundles/best_practices
 /cookbook/bundles/configuration /bundles/configuration
 /cookbook/bundles/extension /bundles/extension
@@ -152,7 +159,8 @@
 /cookbook/event_dispatcher/event_listener /event_dispatcher
 /cookbook/event_dispatcher/index /event_dispatcher
 /cookbook/event_dispatcher/method_behavior /event_dispatcher/method_behavior
-/cookbook/expressions /expressions/expressions
+/cookbook/expressions /security/expressions
+/expressions /security/expressions
 /cookbook/form/create_custom_field_type /form/create_custom_field_type
 /cookbook/form/create_form_type_extension /form/create_form_type_extension
 /cookbook/form/data_transformers /form/data_transformers
@@ -183,10 +191,10 @@
 /cookbook/profiler/matchers /profiler/matchers
 /cookbook/profiler/profiling_data /profiler/profiling_data
 /cookbook/profiler/storage /profiler/storage
-/cookbook/psr7 /request/psr7
+/cookbook/psr7 /components/psr7
 /cookbook/request/index /request
-/cookbook/request/load_balancer_reverse_proxy /request/load_balancer_reverse_proxy
-/cookbook/request/mime_type /request/mime_type
+/cookbook/request/load_balancer_reverse_proxy /deployment/proxies
+/cookbook/request/mime_type /reference/configuration/framework#formats
 /cookbook/routing/conditions /routing/conditions
 /cookbook/routing/custom_route_loader /routing/custom_route_loader
 /cookbook/routing/debug /routing/debug
@@ -281,6 +289,7 @@
 /components/class_loader/index /components/class_loader
 /components/config/introduction /components/config
 /components/config/index /components/config
+/components/console/helpers/tablehelper /components/console/helpers/table
 /components/console/introduction /components/console
 /components/console/index /components/console
 /components/debug/class_loader /components/debug
@@ -311,7 +320,8 @@
 /components/form/type_guesser /form/type_guesser
 /components/http_foundation/index /components/http_foundation
 /components/http_foundation/introduction /components/http_foundation
-/components/http_foundation/trusting_proxies /request/load_balancer_reverse_proxy
+/request/load_balancer_reverse_proxy /deployment/proxies
+/components/http_foundation/trusting_proxies /deployment/proxies
 /components/http_kernel/introduction /components/http_kernel
 /components/http_kernel/index /components/http_kernel
 /components/property_access/introduction /components/property_access
@@ -341,3 +351,4 @@
 /templating/templating_service /templates
 /testing/simulating_authentication /testing/http_authentication
 /validation/group_service_resolver /form/validation_group_service_resolver
+/request/load_balancer_reverse_proxy /deployment/proxies

_images/form/simple-form.png

@@ -51,7 +51,7 @@ tools like GruntJS.
     Use Assetic to compile, combine and minimize web assets, unless you're
     comfortable with frontend tools like GruntJS.
 
-:doc:`Assetic </assetic/asset_management>` is an asset manager capable
+:doc:`Assetic </frontend/assetic/asset_management>` is an asset manager capable
 of compiling assets developed with a lot of different frontend technologies
 like LESS, Sass and CoffeeScript. Combining all your assets with Assetic is a
 matter of wrapping all the assets with a single Twig tag:
@@ -89,8 +89,8 @@ Learn More about Assetic
 ------------------------
 
 Assetic can also minimize CSS and JavaScript assets
-:doc:`using UglifyCSS/UglifyJS </assetic/uglifyjs>` to speed up your
-websites. You can even :doc:`compress images </assetic/jpeg_optimize>`
+:doc:`using UglifyCSS/UglifyJS </frontend/assetic/uglifyjs>` to speed up your
+websites. You can even :doc:`compress images </frontend/assetic/jpeg_optimize>`
 with Assetic to reduce their size before serving them to the user. Check out
 the `official Assetic documentation`_ to learn more about all the available
 features.

best_practices/web-assets.rst

@@ -129,11 +129,9 @@ read more about it, see the ":doc:`/bundles/configuration`" article.
 Adding Classes to Compile
 -------------------------
 
-.. note::
-
-    The ``addClassesToCompile()`` method was deprecated in Symfony 3.3, and will
-    be removed in Symfony 4.0. If you want to use this method and be compatible
-    with Symfony 4.0, check to see if the method exists before calling it.
+.. versionadded:: 3.3
+    This technique is discouraged and the ``addClassesToCompile()`` method was
+    deprecated in Symfony 3.3 because modern PHP versions make it unnecessary.
 
 Symfony creates a big ``classes.php`` file in the cache directory to aggregate
 the contents of the PHP classes that are used in every request. This reduces the

bundles/extension.rst

@@ -174,7 +174,7 @@ Or you may define a prototype for each node inside an array node::
     $rootNode
         ->children()
             ->arrayNode('connections')
-                ->prototype('array')
+                ->arrayPrototype()
                     ->children()
                         ->scalarNode('driver')->end()
                         ->scalarNode('host')->end()
@@ -186,6 +186,12 @@ Or you may define a prototype for each node inside an array node::
         ->end()
     ;
 
+.. versionadded:: 3.3
+    The ``arrayPrototype()`` method (and the related ``booleanPrototype()``
+    ``integerPrototype()``, ``floatPrototype()``, ``scalarPrototype()`` and
+    ``enumPrototype()``) was introduced in Symfony 3.3. In previous versions,
+    you needed to use ``prototype('array')``, ``prototype('boolean')``, etc.
+
 A prototype can be used to add a definition which may be repeated many times
 inside the current node. According to the prototype definition in the example
 above, it is possible to have multiple connection arrays (containing a ``driver``,
@@ -229,7 +235,7 @@ A basic prototyped array configuration can be defined as follows::
         ->fixXmlConfig('driver')
         ->children()
             ->arrayNode('drivers')
-                ->prototype('scalar')->end()
+                ->scalarPrototype()->end()
             ->end()
         ->end()
     ;
@@ -260,7 +266,7 @@ A more complex example would be to define a prototyped array with children::
         ->fixXmlConfig('connection')
         ->children()
             ->arrayNode('connections')
-                ->prototype('array')
+                ->arrayPrototype()
                     ->children()
                         ->scalarNode('table')->end()
                         ->scalarNode('user')->end()
@@ -334,7 +340,7 @@ In order to maintain the array keys use the ``useAttributeAsKey()`` method::
         ->children()
             ->arrayNode('connections')
                 ->useAttributeAsKey('name')
-                ->prototype('array')
+                ->arrayPrototype()
                     ->children()
                         ->scalarNode('table')->end()
                         ->scalarNode('user')->end()
@@ -572,7 +578,7 @@ tree with ``append()``::
             ->isRequired()
             ->requiresAtLeastOneElement()
             ->useAttributeAsKey('name')
-            ->prototype('array')
+            ->arrayPrototype
                 ->children()
                     ->scalarNode('value')->isRequired()->end()
                 ->end()
@@ -670,7 +676,7 @@ with ``fixXmlConfig()``::
         ->fixXmlConfig('extension')
         ->children()
             ->arrayNode('extensions')
-                ->prototype('scalar')->end()
+                ->scalarPrototype()->end()
             ->end()
         ->end()
     ;

components/config/definition.rst

@@ -14,7 +14,6 @@ The Console Helpers
     progresshelper
     questionhelper
     table
-    tablehelper
     debug_formatter
 
 The Console component comes with some useful helpers. These helpers contain

components/console/helpers/index.rst

@@ -169,6 +169,8 @@ will be autocompleted as the user types::
     public function execute(InputInterface $input, OutputInterface $output)
     {
         // ...
+        $helper = $this->getHelper('question');
+        
         $bundles = array('AcmeDemoBundle', 'AcmeBlogBundle', 'AcmeStoreBundle');
         $question = new Question('Please enter the name of a bundle', 'FooBundle');
         $question->setAutocompleterValues($bundles);
@@ -188,6 +190,8 @@ convenient for passwords::
     public function execute(InputInterface $input, OutputInterface $output)
     {
         // ...
+        $helper = $this->getHelper('question');
+        
         $question = new Question('What is the database password?');
         $question->setHidden(true);
         $question->setHiddenFallback(false);
@@ -244,6 +248,8 @@ method::
     public function execute(InputInterface $input, OutputInterface $output)
     {
         // ...
+        $helper = $this->getHelper('question');
+        
         $question = new Question('Please enter the name of the bundle', 'AppBundle');
         $question->setNormalizer(function ($value) {
             // $value can be null here
@@ -275,6 +281,8 @@ method::
     public function execute(InputInterface $input, OutputInterface $output)
     {
         // ...
+        $helper = $this->getHelper('question');
+
         $question = new Question('Please enter the name of the bundle', 'AcmeDemoBundle');
         $question->setValidator(function ($answer) {
             if (!is_string($answer) || 'Bundle' !== substr($answer, -6)) {

components/console/helpers/questionhelper.rst

@@ -148,6 +148,16 @@ can run it with:
 
     $ php application.php d:g Fabien
 
+    # as long as it's unambiguous, you can also mix upper and lower case
+    # php application.php Demo:g Fabien
+    # php application.php de:Gr Fabien
+    # php application.php DE:Gre Fabien
+
 If you enter a short command that's ambiguous (i.e. there are more than one
 command that match), then no command will be run and some suggestions of
 the possible commands to choose from will be output.
+
+.. versionadded:: 3.4
+    Case-insensitivity of command shortcuts was introduced in Symfony 3.4. In
+    previous Symfony versions, shortcuts had to match the case of the original
+    command name (e.g. ``d:g`` was not the same shortcut as ``D:G``).

components/console/helpers/tablehelper.rst

@@ -5,8 +5,9 @@
 The DependencyInjection Component
 =================================
 
-    The DependencyInjection component allows you to standardize and centralize
-    the way objects are constructed in your application.
+    The DependencyInjection component implements a `PSR-11`_ compatible service
+    container that allows you to standardize and centralize the way objects are
+    constructed in your application.
 
 For an introduction to Dependency Injection and service containers see
 :doc:`/service_container`.
@@ -305,4 +306,5 @@ Learn More
     /components/dependency_injection/*
     /service_container/*
 
+.. _`PSR-11`: http://www.php-fig.org/psr/psr-11/
 .. _Packagist: https://packagist.org/packages/symfony/dependency-injection