outline implications of the kernel.terminate event

xabbuh · xabbuh · commit 11fe34032e9f · 2014-09-13T13:23:18.000+02:00
diff --git a/components/http_kernel/introduction.rst b/components/http_kernel/introduction.rst
@@ -472,6 +472,14 @@ you will trigger the ``kernel.terminate`` event where you can perform certain
 actions that you may have delayed in order to return the response as quickly
 as possible to the client (e.g. sending emails).
 
+.. caution::
+
+    You should use the ``kernel.terminate`` event with `PHP FPM`_ only. It
+    is the only server API which is able to finish a PHP process on the server
+    after the response has been sent to the client. With all other server
+    APIs, executing the listeners to the ``kernel.terminate`` event will block
+    the connection.
+
 .. note::
 
     Using the ``kernel.terminate`` event is optional, and should only be
@@ -689,3 +697,4 @@ look like this::
 .. _reflection: http://php.net/manual/en/book.reflection.php
 .. _FOSRestBundle: https://github.com/friendsofsymfony/FOSRestBundle
 .. _`Create your own framework... on top of the Symfony2 Components`: http://fabien.potencier.org/article/50/create-your-own-framework-on-top-of-the-symfony2-components-part-1
+.. _`PHP FPM`: http://php.net/manual/en/install.fpm.php
