class PendingEventAttributes mixin Schedule

Traits

Constants

DEFERRED_EVENT_METHODS

Event lifecycle and output methods that should be deferred and replayed on each event in the group.

Properties

string $expression

The cron expression representing the event's frequency.

from  ManagesAttributes
int|null $repeatSeconds

How often to repeat the event during a minute.

from  ManagesAttributes
DateTimeZone|string|null $timezone

The timezone the date should be evaluated on.

from  ManagesAttributes
array $environments

The list of environments the command should run under.

from  ManagesAttributes
bool $evenInMaintenanceMode

Indicates if the command should run in maintenance mode.

from  ManagesAttributes
bool $evenWhenPaused

Indicates if the command should run even when the scheduler is paused.

from  ManagesAttributes
bool $withoutOverlapping

Indicates if the command should not overlap itself.

from  ManagesAttributes
bool $releaseOnTerminationSignals

Indicates if the mutex should be released when the process receives a termination signal.

from  ManagesAttributes
bool $onOneServer

Indicates if the command should only be allowed to run on one server for each cron expression.

from  ManagesAttributes
int $expiresAt

The number of minutes the mutex should be valid.

from  ManagesAttributes
bool $runInBackground

Indicates if the command should run in the background.

from  ManagesAttributes
protected array $filters

The array of filter callbacks.

from  ManagesAttributes
protected array $rejects

The array of reject callbacks.

from  ManagesAttributes
string|null $description

The human-readable description of the event.

from  ManagesAttributes
array $attributes

The arbitrary attributes stored with the event.

from  ManagesAttributes
protected array<int, array{string, array}> $macros

The recorded macro and deferred method calls to replay on each event.

Methods

environments(mixed $environments)

Limit the environments the command should run in.

evenInMaintenanceMode()

State that the command should run even in maintenance mode.

evenWhenPaused()

State that the command should run even when the scheduler is paused.

withoutOverlapping(int $expiresAt = 1440, bool $releaseOnTerminationSignals = true)

Do not allow the event to overlap each other.

onOneServer()

Allow the event to only run on one server for each cron expression.

runInBackground()

State that the command should run in the background.

when(bool|callable $callback)

Register a callback to further filter the schedule.

skip(bool|callable $callback)

Register a callback to further filter the schedule.

name(string $description)

Set the human-friendly description of the event.

description(string $description)

Set the human-friendly description of the event.

withAttributes(array $attributes)

Set arbitrary attributes to store with the event.

cron(string $expression)

The Cron expression representing the event's frequency.

between(string $startTime, string $endTime)

Schedule the event to run between start and end time.

unlessBetween(string $startTime, string $endTime)

Schedule the event to not run between start and end time.

everySecond()

Schedule the event to run every second.

everyTwoSeconds()

Schedule the event to run every two seconds.

everyFiveSeconds()

Schedule the event to run every five seconds.

everyTenSeconds()

Schedule the event to run every ten seconds.

everyFifteenSeconds()

Schedule the event to run every fifteen seconds.

everyTwentySeconds()

Schedule the event to run every twenty seconds.

everyThirtySeconds()

Schedule the event to run every thirty seconds.

repeatEvery(int $seconds)

Schedule the event to run multiple times per minute.

everyMinute()

Schedule the event to run every minute.

everyTwoMinutes()

Schedule the event to run every two minutes.

everyThreeMinutes()

Schedule the event to run every three minutes.

everyFourMinutes()

Schedule the event to run every four minutes.

everyFiveMinutes()

Schedule the event to run every five minutes.

everyTenMinutes()

Schedule the event to run every ten minutes.

everyFifteenMinutes()

Schedule the event to run every fifteen minutes.

everyThirtyMinutes()

Schedule the event to run every thirty minutes.

hourly()

Schedule the event to run hourly.

hourlyAt(array|int|string $offset)

Schedule the event to run hourly at a given offset in the hour.

everyOddHour(array|int|string $offset = 0)

Schedule the event to run every odd hour.

