Add daysOfMonth() method to schedule tasks on specific days (#57817)

- Allows scheduling tasks to run on multiple specific days of the month
- Supports both array and variadic syntax: daysOfMonth(1, 15) or daysOfMonth([1, 15])
- Useful for tasks that need to run on specific dates (payroll, reports, etc.)
- Add comprehensive tests

Author: yousefkadah

src/Illuminate/Console/Scheduling/ManagesFrequencies.php

@@ -568,6 +568,21 @@ public function lastDayOfMonth($time = '0:0')
         return $this->spliceIntoPosition(3, Carbon::now()->endOfMonth()->day);
     }
 
+    /**
+     * Schedule the event to run on specific days of the month.
+     *
+     * @param  array<int<1, 31>>|int<1, 31>  ...$days
+     * @return $this
+     */
+    public function daysOfMonth(...$days)
+    {
+        $days = count($days) === 1 && is_array($days[0]) ? $days[0] : $days;
+
+        $this->dailyAt('0:0');
+
+        return $this->spliceIntoPosition(3, implode(',', $days));
+    }
+
     /**
      * Schedule the event to run quarterly.
      *

tests/Console/Scheduling/EventTest.php

@@ -104,4 +104,16 @@ public function testCustomMutexName()
 
         $this->assertSame('fancy-command-description', $event->mutexName());
     }
+
+    public function testDaysOfMonthMethod()
+    {
+        $event = new Event(m::mock(EventMutex::class), 'php -i');
+
+        $event->daysOfMonth(1, 15);
+        $this->assertSame('0 0 1,15 * *', $event->getExpression());
+
+        $event = new Event(m::mock(EventMutex::class), 'php -i');
+        $event->daysOfMonth([1, 10, 20, 30]);
+        $this->assertSame('0 0 1,10,20,30 * *', $event->getExpression());
+    }
 }