From cd0079fb5dcc8edc75e70322d22e58824b7783a2 Mon Sep 17 00:00:00 2001
From: Jan Nedbal <janedbal@gmail.com>
Date: Fri, 12 Sep 2025 12:10:06 +0200
Subject: [PATCH 1/2] [Console] Document timeout functionality for
 QuestionHelper

This adds documentation for the setTimeout() method that was added to
the Question class in Symfony 7.4. The timeout feature allows setting
a maximum time limit for user input to prevent hanging indefinitely
in interactive questions, particularly useful in database transactions
or other time-sensitive operations.

Closes #21366
---
 components/console/helpers/questionhelper.rst | 57 +++++++++++++++++++
 1 file changed, 57 insertions(+)

diff --git a/components/console/helpers/questionhelper.rst b/components/console/helpers/questionhelper.rst
index a0126ee5a71..ec4dae45f54 100644
--- a/components/console/helpers/questionhelper.rst
+++ b/components/console/helpers/questionhelper.rst
@@ -324,6 +324,63 @@ the response to a question should allow multiline answers by passing ``true`` to
 Multiline questions stop reading user input after receiving an end-of-transmission
 control character (``Ctrl-D`` on Unix systems or ``Ctrl-Z`` on Windows).
 
+Setting a Timeout for User Input
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. versionadded:: 7.4
+
+    The timeout functionality for questions was introduced in Symfony 7.4.
+
+You can set a maximum time limit for user input by using the
+:method:`Symfony\\Component\\Console\\Question\\Question::setTimeout` method.
+If the user doesn't respond within the specified timeout, a
+:class:`Symfony\\Component\\Console\\Exception\\MissingInputException` will be thrown::
+
+    use Symfony\Component\Console\Exception\MissingInputException;
+    use Symfony\Component\Console\Question\Question;
+
+    // ...
+    public function __invoke(InputInterface $input, OutputInterface $output): int
+    {
+        // ...
+        $helper = new QuestionHelper();
+
+        $question = new Question('Please enter your answer');
+        $question->setTimeout(30); // 30 seconds timeout
+
+        try {
+            $answer = $helper->ask($input, $output, $question);
+            // ... do something with the answer
+        } catch (MissingInputException $exception) {
+            $output->writeln('No input received within timeout period.');
+            // ... handle timeout
+        }
+
+        return Command::SUCCESS;
+    }
+
+This is particularly useful when you have interactive questions inside database
+transactions or other time-sensitive operations where hanging indefinitely
+could cause problems.
+
+.. note::
+
+    The timeout only applies to interactive input streams. For non-interactive
+    streams (like pipes or files), the timeout setting is ignored and the
+    question behaves normally.
+
+You can also use timeouts with other question types such as 
+:class:`Symfony\\Component\\Console\\Question\\ConfirmationQuestion` and
+:class:`Symfony\\Component\\Console\\Question\\ChoiceQuestion`::
+
+    use Symfony\Component\Console\Question\ConfirmationQuestion;
+
+    // ...
+    $question = new ConfirmationQuestion('Do you want to continue?', false);
+    $question->setTimeout(10); // 10 seconds timeout
+
+    $continue = $helper->ask($input, $output, $question);
+
 Hiding the User's Response
 ~~~~~~~~~~~~~~~~~~~~~~~~~~
 

From b6a3f86afecd4292e016a5bb41a1b3d3f6cee316 Mon Sep 17 00:00:00 2001
From: Jan Nedbal <janedbal@gmail.com>
Date: Fri, 12 Sep 2025 12:15:41 +0200
Subject: [PATCH 2/2] Fix RST formatting issues

- Fix title underline length to match exactly 33 characters
- Remove trailing whitespace from line 372
---
 components/console/helpers/questionhelper.rst | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/components/console/helpers/questionhelper.rst b/components/console/helpers/questionhelper.rst
index ec4dae45f54..e576258d722 100644
--- a/components/console/helpers/questionhelper.rst
+++ b/components/console/helpers/questionhelper.rst
@@ -325,7 +325,7 @@ Multiline questions stop reading user input after receiving an end-of-transmissi
 control character (``Ctrl-D`` on Unix systems or ``Ctrl-Z`` on Windows).
 
 Setting a Timeout for User Input
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 .. versionadded:: 7.4
 
@@ -369,7 +369,7 @@ could cause problems.
     streams (like pipes or files), the timeout setting is ignored and the
     question behaves normally.
 
-You can also use timeouts with other question types such as 
+You can also use timeouts with other question types such as
 :class:`Symfony\\Component\\Console\\Question\\ConfirmationQuestion` and
 :class:`Symfony\\Component\\Console\\Question\\ChoiceQuestion`::