everyTwoHours(array|int|string $offset = 0)

Schedule the event to run every two hours.

everyThreeHours(array|int|string $offset = 0)

Schedule the event to run every three hours.

everyFourHours(array|int|string $offset = 0)

Schedule the event to run every four hours.

everySixHours(array|int|string $offset = 0)

Schedule the event to run every six hours.

daily()

Schedule the event to run daily.

at(string $time)

Schedule the command at a given time.

dailyAt(string $time)

Schedule the event to run daily at a given time (10:00, 19:30, etc).

twiceDaily(int $first = 1, int $second = 13)

Schedule the event to run twice daily.

twiceDailyAt(int $first = 1, int $second = 13, int $offset = 0)

Schedule the event to run twice daily at a given offset.

hourBasedSchedule(array|int|string $minutes, array|int|string $hours)

Schedule the event to run at the given minutes and hours.

weekdays()

Schedule the event to run only on weekdays.

weekends()

Schedule the event to run only on weekends.

mondays()

Schedule the event to run only on Mondays.

tuesdays()

Schedule the event to run only on Tuesdays.

wednesdays()

Schedule the event to run only on Wednesdays.

thursdays()

Schedule the event to run only on Thursdays.

fridays()

Schedule the event to run only on Fridays.

saturdays()

Schedule the event to run only on Saturdays.

sundays()

Schedule the event to run only on Sundays.

weekly()

Schedule the event to run weekly.

weeklyOn(mixed $dayOfWeek, string $time = '0:0')

Schedule the event to run weekly on a given day and time.

monthly()

Schedule the event to run monthly.

monthlyOn(int $dayOfMonth = 1, string $time = '0:0')

Schedule the event to run monthly on a given day and time.

twiceMonthly(int $first = 1, int $second = 16, string $time = '0:0')

Schedule the event to run twice monthly at a given time.

lastDayOfMonth(string $time = '0:0')

Schedule the event to run on the last day of the month.

daysOfMonth(int|array ...$days)

Schedule the event to run on specific days of the month.

quarterly()

Schedule the event to run quarterly.

quarterlyOn(int $dayOfQuarter = 1, string $time = '0:0')

Schedule the event to run quarterly on a given day and time.

yearly()

Schedule the event to run yearly.

yearlyOn(int $month = 1, int|string $dayOfMonth = 1, string $time = '0:0')

Schedule the event to run yearly on a given month, day, and time.

days(mixed $days)

Set the days of the week the command should run on.

timezone(DateTimeZone|UnitEnum|string $timezone)

Set the timezone the date should be evaluated on.

spliceIntoPosition(int $position, int|string $value)

Splice the given value into the given position of the expression.

__construct(Schedule $schedule)

Create a new pending event attributes instance.

void
mergeAttributes(Event $event)

Merge the current attributes into the given event.

mixed
__call(string $method, array $parameters)

Proxy missing methods onto the underlying schedule.

Details

in ManagesAttributes at line 92
ManagesAttributes environments(mixed $environments)

Limit the environments the command should run in.

Parameters

mixed $environments

Return Value

ManagesAttributes

in ManagesAttributes at line 102
ManagesAttributes evenInMaintenanceMode()

State that the command should run even in maintenance mode.

Return Value

ManagesAttributes

in ManagesAttributes at line 112
ManagesAttributes evenWhenPaused()

State that the command should run even when the scheduler is paused.

Return Value

ManagesAttributes

at line 64
PendingEventAttributes withoutOverlapping(int $expiresAt = 1440, bool $releaseOnTerminationSignals = true)

Do not allow the event to overlap each other.

The expiration time of the underlying cache lock may be specified in minutes.

Parameters

int $expiresAt
bool $releaseOnTerminationSignals

Return Value

PendingEventAttributes

in ManagesAttributes at line 140
ManagesAttributes onOneServer()

Allow the event to only run on one server for each cron expression.

Return Value

ManagesAttributes

in ManagesAttributes at line 150
ManagesAttributes runInBackground()

State that the command should run in the background.

