Merge branch '4.1' into 4.2

javiereguiluz · javiereguiluz · commit c19f2794f85b · 2019-01-03T12:29:13.000+01:00
* 4.1:
  clarify how to use custom entity manager names
  Fixed tiny grammar error in flex.rst
  [Validator] Range constraint: min and mix can be integer or string
  update year in license
  added blank line after .. versionadded:: directive
  add missing blank line after directive
  Add missing imports and remove useless
diff --git a/components/cache/adapters/memcached_adapter.rst b/components/cache/adapters/memcached_adapter.rst
@@ -278,6 +278,7 @@ Available Options
     are valid and fit within the design of the protocol being used.
 
 .. tip::
+
     Reference the `Memcached`_ extension's `predefined constants`_ documentation
     for additional information about the available options.
 
diff --git a/components/cache/adapters/redis_adapter.rst b/components/cache/adapters/redis_adapter.rst
@@ -149,6 +149,7 @@ Available Options
     connection attempt times out.
 
 .. note::
+
     When using the `Predis`_ library some additional Predis-specific options are available.
     Reference the `Predis Connection Parameters`_ documentation for more information.
 
diff --git a/components/cache/cache_pools.rst b/components/cache/cache_pools.rst
@@ -152,6 +152,7 @@ when all items are successfully deleted)::
         $ php bin/console cache:pool:clear cache.validation cache.app
 
 .. versionadded:: 4.1
+
     The ``cache:pool:delete`` command was introduced in Symfony 4.1.
 
 .. _component-cache-cache-pool-prune:
diff --git a/components/console/helpers/questionhelper.rst b/components/console/helpers/questionhelper.rst
@@ -25,6 +25,7 @@ Suppose you want to confirm an action before actually executing it. Add
 the following to your command::
 
     // ...
+    use Symfony\Component\Console\Command\Command;
     use Symfony\Component\Console\Input\InputInterface;
     use Symfony\Component\Console\Output\OutputInterface;
     use Symfony\Component\Console\Question\ConfirmationQuestion;
diff --git a/components/console/helpers/table.rst b/components/console/helpers/table.rst
@@ -20,7 +20,10 @@ When building a console application it may be useful to display tabular data:
 To display a table, use :class:`Symfony\\Component\\Console\\Helper\\Table`,
 set the headers, set the rows and then render the table::
 
+    use Symfony\Component\Console\Command\Command;
     use Symfony\Component\Console\Helper\Table;
+    use Symfony\Component\Console\Input\InputInterface;
+    use Symfony\Component\Console\Output\OutputInterface;
     // ...
 
     class SomeCommand extends Command
diff --git a/components/form.rst b/components/form.rst
@@ -224,6 +224,7 @@ to bootstrap or access Twig and add the :class:`Symfony\\Bridge\\Twig\\Extension
         ->getFormFactory();
 
 .. versionadded:: 1.30
+
     The ``Twig\\RuntimeLoader\\FactoryRuntimeLoader`` was introduced in Twig 1.30.
 
 The exact details of your `Twig Configuration`_ will vary, but the goal is
diff --git a/components/phpunit_bridge.rst b/components/phpunit_bridge.rst
@@ -543,7 +543,7 @@ namespaces in the ``phpunit.xml`` file, as done for example in the
             </listener>
         </listeners>
     </phpunit>
-    
+
 Under the hood, a PHPUnit listener injects the mocked functions in the tested
 classes' namespace. In order to work as expected, the listener has to run before
 the tested class ever runs. By default, the mocked functions are created when the
diff --git a/components/process.rst b/components/process.rst
@@ -101,6 +101,7 @@ Using Features From the OS Shell
 --------------------------------
 
 .. versionadded:: 4.2
+
     The ``fromShellCommandline()`` static method was introduced in Symfony 4.2.
 
 Using array of arguments is the recommended way to define commands. This
diff --git a/components/property_info.rst b/components/property_info.rst
@@ -250,6 +250,7 @@ to determine if it's accessible. This based on how the :doc:`PropertyAccess </co
 works.
 
 .. versionadded:: 4.1
+
     The support of hasser methods in the ``ReflectionExtractor`` class was
     introduced in Symfony 4.1.
 
diff --git a/components/serializer.rst b/components/serializer.rst
@@ -165,6 +165,7 @@ needs three parameters:
 #. The encoder used to convert that information into an array
 
 .. versionadded:: 3.3
+
     Support for the ``allow_extra_attributes`` key in the context was introduced
     in Symfony 3.3.
 
@@ -717,6 +718,7 @@ There are several types of normalizers available:
     into a list of errors according to the `RFC 7807`_ standard.
 
     .. versionadded:: 4.1
