Add note about ExceptionHandler in CLI

852b4fc2 · Haralan Dobrev · Fabien Potencier · bc50a7e6 · 852b4fc2
Commit 852b4fc2 authored Mar 22, 2018 by Haralan Dobrev Committed by Fabien Potencier Apr 02, 2018
Show whitespace changes
Inline Side-by-side

Showing with 12 additions and 0 deletions

doc/cookbook/error_handler.rst doc/cookbook/error_handler.rst +12 -0

No files found.
--- a/doc/cookbook/error_handler.rst
+++ b/doc/cookbook/error_handler.rst
@@ -36,3 +36,15 @@ the ``$debug`` argument::
    use Symfony\Component\Debug\ExceptionHandler;

    ExceptionHandler::register(false);
+
+.. note::
+
+    Important caveat when using Silex on a command-line interface:
+    The ``ExceptionHandler`` should not be enabled as it would convert an error
+    to HTML output and return a non-zero exit code::
+
+        use Symfony\Component\Debug\ExceptionHandler;
+
+        if (!in_array(PHP_SAPI, ['cli', 'phpdbg'])) {
+            ExceptionHandler::register();
+        }