Return Value

ManagesAttributes

in ManagesAttributes at line 160
ManagesAttributes when(bool|callable $callback)

Register a callback to further filter the schedule.

Parameters

bool|callable $callback

Return Value

ManagesAttributes

in ManagesAttributes at line 172
ManagesAttributes skip(bool|callable $callback)

Register a callback to further filter the schedule.

Parameters

bool|callable $callback

Return Value

ManagesAttributes

in ManagesAttributes at line 184
ManagesAttributes name(string $description)

Set the human-friendly description of the event.

Parameters

string $description

Return Value

ManagesAttributes

in ManagesAttributes at line 192
ManagesAttributes description(string $description)

Set the human-friendly description of the event.

Parameters

string $description

Return Value

ManagesAttributes

in ManagesAttributes at line 202
ManagesAttributes withAttributes(array $attributes)

Set arbitrary attributes to store with the event.

Parameters

array $attributes

Return Value

ManagesAttributes

in ManagesFrequencies at line 20
ManagesFrequencies cron(string $expression)

The Cron expression representing the event's frequency.

Parameters

string $expression

Return Value

ManagesFrequencies

in ManagesFrequencies at line 30
ManagesFrequencies between(string $startTime, string $endTime)

Schedule the event to run between start and end time.

Parameters

string $startTime
string $endTime

Return Value

ManagesFrequencies

in ManagesFrequencies at line 38
ManagesFrequencies unlessBetween(string $startTime, string $endTime)

Schedule the event to not run between start and end time.

Parameters

string $startTime
string $endTime

Return Value

ManagesFrequencies

in ManagesFrequencies at line 70
ManagesFrequencies everySecond()

Schedule the event to run every second.

Return Value

ManagesFrequencies

in ManagesFrequencies at line 78
ManagesFrequencies everyTwoSeconds()

Schedule the event to run every two seconds.

Return Value

ManagesFrequencies

in ManagesFrequencies at line 86
ManagesFrequencies everyFiveSeconds()

Schedule the event to run every five seconds.

Return Value

ManagesFrequencies

in ManagesFrequencies at line 94
ManagesFrequencies everyTenSeconds()

Schedule the event to run every ten seconds.

Return Value

ManagesFrequencies

in ManagesFrequencies at line 102
ManagesFrequencies everyFifteenSeconds()

Schedule the event to run every fifteen seconds.

Return Value

ManagesFrequencies

in ManagesFrequencies at line 110
ManagesFrequencies everyTwentySeconds()

Schedule the event to run every twenty seconds.

Return Value

ManagesFrequencies

in ManagesFrequencies at line 118
ManagesFrequencies everyThirtySeconds()

Schedule the event to run every thirty seconds.

Return Value

ManagesFrequencies

in ManagesFrequencies at line 130
protected ManagesFrequencies repeatEvery(int $seconds)

Schedule the event to run multiple times per minute.

Parameters

int $seconds

Return Value

ManagesFrequencies

Exceptions

InvalidArgumentException

in ManagesFrequencies at line 148
ManagesFrequencies everyMinute()

Schedule the event to run every minute.

Return Value

ManagesFrequencies

in ManagesFrequencies at line 156
ManagesFrequencies everyTwoMinutes()

Schedule the event to run every two minutes.

Return Value

ManagesFrequencies

in ManagesFrequencies at line 164
ManagesFrequencies everyThreeMinutes()

Schedule the event to run every three minutes.

Return Value

ManagesFrequencies

in ManagesFrequencies at line 172
ManagesFrequencies everyFourMinutes()

Schedule the event to run every four minutes.

Return Value

ManagesFrequencies

in ManagesFrequencies at line 180
ManagesFrequencies everyFiveMinutes()

Schedule the event to run every five minutes.

Return Value

ManagesFrequencies

in ManagesFrequencies at line 188
ManagesFrequencies everyTenMinutes()

Schedule the event to run every ten minutes.

Return Value

ManagesFrequencies

