Merge pull request #13468 from TimWerdin/minor/add-documentation-about-php-fpm

fabpot · web-flow · commit 32af5a3d0385 · 2020-04-03T09:04:11.000+02:00
Adds block about PHP-FPM behaviour
diff --git a/setup/symfony_server.rst b/setup/symfony_server.rst
@@ -57,6 +57,24 @@ run the Symfony server in the background:
     # show the latest log messages
     $ symfony server:log
 
+Enabling PHP-FPM
+----------------
+
+When the server starts it will check for common patterns like ``web/app.php``,
+``web/app_dev.php`` or ``public/index.php``. If a file like this is found the
+server will automatically start with PHP-FPM enabled. Otherwise the server will
+start without PHP-FPM and will show a ``Page not found`` page when trying to 
+access a ``.php`` file in the browser.
+
+.. tip::
+
+    When an ``index.html`` and a front controller like e.g. ``index.php`` are
+    both present the server will still start with PHP-FPM enabled but the 
+    ``index.html`` will take precedence over the front controller. This means
+    when an ``index.html`` file is present in ``public`` or ``web``, it will be
+    displayed instead of the ``index.php`` which would show e.g. the Symfony
+    application.
+
 Enabling TLS
 ------------
 
