Merge branch '2.3' into 2.6

Author: xabbuh

components/console/introduction.rst

@@ -140,6 +140,9 @@ output. For example::
     // white text on a red background
     $output->writeln('<error>foo</error>');
 
+The closing tag can be replaced by ``</>``, which revokes all formatting options
+established by the last opened tag.
+
 It is possible to define your own styles using the class
 :class:`Symfony\\Component\\Console\\Formatter\\OutputFormatterStyle`::
 
@@ -148,23 +151,27 @@ It is possible to define your own styles using the class
     // ...
     $style = new OutputFormatterStyle('red', 'yellow', array('bold', 'blink'));
     $output->getFormatter()->setStyle('fire', $style);
-    $output->writeln('<fire>foo</fire>');
+    $output->writeln('<fire>foo</>');
 
 Available foreground and background colors are: ``black``, ``red``, ``green``,
 ``yellow``, ``blue``, ``magenta``, ``cyan`` and ``white``.
 
-And available options are: ``bold``, ``underscore``, ``blink``, ``reverse`` and ``conceal``.
+And available options are: ``bold``, ``underscore``, ``blink``, ``reverse``
+(enables the "reverse video" mode where the background and foreground colors
+are swapped) and ``conceal`` (sets the foreground color to transparent, making
+the typed text invisible - although it can be selected and copied; this option is
+commonly used when asking the user to type sensitive information).
 
 You can also set these colors and options inside the tagname::
 
     // green text
-    $output->writeln('<fg=green>foo</fg=green>');
+    $output->writeln('<fg=green>foo</>');
 
     // black text on a cyan background
-    $output->writeln('<fg=black;bg=cyan>foo</fg=black;bg=cyan>');
+    $output->writeln('<fg=black;bg=cyan>foo</>');
 
     // bold text on a yellow background
-    $output->writeln('<bg=yellow;options=bold>foo</bg=yellow;options=bold>');
+    $output->writeln('<bg=yellow;options=bold>foo</>');
 
 .. _verbosity-levels:
 
@@ -296,15 +303,15 @@ You can access the ``names`` argument as an array::
         $text .= ' '.implode(', ', $names);
     }
 
-There are 3 argument variants you can use:
+There are three argument variants you can use:
 
-===========================  ===============================================================================================================
+===========================  ===========================================================================================================
 Mode                         Value
-===========================  ===============================================================================================================
-InputArgument::REQUIRED      The argument is required
-InputArgument::OPTIONAL      The argument is optional and therefore can be omitted
-InputArgument::IS_ARRAY      The argument can contain an indefinite number of arguments and must be used at the end of the argument list
-===========================  ===============================================================================================================
+===========================  ===========================================================================================================
+``InputArgument::REQUIRED``  The argument is required
+``InputArgument::OPTIONAL``  The argument is optional and therefore can be omitted
+``InputArgument::IS_ARRAY``  The argument can contain an indefinite number of arguments and must be used at the end of the argument list
+===========================  ===========================================================================================================
 
 You can combine ``IS_ARRAY`` with ``REQUIRED`` and ``OPTIONAL`` like this::
 
@@ -377,14 +384,14 @@ will work:
 
 There are 4 option variants you can use:
 
-===========================  =====================================================================================
-Option                       Value
-===========================  =====================================================================================
-InputOption::VALUE_IS_ARRAY  This option accepts multiple values (e.g. ``--dir=/foo --dir=/bar``)
-InputOption::VALUE_NONE      Do not accept input for this option (e.g. ``--yell``)
-InputOption::VALUE_REQUIRED  This value is required (e.g. ``--iterations=5``), the option itself is still optional
-InputOption::VALUE_OPTIONAL  This option may or may not have a value (e.g. ``--yell`` or ``--yell=loud``)
-===========================  =====================================================================================
+===============================  =====================================================================================
+Option                           Value
+===============================  =====================================================================================
+``InputOption::VALUE_IS_ARRAY``  This option accepts multiple values (e.g. ``--dir=/foo --dir=/bar``)
+``InputOption::VALUE_NONE``      Do not accept input for this option (e.g. ``--yell``)
+``InputOption::VALUE_REQUIRED``  This value is required (e.g. ``--iterations=5``), the option itself is still optional
+``InputOption::VALUE_OPTIONAL``  This option may or may not have a value (e.g. ``--yell`` or ``--yell=loud``)
+===============================  =====================================================================================
 
 You can combine ``VALUE_IS_ARRAY`` with ``VALUE_REQUIRED`` or ``VALUE_OPTIONAL`` like this:
 

cookbook/configuration/web_server_configuration.rst

@@ -269,15 +269,13 @@ The **minimum configuration** to get your application running under Nginx is:
             fastcgi_split_path_info ^(.+\.php)(/.*)$;
             include fastcgi_params;
             fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