in ManagesFrequencies at line 196
ManagesFrequencies everyFifteenMinutes()

Schedule the event to run every fifteen minutes.

Return Value

ManagesFrequencies

in ManagesFrequencies at line 204
ManagesFrequencies everyThirtyMinutes()

Schedule the event to run every thirty minutes.

Return Value

ManagesFrequencies

in ManagesFrequencies at line 212
ManagesFrequencies hourly()

Schedule the event to run hourly.

Return Value

ManagesFrequencies

in ManagesFrequencies at line 222
ManagesFrequencies hourlyAt(array|int|string $offset)

Schedule the event to run hourly at a given offset in the hour.

Parameters

array|int|string $offset

Return Value

ManagesFrequencies

in ManagesFrequencies at line 230
ManagesFrequencies everyOddHour(array|int|string $offset = 0)

Schedule the event to run every odd hour.

Parameters

array|int|string $offset

Return Value

ManagesFrequencies

in ManagesFrequencies at line 238
ManagesFrequencies everyTwoHours(array|int|string $offset = 0)

Schedule the event to run every two hours.

Parameters

array|int|string $offset

Return Value

ManagesFrequencies

in ManagesFrequencies at line 246
ManagesFrequencies everyThreeHours(array|int|string $offset = 0)

Schedule the event to run every three hours.

Parameters

array|int|string $offset

Return Value

ManagesFrequencies

in ManagesFrequencies at line 254
ManagesFrequencies everyFourHours(array|int|string $offset = 0)

Schedule the event to run every four hours.

Parameters

array|int|string $offset

Return Value

ManagesFrequencies

in ManagesFrequencies at line 262
ManagesFrequencies everySixHours(array|int|string $offset = 0)

Schedule the event to run every six hours.

Parameters

array|int|string $offset

Return Value

ManagesFrequencies

in ManagesFrequencies at line 270
ManagesFrequencies daily()

Schedule the event to run daily.

Return Value

ManagesFrequencies

in ManagesFrequencies at line 278
ManagesFrequencies at(string $time)

Schedule the command at a given time.

Parameters

string $time

Return Value

ManagesFrequencies

in ManagesFrequencies at line 286
ManagesFrequencies dailyAt(string $time)

Schedule the event to run daily at a given time (10:00, 19:30, etc).

Parameters

string $time

Return Value

ManagesFrequencies

in ManagesFrequencies at line 302
ManagesFrequencies twiceDaily(int $first = 1, int $second = 13)

Schedule the event to run twice daily.

Parameters

int $first
int $second

Return Value

ManagesFrequencies

in ManagesFrequencies at line 314
ManagesFrequencies twiceDailyAt(int $first = 1, int $second = 13, int $offset = 0)

Schedule the event to run twice daily at a given offset.

Parameters

int $first
int $second
int $offset

Return Value

ManagesFrequencies

in ManagesFrequencies at line 327
protected ManagesFrequencies hourBasedSchedule(array|int|string $minutes, array|int|string $hours)

Schedule the event to run at the given minutes and hours.

Parameters

array|int|string $minutes
array|int|string $hours

Return Value

ManagesFrequencies

in ManagesFrequencies at line 340
ManagesFrequencies weekdays()

Schedule the event to run only on weekdays.

Return Value

ManagesFrequencies

in ManagesFrequencies at line 348
ManagesFrequencies weekends()

Schedule the event to run only on weekends.

Return Value

ManagesFrequencies

in ManagesFrequencies at line 356
ManagesFrequencies mondays()

Schedule the event to run only on Mondays.

Return Value

ManagesFrequencies

in ManagesFrequencies at line 364
ManagesFrequencies tuesdays()

Schedule the event to run only on Tuesdays.

Return Value

ManagesFrequencies

in ManagesFrequencies at line 372
ManagesFrequencies wednesdays()

Schedule the event to run only on Wednesdays.

Return Value

ManagesFrequencies

in ManagesFrequencies at line 380
ManagesFrequencies thursdays()

Schedule the event to run only on Thursdays.

Return Value

