From c2b56fe6194eae5fbefd6a678fb4e7d8eca2f65a Mon Sep 17 00:00:00 2001
From: Alexandre Daubois <alex.daubois@gmail.com>
Date: Sat, 4 Mar 2023 08:09:56 +0100
Subject: [PATCH] [Console] Add support for managing exit code while handling
 signals

---
 components/console/events.rst | 30 +++++++++++++++++++++++++++++-
 1 file changed, 29 insertions(+), 1 deletion(-)

diff --git a/components/console/events.rst b/components/console/events.rst
index 87b44f56407..d08374d90f2 100644
--- a/components/console/events.rst
+++ b/components/console/events.rst
@@ -178,11 +178,31 @@ Listeners receive a
         // gets the signal number
         $signal = $event->getHandlingSignal();
 
+        // sets the exit code
+        $event->setExitCode(0);
+
         if (\SIGINT === $signal) {
             echo "bye bye!";
         }
     });
 
+It is also possible to abort the exit if you want the command to continue its
+execution even after the event has been dispatched, thanks to the
+:method:`Symfony\\Component\\Console\\Event\\ConsoleSignalEvent::abortExit`
+method::
+
+    use Symfony\Component\Console\ConsoleEvents;
+    use Symfony\Component\Console\Event\ConsoleSignalEvent;
+
+    $dispatcher->addListener(ConsoleEvents::SIGNAL, function (ConsoleSignalEvent $event) {
+        $event->abortExit();
+    });
+
+.. versionadded:: 6.3
+
+    The ``setExitCode()``, ``getExitCode()`` and ``abortExit()`` methods were introduced
+    in Symfony 6.3.
+
 .. tip::
 
     All the available signals (``SIGINT``, ``SIGQUIT``, etc.) are defined as
@@ -208,13 +228,17 @@ handle signals themselves. To do so, implement the
             return [\SIGINT, \SIGTERM];
         }
 
-        public function handleSignal(int $signal): void
+        public function handleSignal(int $signal): int|false
         {
             if (\SIGINT === $signal) {
                 // ...
             }
 
             // ...
+
+            // return an integer to set the exit code, or
+            // false to continue normal execution
+            return 0;
         }
     }
 
@@ -228,6 +252,10 @@ handle all signals e.g. to do some tasks before terminating the command.
     ``SIGUSR2``) would terminate the script by calling ``exit(0)``. Starting
     from Symfony 6.3, no more signal is automatically calling ``exit(0)``.
 
+.. deprecated:: 6.3
+
+    Not returning a value in ``handleSignal()`` is deprecated since Symfony 6.3.
+
 .. _`reserved exit codes`: https://www.tldp.org/LDP/abs/html/exitcodes.html
 .. _`Signals`: https://en.wikipedia.org/wiki/Signal_(IPC)
 .. _`constants of the PCNTL PHP extension`: https://www.php.net/manual/en/pcntl.constants.php