Skip to content

Conversation

amirhshokri
Copy link
Contributor

@amirhshokri amirhshokri commented Aug 24, 2025

Why?

While we generally avoid documenting all options for every command, the --hours behavior for queue:flush is different from --hours in queue:prune-failed, which could easily confuse developers.

  • queue:flush --hours=N deletes jobs at or before N hours ago.
  • queue:prune-failed --hours=N deletes jobs older than N hours.

Because of this subtle difference, it is important to clarify it in the docs to prevent unexpected deletions.

Changes

  • Added a short section to the queue:flush command documentation highlighting that --hours exists and explaining its inclusive behavior.
  • Included an example for clarity.

@taylorotwell taylorotwell merged commit 7e6f476 into laravel:12.x Aug 25, 2025
@amirhshokri amirhshokri deleted the 12.x-improve-queue-flush-docs branch August 25, 2025 16:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants