Merge branch '4.1'

* 4.1:
  Fixed Encore dir paths
  Change the public folder to web for 3.4
  Updated KnpUniversity links to SymfonyCasts
  correct a typo in a namespace loading
  There is no public folder in 3.4
  Fixed the link to Functional Tests
  Update templating.rst
  Update doctrine.rst
  Shorten Twig ternary expression
  [Serializer] Cache the normalizer to use when possible

Author: javiereguiluz

bundles/extension.rst

@@ -32,8 +32,8 @@ This is how the extension of an AcmeHelloBundle should look like::
     // src/Acme/HelloBundle/DependencyInjection/AcmeHelloExtension.php
     namespace Acme\HelloBundle\DependencyInjection;
 
-    use Symfony\Component\HttpKernel\DependencyInjection\Extension;
     use Symfony\Component\DependencyInjection\ContainerBuilder;
+    use Symfony\Component\DependencyInjection\Extension\Extension;
 
     class AcmeHelloExtension extends Extension
     {

components/serializer.rst

@@ -1317,6 +1317,32 @@ can use this simpler configuration:
             </class>
         </serializer>
 
+Performance
+-----------
+
+To figure which normalizer (or denormalizer) must be used to handle an object,
+the :class:`Symfony\\Component\\Serializer\\Serializer` class will call the
+:method:`Symfony\\Component\\Serializer\\Normalizer\\NormalizerInterface::supportsNormalization`
+(or :method:`Symfony\\Component\\Serializer\\Normalizer\\DenormalizerInterface::supportsDenormalization`)
+of all registered normalizers (or denormalizers) in a loop.
+
+The result of these methods can vary depending on the object to serialize, the
+format and the context. That's why the result **is not cached** by default and
+can result in a significant performance bottleneck.
+
+However, most normalizers (and denormalizers) always return the same result when
+the object's type and the format are the same, so the result can be cached. To
+do so, make those normalizers (and denormalizers) implement the
+:class:`Symfony\\Component\\Serializer\\Normalizer\\CacheableSupportsMethodInterface`
+and return ``true`` when
+:method:`Symfony\\Component\\Serializer\\Normalizer\\CacheableSupportsMethodInterface::hasCacheableSupportsMethod`
+is called.
+
+ .. note::
+    
+    All built-in :ref:`normalizers and denormalizers <component-serializer-normalizers>`
+    as well the ones included in `API Platform`_ natively implement this interface.
+
 Learn more
 ----------
 
@@ -1326,6 +1352,11 @@ Learn more
 
     /serializer
 
+.. seealso::
+
+    Normalizers for the Symfony Serializer Component supporting popular web API formats
+    (JSON-LD, GraphQL, HAL and JSONAPI) are available as part of the `API Platform`_ project.
+
 .. seealso::
 
     A popular alternative to the Symfony Serializer Component is the third-party
@@ -1342,3 +1373,4 @@ Learn more
 .. _CSV: https://tools.ietf.org/html/rfc4180
 .. _`RFC 7807`: https://tools.ietf.org/html/rfc7807
 .. _`Value Objects`: https://en.wikipedia.org/wiki/Value_object
+.. _`API Platform`: https://api-platform.com

doctrine.rst

@@ -162,10 +162,11 @@ Woh! You now have a new ``src/Entity/Product.php`` file::
 
 .. caution::
 
-    MySQL sets a `limit of 767 bytes for the index key prefix`_. When using
-    ``utf8mb4``, string columns with 255 character length surpass that limit.
-    This means that any column of type ``string`` and ``unique=true`` must
-    set its maximum ``length`` to ``190``. Otherwise, you'll see this error:
+    There is a `limit of 767 bytes for the index key prefix`_ when using
+    InnoDB tables in MySQL 5.6 and earlier versions. String columns with 255
+    character length and ``utf8mb4`` encoding surpass that limit. This means
+    that any column of type ``string`` and ``unique=true`` must set its
+    maximum ``length`` to ``190``. Otherwise, you'll see this error:
     *"[PDOException] SQLSTATE[42000]: Syntax error or access violation:
     1071 Specified key was too long; max key length is 767 bytes"*.
 
@@ -756,4 +757,4 @@ Learn more
 .. _`SensioFrameworkExtraBundle`: http://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/index.html
 .. _`ParamConverter`: http://symfony.com/doc/current/bundles/SensioFrameworkExtraBundle/annotations/converters.html
 .. _`limit of 767 bytes for the index key prefix`: https://dev.mysql.com/doc/refman/5.6/en/innodb-restrictions.html
-.. _`Doctrine screencast series`: https://knpuniversity.com/screencast/symfony-doctrine
+.. _`Doctrine screencast series`: https://symfonycasts.com/screencast/symfony-doctrine

doctrine/associations.rst

@@ -594,4 +594,4 @@ Doctrine's `Association Mapping Documentation`_.
 
 .. _`Association Mapping Documentation`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/association-mapping.html
 .. _`orphanRemoval`: http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/working-with-associations.html#orphan-removal
-.. _`Mastering Doctrine Relations`: https://knpuniversity.com/screencast/doctrine-relations
+.. _`Mastering Doctrine Relations`: https://symfonycasts.com/screencast/doctrine-relations

forms.rst

@@ -719,4 +719,4 @@ Learn more
 
 .. _`Symfony Form component`: https://github.com/symfony/form
 .. _`DateTime`: https://php.net/manual/en/class.datetime.php
-.. _`Symfony Forms screencast series`: https://knpuniversity.com/screencast/symfony-forms
+.. _`Symfony Forms screencast series`: https://symfonycasts.com/screencast/symfony-forms

frontend.rst

@@ -106,4 +106,4 @@ Other Front-End Articles
 .. _`Mix`: https://laravel.com/docs/mix
 .. _`Symfony`: http://symfony.com/
 .. _`Full API`: https://github.com/symfony/webpack-encore/blob/master/index.js
-.. _`Webpack Encore screencast series`: https://knpuniversity.com/screencast/webpack-encore
+.. _`Webpack Encore screencast series`: https://symfonycasts.com/screencast/webpack-encore

frontend/encore/installation-no-flex.rst

@@ -17,7 +17,7 @@ Install Encore into your project via Yarn:
 
 .. note::
 
-    If you prefer to use `npm`_, no problem! Run ``npm install @symfony/webpack-encore --save-dev``. 
+    If you prefer to use `npm`_, no problem! Run ``npm install @symfony/webpack-encore --save-dev``.
 
 This command creates (or modifies) a ``package.json`` file and downloads dependencies
 into a ``node_modules/`` directory. Yarn also creates/updates a ``yarn.lock``
@@ -81,9 +81,9 @@ import some JavaScript:
 .. code-block:: javascript
 
     // assets/js/app.js
-    
+
     require('../css/app.css');
-    
+
     console.log('Hello Webpack Encore');
 
 And the new ``assets/css/app.css`` file:

frontend/encore/server-data.rst

@@ -35,7 +35,7 @@ method that returns an array, you could do the following:
 
 .. code-block:: twig
 
-    <div data-user-profile="{{ app.user ? app.user.profileData|json_encode|e('html_attr') : '' }}">
+    <div data-user-profile="{{ app.user ? app.user.profileData|json_encode|e('html_attr') }}">
         <!-- ... -->
     </div>
 

frontend/encore/simple-example.rst

@@ -158,8 +158,8 @@ To import values, use ``import``:
     // assets/js/app.js
     - var $ = require('jquery');
     + import $ from 'jquery';
-    
-    - require('../css/app.css');    
+
+    - require('../css/app.css');
     + import '../css/app.css';
 
 .. _multiple-javascript-entries:

page_creation.rst

@@ -196,8 +196,8 @@ One of Symfony's *killer* features is the Web Debug Toolbar: a bar that displays
 a *huge* amount of debugging information along the bottom of your page while developing. This is all
 included out of the box using a package called ``symfony/profiler-pack``.
 
-You will see a black bar along the bottom of the page. You'll learn more about all the information it holds 
-along the way, but feel free to experiment: hover over and click 
+You will see a black bar along the bottom of the page. You'll learn more about all the information it holds
+along the way, but feel free to experiment: hover over and click
 the different icons to get information about routing, performance, logging and more.
 
 Rendering a Template
@@ -342,5 +342,5 @@ Go Deeper with HTTP & Framework Fundamentals
 
 .. _`Twig`: https://twig.symfony.com
 .. _`Composer`: https://getcomposer.org
-.. _`Stellar Development with Symfony`: https://knpuniversity.com/screencast/symfony/setup
+.. _`Stellar Development with Symfony`: https://symfonycasts.com/screencast/symfony/setup
 .. _`Flex recipes`: https://flex.symfony.com