[12.x] Allow `down` command --retry option to accept datetime values

Merged
AL
9mo ago
+80-4

This PR enhances the down command's --retry option to accept datetime strings in addition to numeric seconds.

Changes

The --retry option now supports:

  • Numeric seconds (existing behavior): --retry=60
  • Datetime strings (new): --retry="2025-12-31 15:30:00", --retry="tomorrow 14:00", --retry="+2 hours"
  • Unix timestamps: --retry="@1735660200" (the @ prefix is PHP's standard notation for Unix timestamps)

When a datetime is provided, it is converted to the RFC 7231 HTTP-date format as specified for the Retry-After header.

A warning is displayed when a past datetime is provided.

Reference