ManagesFrequencies

in ManagesFrequencies at line 388
ManagesFrequencies fridays()

Schedule the event to run only on Fridays.

Return Value

ManagesFrequencies

in ManagesFrequencies at line 396
ManagesFrequencies saturdays()

Schedule the event to run only on Saturdays.

Return Value

ManagesFrequencies

in ManagesFrequencies at line 404
ManagesFrequencies sundays()

Schedule the event to run only on Sundays.

Return Value

ManagesFrequencies

in ManagesFrequencies at line 412
ManagesFrequencies weekly()

Schedule the event to run weekly.

Return Value

ManagesFrequencies

in ManagesFrequencies at line 422
ManagesFrequencies weeklyOn(mixed $dayOfWeek, string $time = '0:0')

Schedule the event to run weekly on a given day and time.

Parameters

mixed $dayOfWeek
string $time

Return Value

ManagesFrequencies

in ManagesFrequencies at line 432
ManagesFrequencies monthly()

Schedule the event to run monthly.

Return Value

ManagesFrequencies

in ManagesFrequencies at line 444
ManagesFrequencies monthlyOn(int $dayOfMonth = 1, string $time = '0:0')

Schedule the event to run monthly on a given day and time.

Parameters

int $dayOfMonth
string $time

Return Value

ManagesFrequencies

in ManagesFrequencies at line 457
ManagesFrequencies twiceMonthly(int $first = 1, int $second = 16, string $time = '0:0')

Schedule the event to run twice monthly at a given time.

Parameters

int $first
int $second
string $time

Return Value

ManagesFrequencies

in ManagesFrequencies at line 469
ManagesFrequencies lastDayOfMonth(string $time = '0:0')

Schedule the event to run on the last day of the month.

Parameters

string $time

Return Value

ManagesFrequencies

in ManagesFrequencies at line 481
ManagesFrequencies daysOfMonth(int|array ...$days)

Schedule the event to run on specific days of the month.

Parameters

int|array ...$days

Return Value

ManagesFrequencies

in ManagesFrequencies at line 494
ManagesFrequencies quarterly()

Schedule the event to run quarterly.

Return Value

ManagesFrequencies

in ManagesFrequencies at line 505
ManagesFrequencies quarterlyOn(int $dayOfQuarter = 1, string $time = '0:0')

Schedule the event to run quarterly on a given day and time.

Parameters

int $dayOfQuarter
string $time

Return Value

ManagesFrequencies

in ManagesFrequencies at line 516
ManagesFrequencies yearly()

Schedule the event to run yearly.

Return Value

ManagesFrequencies

in ManagesFrequencies at line 527
ManagesFrequencies yearlyOn(int $month = 1, int|string $dayOfMonth = 1, string $time = '0:0')

Schedule the event to run yearly on a given month, day, and time.

Parameters

int $month
int|string $dayOfMonth
string $time

Return Value

ManagesFrequencies

in ManagesFrequencies at line 538
ManagesFrequencies days(mixed $days)

Set the days of the week the command should run on.

Parameters

mixed $days

Return Value

ManagesFrequencies

in ManagesFrequencies at line 548
ManagesFrequencies timezone(DateTimeZone|UnitEnum|string $timezone)

Set the timezone the date should be evaluated on.

Parameters

DateTimeZone|UnitEnum|string $timezone

Return Value

ManagesFrequencies

in ManagesFrequencies at line 560
protected ManagesFrequencies spliceIntoPosition(int $position, int|string $value)

Splice the given value into the given position of the expression.

Parameters

int $position
int|string $value

Return Value

ManagesFrequencies

at line 54
__construct(Schedule $schedule)

Create a new pending event attributes instance.

Parameters

Schedule $schedule

at line 78
void mergeAttributes(Event $event)

Merge the current attributes into the given event.

Parameters

Event $event

Return Value

void

at line 135
mixed __call(string $method, array $parameters)

Proxy missing methods onto the underlying schedule.

Parameters

string $method
array $parameters

Return Value

mixed