Merge branch '5.4' into 6.0

* 5.4:
  Removed an unnecessary tip
  [Form] Additional hints when rendering the same form in different templates
  Note that file_put_contents is non-atomic

Author: javiereguiluz

components/dependency_injection/compilation.rst

@@ -468,6 +468,14 @@ serves at dumping the compiled container::
         file_put_contents($file, $dumper->dump());
     }
 
+.. tip::
+
+    The ``file_put_contents()`` function is not atomic. That could cause issues
+    in a production environment with multiple concurrent requests. Instead, use
+    the :ref:`dumpFile() method <filesystem-dumpfile>` from Symfony Filesystem
+    component or other methods provided by Symfony (e.g. ``$containerConfigCache->write()``)
+    which are atomic.
+    
 ``ProjectServiceContainer`` is the default name given to the dumped container
 class. However, you can change this with the ``class`` option when you
 dump it::

components/filesystem.rst

@@ -287,6 +287,8 @@ exception on failure::
     // returns a path like : /tmp/prefix_wyjgtF.png
     $filesystem->tempnam('/tmp', 'prefix_', '.png');
 
+.. _filesystem-dumpfile:
+
 ``dumpFile``
 ~~~~~~~~~~~~
 

forms.rst

@@ -442,16 +442,6 @@ possible paths:
     data is passed to it, you can
     :doc:`use the submit() method to handle form submissions </form/direct_submit>`.
 
-.. tip::
-
-    If you need to render and process the same form in different templates,
-    use the ``render()`` function to :ref:`embed the controller <templates-embed-controllers>`
-    that processes the form:
-
-    .. code-block:: twig
-
-        {{ render(controller('App\\Controller\\TaskController::new')) }}
-
 .. _validating-forms:
 
 Validating Forms