+
         The ``ConstraintViolationListNormalizer`` was introduced in Symfony 4.1.
 
 .. _component-serializer-encoders:
@@ -835,7 +837,6 @@ The ``YamlEncoder``
 This encoder requires the :doc:`Yaml Component </components/yaml>` and
 transforms from and to Yaml.
 
-
 Skipping ``null`` Values
 ------------------------
 
@@ -853,6 +854,7 @@ to ``true``::
     // ['bar' => 'notNull']
 
 .. versionadded:: 4.2
+
     The ``skip_null_values`` option was introduced in Symfony 4.2.
 
 .. _component-serializer-handling-circular-references:
diff --git a/components/validator.rst b/components/validator.rst
@@ -65,6 +65,7 @@ If you have lots of validation errors, you can filter them by error code::
     }
 
 .. versionadded:: 3.3
+
     The ``findByCodes()`` method was introduced in Symfony 3.3.
 
 Retrieving a Validator Instance
diff --git a/components/workflow.rst b/components/workflow.rst
@@ -74,7 +74,7 @@ are trying to use it with::
     $registry = new Registry();
     $registry->addWorkflow($blogWorkflow, new InstanceOfSupportStrategy(BlogPost::class));
     $registry->addWorkflow($newsletterWorkflow, new InstanceOfSupportStrategy(Newsletter::class));
-    
+
 .. versionadded:: 4.1
     The ``addWorkflow()`` method was introduced in Symfony 4.1. In previous
     Symfony versions it was called ``add()``.
diff --git a/configuration/external_parameters.rst b/configuration/external_parameters.rst
@@ -138,6 +138,7 @@ Environment Variable Processors
 -------------------------------
 
 .. versionadded:: 3.4
+
     Environment variable processors were introduced in Symfony 3.4.
 
 The values of environment variables are considered strings by default.
diff --git a/configuration/micro_kernel_trait.rst b/configuration/micro_kernel_trait.rst
@@ -125,7 +125,7 @@ your ``composer.json`` file to load from there:
     }
 
 Then, run ``composer dump-autoload`` to dump your new autoload config.
-    
+
 Now, suppose you want to use Twig and load routes via annotations. Instead of
 putting *everything* in ``index.php``, create a new ``src/Kernel.php`` to
 hold the kernel. Now it looks like this::
diff --git a/console.rst b/console.rst
@@ -74,6 +74,10 @@ constructor. If your command defines its own constructor, set the properties
 first and then call to the parent constructor, to make those properties
 available in the ``configure()`` method::
 
+    // ...
+    use Symfony\Component\Console\Command\Command;
+    use Symfony\Component\Console\Input\InputArgument;
+
     class CreateUserCommand extends Command
     {
         // ...
diff --git a/console/calling_commands.rst b/console/calling_commands.rst
@@ -11,6 +11,8 @@ generating Doctrine2 proxies, dumping web assets, ...).
 Calling a command from another one is straightforward::
 
     use Symfony\Component\Console\Input\ArrayInput;
+    use Symfony\Component\Console\Input\InputInterface;
+    use Symfony\Component\Console\Output\OutputInterface;
     // ...
 
     protected function execute(InputInterface $input, OutputInterface $output)
diff --git a/console/input.rst b/console/input.rst
@@ -14,6 +14,7 @@ or required. For example, to add an optional ``last_name`` argument to the comma
 and make the ``name`` argument required::
 
     // ...
+    use Symfony\Component\Console\Command\Command;
     use Symfony\Component\Console\Input\InputArgument;
 
     class GreetCommand extends Command
@@ -33,6 +34,10 @@ and make the ``name`` argument required::
 You now have access to a ``last_name`` argument in your command::
 
     // ...