-            fastcgi_param HTTPS off;
         }
         # PROD
         location ~ ^/app\.php(/|$) {
             fastcgi_pass unix:/var/run/php5-fpm.sock;
             fastcgi_split_path_info ^(.+\.php)(/.*)$;
             include fastcgi_params;
             fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
-            fastcgi_param HTTPS off;
             # Prevents URIs that include the front controller. This will 404:
             # http://domain.tld/app.php/some-path
             # Remove the internal directive to allow URIs like this

cookbook/index.rst

@@ -28,6 +28,7 @@ The Cookbook
     serializer
     service_container/index
     session/index
+    psr7
     symfony1
     templating/index
     testing/index

cookbook/map.rst.inc

@@ -205,6 +205,10 @@
   * (configuration) :doc:`/cookbook/configuration/mongodb_session_storage`
   * :doc:`/cookbook/session/avoid_session_start`
 
+* **PSR-7**
+
+  * :doc:`/cookbook/psr7`
+
 * **symfony1**
 
   * :doc:`/cookbook/symfony1`

cookbook/psr7.rst

@@ -0,0 +1,89 @@
+.. index::
+   single: PSR-7
+
+The PSR-7 Bridge
+================
+
+    The PSR-7 bridge converts :doc:`HttpFoundation </components/http_foundation/index>`
+    objects from and to objects implementing HTTP message interfaces defined
+    by the `PSR-7`_.
+
+Installation
+------------
+
+You can install the component in 2 different ways:
+
+* :doc:`Install it via Composer </components/using_components>` (``symfony/psr-http-message-bridge`` on `Packagist`_);
+* Use the official Git repository (https://github.com/symfony/psr-http-message-bridge).
+
+The bridge also needs a PSR-7 implementation to allow converting HttpFoundation
+objects to PSR-7 objects. It provides native support for `Zend Diactoros`_.
+Use Composer (``zendframework/zend-diactoros`` on `Packagist`_) or refer to
+the project documentation to install it.
+
+Usage
+-----
+
+Converting from HttpFoundation Objects to PSR-7
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The bridge provides an interface of a factory called
+:class:`Symfony\\Bridge\\PsrHttpMessage\\HttpMessageFactoryInterface`
+that builds objects implementing PSR-7 interfaces from HttpFoundation objects.
+It also provide a default implementation using Zend Diactoros internally.
+
+The following code snippet explain how to convert a :class:`Symfony\\Component\\HttpFoundation\\Request`
+to a Zend Diactoros :class:`Zend\\Diactoros\\ServerRequest` implementing the
+:class:`Psr\\Http\\Message\\ServerRequestInterface` interface::
+
+    use Symfony\Bridge\PsrHttpMessage\Factory\DiactorosFactory;
+    use Symfony\Component\HttpFoundation\Request;
+
+    $symfonyRequest = new Request(array(), array(), array(), array(), array(), array('HTTP_HOST' => 'dunglas.fr'), 'Content');
+    // The HTTP_HOST server key must be set to avoid an unexpected error
+
+    $psr7Factory = new DiactorosFactory();
+    $psrRequest = $psr7Factory->createRequest($symfonyRequest);
+
+And now from a :class:`Symfony\\Component\\HttpFoundation\\Response` to a Zend
+Diactoros :class:`Zend\\Diactoros\\Response` implementing the :class:`Psr\\Http\\Message\\ResponseInterface`
+interface::
+
+    use Symfony\Bridge\PsrHttpMessage\Factory\DiactorosFactory;
+    use Symfony\Component\HttpFoundation\Response;
+
+    $symfonyResponse = new Response('Content');
+
+    $psr7Factory = new DiactorosFactory();
+    $psrResponse = $psr7Factory->createResponse($symfonyResponse);
+
+Converting Objects implementing PSR-7 Interfaces to HttpFoundation
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+On the other hand, the bridge provide a factory interface called
+:class:`Symfony\\Bridge\\PsrHttpMessage\\HttpFoundationFactoryInterface`
+that builds HttpFoundation objects from objects implementing PSR-7 interfaces.
+
+The next snippet explain how to convert an object implementing the :class:`Psr\\Http\\Message\\ServerRequestInterface`
+interface to a :class:`Symfony\\Component\\HttpFoundation\\Request` instance::
+
+    use Symfony\Bridge\PsrHttpMessage\Factory\HttpFoundationFactory;
+
+    // $psrRequest is an instance of Psr\Http\Message\ServerRequestInterface
+
+    $httpFoundationFactory = new HttpFoundationFactory();
+    $symfonyRequest = $httpFoundationFactory->createRequest($psrRequest);
+
+From an object implementing the :class:`Psr\\Http\\Message\\ResponseInterface`
+to a :class:`Symfony\\Component\\HttpFoundation\\Response` instance::
+
+    use Symfony\Bridge\PsrHttpMessage\Factory\HttpFoundationFactory;
+
+    // $psrResponse is an instance of Psr\Http\Message\ResponseInterface
+
+    $httpFoundationFactory = new HttpFoundationFactory();
+    $symfonyResponse = $httpFoundationFactory->createResponse($psrResponse);
+
+.. _`PSR-7`: http://www.php-fig.org/psr/psr-7/
+.. _Packagist: https://packagist.org/packages/symfony/psr-http-message-bridge
+.. _`Zend Diactoros`: https://github.com/zendframework/zend-diactoros

create_framework/front-controller.rst

@@ -146,11 +146,13 @@ web root directory:
 
     example.com
     ├── composer.json
-    │   src
+    ├── composer.lock    
+    ├── src
     │   └── pages
     │       ├── hello.php
     │       └── bye.php
     ├── vendor
+    │   └── autoload.php
     └── web
         └── front.php