Merge branch '4.4'

* 4.4:
  [PropertyInfo] Mentioned that property types can be extracted from constructor too
  [Translation] Updated the default behavior of translator.fallbacks
  [HttpClient] Documented the auth_ntlm option

Author: javiereguiluz

components/http_client.rst

@@ -126,14 +126,18 @@ each request (which overrides any global authentication)::
 
     // Use the same authentication for all requests
     $httpClient = HttpClient::create([
-        // HTTP Basic authentication with only the username and not a password
+        // HTTP Basic authentication (there are multiple ways of configuring it)
         'auth_basic' => ['the-username'],
-
-        // HTTP Basic authentication with a username and a password
         'auth_basic' => ['the-username', 'the-password'],
+        'auth_basic' => 'the-username:the-password',
 
         // HTTP Bearer authentication (also called token authentication)
         'auth_bearer' => 'the-bearer-token',
+
+        // Microsoft NTLM authentication (there are multiple ways of configuring it)
+        'auth_ntlm' => ['the-username'],
+        'auth_ntlm' => ['the-username', 'the-password'],
+        'auth_ntlm' => 'the-username:the-password',
     ]);
 
     $response = $httpClient->request('GET', 'https://...', [
@@ -143,6 +147,14 @@ each request (which overrides any global authentication)::
         // ...
     ]);
 
+.. note::
+
+    The NTLM authentication mechanism requires using the cURL transport.
+
+.. versionadded:: 4.4
+
+    The ``auth_ntlm`` option was introduced in Symfony 4.4.
+
 Query String Parameters
 ~~~~~~~~~~~~~~~~~~~~~~~
 

components/property_info.rst

@@ -351,8 +351,9 @@ ReflectionExtractor
 
 Using PHP reflection, the :class:`Symfony\\Component\\PropertyInfo\\Extractor\\ReflectionExtractor`
 provides list, type and access information from setter and accessor methods.
-It can also give the type of a property, and if it is initializable through the
-constructor. It supports return and scalar types for PHP 7::
+It can also give the type of a property (even extracting it from the constructor
+arguments), and if it is initializable through the constructor. It supports
+return and scalar types for PHP 7::
 
     use Symfony\Component\PropertyInfo\Extractor\ReflectionExtractor;
 
@@ -371,6 +372,11 @@ constructor. It supports return and scalar types for PHP 7::
     // Initializable information
     $reflectionExtractor->isInitializable($class, $property);
 
+.. versionadded:: 4.1
+
+    The feature to extract the property types from constructor arguments was
+    introduced in Symfony 4.1.
+
 .. note::
 
     When using the Symfony framework, this service is automatically registered

reference/configuration/framework.rst

@@ -116,6 +116,7 @@ Configuration
     * `scope`_
     * `auth_basic`_
     * `auth_bearer`_
+    * `auth_ntlm`_
     * `base_uri`_
     * `bindto`_
     * `cafile`_
@@ -726,6 +727,20 @@ auth_bearer
 The token used to create the ``Authorization`` HTTP header used in HTTP Bearer
 authentication (also called token authentication).
 
+auth_ntlm
+.........
+
+**type**: ``string``
+
+.. versionadded:: 4.3
+
+    The ``auth_ntlm`` option was introduced in Symfony 4.4.
+
+The username and password used to create the ``Authorization`` HTTP header used
+in the `Microsoft NTLM authentication protocol`_. The value of this option must
+follow the format ``username:password``. This authentication mechanism requires
+using the cURL-based transport.
+
 base_uri
 ........
 
@@ -2610,3 +2625,4 @@ to know their differences.
 .. _`default_socket_timeout`: https://php.net/manual/en/filesystem.configuration.php#ini.default-socket-timeout
 .. _`PEM formatted`: https://en.wikipedia.org/wiki/Privacy-Enhanced_Mail
 .. _`haveibeenpwned.com`: https://haveibeenpwned.com/
+.. _`Microsoft NTLM authentication protocol`: https://docs.microsoft.com/en-us/windows/desktop/secauthn/microsoft-ntlm

translation.rst

@@ -59,8 +59,8 @@ Configuration
 -------------
 
 The previous command creates an initial config file where you can define the
-default locale of the app and the :ref:`fallback locales <translation-fallback>`
-that will be used if Symfony can't find some translation:
+default locale of the application and the directory where the translation files
+are located:
 
 .. configuration-block::
 
@@ -70,8 +70,7 @@ that will be used if Symfony can't find some translation:
         framework:
             default_locale: 'en'
             translator:
-                fallbacks: ['en']
-                # ...
+                default_path: '%kernel.project_dir%/translations'
 
     .. code-block:: xml
 
@@ -87,7 +86,7 @@ that will be used if Symfony can't find some translation:
 
             <framework:config default-locale="en">
                 <framework:translator>
-                    <framework:fallback>en</framework:fallback>
+                    <framework:default-path>'%kernel.project_dir%/translations'</framework:default-path>
                     <!-- ... -->
                 </framework:translator>
             </framework:config>
@@ -98,7 +97,7 @@ that will be used if Symfony can't find some translation:
         // config/packages/translation.php
         $container->loadFromExtension('framework', [
             'default_locale' => 'en',
-            'translator' => ['fallbacks' => ['en']],
+            'translator' => ['default_path' => '%kernel.project_dir%/translations'],
             // ...
         ]);
 
@@ -379,8 +378,52 @@ checks translation resources for several locales:
 #. If it wasn't found, Symfony looks for the translation in a ``fr`` translation
    resource (e.g. ``messages.fr.xlf``);
 
-#. If the translation still isn't found, Symfony uses the ``fallbacks`` configuration
-   parameter, which defaults to ``en`` (see `Configuration`_).
+#. If the translation still isn't found, Symfony uses the ``fallbacks`` option,
+   which can be configured as follows:
+
+.. configuration-block::
+
+    .. code-block:: yaml
+
+        # config/packages/translation.yaml
+        framework:
+            translator:
+                fallbacks: ['en']
+                # ...
+
+    .. code-block:: xml
+
+        <!-- config/packages/translation.xml -->
+        <?xml version="1.0" encoding="UTF-8" ?>
+        <container xmlns="http://symfony.com/schema/dic/services"
+            xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+            xmlns:framework="http://symfony.com/schema/dic/symfony"
+            xsi:schemaLocation="http://symfony.com/schema/dic/services
+                https://symfony.com/schema/dic/services/services-1.0.xsd
+                http://symfony.com/schema/dic/symfony
+                https://symfony.com/schema/dic/symfony/symfony-1.0.xsd">
+
+            <framework:config>
+                <framework:translator>
+                    <framework:fallback>en</framework:fallback>
+                    <!-- ... -->
+                </framework:translator>
+            </framework:config>
+        </container>
+
+    .. code-block:: php
+
+        // config/packages/translation.php
+        $container->loadFromExtension('framework', [
+            'translator' => ['fallbacks' => ['en']],
+            // ...
+        ]);
+
+.. deprecated:: 4.4
+
+    In Symfony versions before 4.4, the ``fallbacks`` option was initialized to
+    ``en`` (English) when not configured explicitly. Starting from Symfony 4.4,
+    this option is initialized to the same value as the ``default_locale`` option.
 
 .. note::