+    use Symfony\Component\Console\Command\Command;
+    use Symfony\Component\Console\Input\InputInterface;
+    use Symfony\Component\Console\Output\OutputInterface;
+
     class GreetCommand extends Command
     {
         // ...
diff --git a/console/lockable_trait.rst b/console/lockable_trait.rst
@@ -11,7 +11,10 @@ In addition, the Console component provides a PHP trait called ``LockableTrait``
 that adds two convenient methods to lock and release commands::
 
     // ...
+    use Symfony\Component\Console\Command\Command;
     use Symfony\Component\Console\Command\LockableTrait;
+    use Symfony\Component\Console\Input\InputInterface;
+    use Symfony\Component\Console\Output\OutputInterface;
 
     class UpdateContentsCommand extends Command
     {
diff --git a/console/request_context.rst b/console/request_context.rst
@@ -66,6 +66,7 @@ will override the defaults.
         $container->setParameter('asset.request_context.secure', true);
 
 .. versionadded:: 3.4
+
     The ``asset.request_context.*`` parameters were introduced in Symfony 3.4.
 
 Configuring the Request Context per Command
diff --git a/console/verbosity.rst b/console/verbosity.rst
@@ -41,6 +41,10 @@ It is possible to print a message in a command for only a specific verbosity
 level. For example::
 
     // ...
+    use Symfony\Component\Console\Command\Command;
+    use Symfony\Component\Console\Input\InputInterface;
+    use Symfony\Component\Console\Output\OutputInterface;
+
     class CreateUserCommand extends Command
     {
         // ...
diff --git a/contributing/code/license.rst b/contributing/code/license.rst
@@ -5,7 +5,7 @@ Symfony Code License
 
 Symfony code is released under `the MIT license`_:
 
-Copyright (c) 2004-2018 Fabien Potencier
+Copyright (c) 2004-2019 Fabien Potencier
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal
diff --git a/contributing/documentation/format.rst b/contributing/documentation/format.rst
@@ -178,6 +178,7 @@ Symfony, you should precede your description of the change with a
 .. code-block:: rst
 
     .. versionadded:: 2.7
+
         The ``askHiddenResponse()`` method was introduced in Symfony 2.7.
 
     You can also ask a question and hide the response. This is particularly [...]
@@ -188,6 +189,7 @@ how the behavior has changed:
 .. code-block:: rst
 
     .. versionadded:: 2.7
+
         The ``include()`` function is a new Twig feature that's available in
         Symfony 2.7. Prior, the ``{% include %}`` tag was used.
 
diff --git a/doctrine/multiple_entity_managers.rst b/doctrine/multiple_entity_managers.rst
@@ -186,12 +186,25 @@ and ``customer``. The ``default`` entity manager manages entities in the
 entities in ``src/Entity/Customer``. You've also defined two connections, one
 for each entity manager.
 
-.. note::
+.. caution::
 
     When working with multiple connections and entity managers, you should be
     explicit about which configuration you want. If you *do* omit the name of
     the connection or entity manager, the default (i.e. ``default``) is used.
 
+    If you use a different name than ``default`` for the default entity manager,
+    you will need to redefine the default entity manager in ``prod`` environment
+    configuration too:
+
+    .. code-block:: yaml
+
+        # config/packages/prod/doctrine.yaml
+        doctrine:
+            orm:
+                default_entity_manager: 'your default entity manager name'
+
+        # ...
+
 When working with multiple connections to create your databases:
 
 .. code-block:: terminal
diff --git a/event_dispatcher.rst b/event_dispatcher.rst
@@ -212,8 +212,6 @@ or a "sub request"::
     namespace App\EventListener;
 
     use Symfony\Component\HttpKernel\Event\GetResponseEvent;
-    use Symfony\Component\HttpKernel\HttpKernel;
-    use Symfony\Component\HttpKernel\HttpKernelInterface;
 
     class RequestListener
     {
diff --git a/http_cache/validation.rst b/http_cache/validation.rst
@@ -62,6 +62,7 @@ To see a simple implementation, generate the ETag as the md5 of the content::
     // src/Controller/DefaultController.php
     namespace App\Controller;
 
+    use Symfony\Bundle\FrameworkBundle\Controller\Controller;
     use Symfony\Component\HttpFoundation\Request;
 
     class DefaultController extends AbstractController
diff --git a/reference/configuration/framework.rst b/reference/configuration/framework.rst
@@ -1648,6 +1648,7 @@ default_path
 ............
 
 .. versionadded:: 3.4
+
     The ``default_path`` option was introduced in Symfony 3.4.
 
 **type**: ``string`` **default**: ``%kernel.project_dir%/translations``
diff --git a/reference/configuration/security.rst b/reference/configuration/security.rst
@@ -163,6 +163,7 @@ logout_on_user_change
 **type**: ``boolean`` **default**: ``true``
 
 .. versionadded:: 4.1
+
     The ``logout_on_user_change`` option was deprecated in Symfony 4.1.
 
 If ``false`` this option makes Symfony to not trigger a logout when the user has
diff --git a/reference/configuration/swiftmailer.rst b/reference/configuration/swiftmailer.rst
@@ -133,6 +133,7 @@ local_domain
 **type**: ``string``
 
 .. versionadded:: 2.4.0
+
     The ``local_domain`` option was introduced in SwiftMailerBundle 2.4.0.
 
 The domain name to use in ``HELO`` command.
diff --git a/reference/constraints/Range.rst b/reference/constraints/Range.rst
@@ -1,7 +1,7 @@
 Range
 =====
 
-Validates that a given number is *between* some minimum and maximum number.
+Validates that a given number or ``DateTime`` object is *between* some minimum and maximum.
 
 +----------------+---------------------------------------------------------------------+
 | Applies to     | :ref:`property or method <validation-property-target>`              |
@@ -320,15 +320,15 @@ Options
 min
 ~~~
 
-**type**: ``integer``
+**type**: ``int`` or ``string`` (date format)
 
 This required option is the "min" value. Validation will fail if the given
 value is **less** than this min value.
 
 max
 ~~~
 
-**type**: ``integer``
+**type**: ``int`` or ``string`` (date format)
 
 This required option is the "max" value. Validation will fail if the given
 value is **greater** than this max value.
diff --git a/reference/forms/types/number.rst b/reference/forms/types/number.rst
@@ -47,6 +47,7 @@ scale
 ~~~~~
 
 .. versionadded:: 2.7
+
     The ``scale`` option was introduced in Symfony 2.7. Prior to Symfony 2.7,
     it was known as ``precision``.
 
diff --git a/security/guard_authentication.rst b/security/guard_authentication.rst
@@ -164,7 +164,6 @@ This requires you to implement several methods::
         }
     }
 
-
 Nice work! Each method is explained below: :ref:`The Guard Authenticator Methods<guard-auth-methods>`.
 
 Step 3) Configure the Authenticator
diff --git a/security/ldap.rst b/security/ldap.rst
@@ -110,7 +110,6 @@ An LDAP client can be configured using the built-in
         // config/services.php
         use Symfony\Component\Ldap\Ldap;
         use Symfony\Component\Ldap\Adapter\ExtLdap\Adapter;
-        use Symfony\Component\DependencyInjection\Definition;
 
         $container->register(Ldap::class)
             ->addArgument(new Reference(Adapter::class);
diff --git a/security/voters.rst b/security/voters.rst
@@ -36,6 +36,9 @@ A custom voter needs to implement
 or extend :class:`Symfony\\Component\\Security\\Core\\Authorization\\Voter\\Voter`,
 which makes creating a voter even easier::
 
+    use Symfony\Component\Security\Core\Authentication\Token\TokenInterface;
+    use Symfony\Component\Security\Core\Authorization\Voter\VoterInterface;
+
     abstract class Voter implements VoterInterface
     {
         abstract protected function supports($attribute, $subject);
diff --git a/service_container/alias_private.rst b/service_container/alias_private.rst
@@ -154,6 +154,7 @@ Anonymous Services
     Anonymous services are only supported by the XML and YAML configuration formats.
 
 .. versionadded:: 3.3
+
     The feature to configure anonymous services in YAML was introduced in Symfony 3.3.
 
 In some cases, you may want to prevent a service being used as a dependency of
diff --git a/service_container/definitions.rst b/service_container/definitions.rst
@@ -21,6 +21,8 @@ Getting and Setting Service Definitions
 
 There are some helpful methods for working with the service definitions::
 
+    use Symfony\Component\DependencyInjection\Definition;
+
     // finds out if there is an "app.mailer" definition
     $container->hasDefinition('app.mailer');
     // finds out if there is an "app.mailer" definition or alias
diff --git a/service_container/parent_services.rst b/service_container/parent_services.rst
@@ -12,6 +12,9 @@ you may have multiple repository classes which need the
     // src/Repository/BaseDoctrineRepository.php
     namespace App\Repository;
 
+    use Doctrine\Common\Persistence\ObjectManager;
+    use Psr\Log\LoggerInterface;
+
     // ...
     abstract class BaseDoctrineRepository
     {
diff --git a/service_container/service_subscribers_locators.rst b/service_container/service_subscribers_locators.rst
@@ -5,6 +5,7 @@ Service Subscribers & Locators
 ==============================
 
 .. versionadded:: 3.3
+
     Service subscribers and locators were introduced in Symfony 3.3.
 
 Sometimes, a service needs access to several other services without being sure
diff --git a/service_container/synthetic_services.rst b/service_container/synthetic_services.rst
diff --git a/setup/flex.rst b/setup/flex.rst
diff --git a/templating/twig_extension.rst b/templating/twig_extension.rst
diff --git a/testing.rst b/testing.rst
diff --git a/testing/insulating_clients.rst b/testing/insulating_clients.rst
diff --git a/testing/profiling.rst b/testing/profiling.rst
diff --git a/validation/sequence_provider.rst b/validation/sequence_provider.rst
