Auto-cap task timeout to defaultRequeueTimeout.

Instead of warning when a task timeout exceeds the requeue timeout,
automatically cap it to prevent duplicate execution.

Author: dereuromark

docs/sections/configuration.md

@@ -23,7 +23,7 @@ You may create a file called `app_queue.php` inside your `config` folder (NOT th
     // Legacy: 'defaultworkertimeout' is deprecated but still supported
     ```
 
-  **Important:** Individual task `timeout` property values should NOT exceed this `defaultRequeueTimeout` value. If a task has a timeout longer than the global requeue timeout, the job will be requeued before the task completes, causing duplicate execution. Always ensure `defaultRequeueTimeout` is greater than your longest task timeout (recommended: at least 2x the longest task timeout).
+  **Note:** Individual task `timeout` values are automatically capped to this `defaultRequeueTimeout` value to prevent duplicate execution. If a task needs a longer timeout, increase `defaultRequeueTimeout` accordingly (recommended: at least 2x your longest task timeout).
 
 - Default number of retries if a job fails or times out:
 

docs/sections/custom_tasks.md

@@ -27,7 +27,7 @@ class YourNameForItTask extends Task {
 
     /**
      * Timeout in seconds for this specific task.
-     * Should NOT exceed defaultRequeueTimeout to prevent the job being requeued while still running.
+     * Automatically capped to defaultRequeueTimeout if higher.
      *
      * @var ?int
      */

src/Queue/Config.php

@@ -142,21 +142,9 @@ public static function taskConfig(array $tasks): array {
 
 			$taskTimeout = $taskConfig['timeout'] ?? $taskObject->timeout ?? $defaultTimeout;
 
-			// Warn if task timeout is greater than the requeue timeout, which can cause premature requeuing
+			// Auto-cap task timeout to defaultRequeueTimeout to prevent duplicate execution
 			if ($taskTimeout > $defaultTimeout) {
-				trigger_error(
-					sprintf(
-						'Task "%s" has timeout (%d seconds) larger than defaultRequeueTimeout (%d seconds). '
-						. 'The job will be requeued after %d seconds even though the task expects to run for %d seconds. '
-						. 'This can cause duplicate execution. Consider increasing defaultRequeueTimeout or decreasing the task timeout.',
-						$task,
-						$taskTimeout,
-						$defaultTimeout,
-						$defaultTimeout,
-						$taskTimeout,
-					),
-					E_USER_WARNING,
-				);
+				$taskTimeout = $defaultTimeout;
 			}
 
 			$config[$task]['class'] = $className;