class PendingBatch

Traits

Properties

string $name

The batch name.

array $options

The batch options.

static protected array<class-string, bool> $batchableClasses

Jobs that have been verified to contain the Batchable trait.

Methods

mixed
when(mixed $value = null, callable|null $callback = null, callable|null $default = null)

Apply the callback if the given "value" is (or resolves to) truthy.

mixed
unless(mixed $value = null, callable|null $callback = null, callable|null $default = null)

Apply the callback if the given "value" is (or resolves to) falsy.

__construct(Container $container, Collection $jobs)

Create a new pending batch instance.

add(iterable|object $jobs)

Add jobs to the batch.

void
ensureJobIsBatchable(object|array $job)

Ensure the given job is batchable.

before(callable $callback)

Add a callback to be executed when the batch is stored.

array
beforeCallbacks()

Get the "before" callbacks that have been registered with the pending batch.

progress(callable $callback)

Add a callback to be executed after a job in the batch have executed successfully.

array
progressCallbacks()

Get the "progress" callbacks that have been registered with the pending batch.

then(callable $callback)

Add a callback to be executed after all jobs in the batch have executed successfully.

array
thenCallbacks()

Get the "then" callbacks that have been registered with the pending batch.

catch(callable $callback)

Add a callback to be executed after the first failing job in the batch.

array
catchCallbacks()

Get the "catch" callbacks that have been registered with the pending batch.

finally(callable $callback)

Add a callback to be executed after the batch has finished executing.

array
finallyCallbacks()

Get the "finally" callbacks that have been registered with the pending batch.

allowFailures(mixed $param = true)

Indicate that the batch should not be canceled when a job within the batch fails.

bool
allowsFailures()

Determine if the pending batch allows jobs to fail without cancelling the batch.

array
failureCallbacks()

Get the "failure" callbacks that have been registered with the pending batch.

name(string $name)

Set the name for the batch.

onConnection(UnitEnum|string $connection)

Specify the queue connection that the batched jobs should run on.

string|null
connection()

Get the connection used by the pending batch.

onQueue(UnitEnum|string|null $queue)

Specify the queue that the batched jobs should run on.

string|null
queue()

Get the queue used by the pending batch.

viaOutbox()

Dispatch batched jobs through the transactional outbox by default.

withoutOutbox()

Dispatch batched jobs without the transactional outbox by default.

onOutboxDatabase(UnitEnum|string $connection)

Stage batched jobs on the given database connection by default.

withOption(string $key, mixed $value)

Add additional data into the batch's options array.

dispatch()

Dispatch the batch.

dispatchAfterResponse()

Dispatch the batch after the response is sent to the browser.

void
dispatchExistingBatch(Batch $batch)

Dispatch an existing batch.

Batch|null
dispatchIf(bool|Closure $boolean)

Dispatch the batch if the given truth test passes.

Batch|null
dispatchUnless(bool|Closure $boolean)

Dispatch the batch unless the given truth test passes.

store(BatchRepository $repository)

Store the batch using the given repository.

static void
flushState()

Flush all static state.

Details

in Conditionable at line 23
mixed when(mixed $value = null, callable|null $callback = null, callable|null $default = null)

Apply the callback if the given "value" is (or resolves to) truthy.

Parameters

mixed $value
callable|null $callback
callable|null $default

Return Value

mixed

in Conditionable at line 56
mixed unless(mixed $value = null, callable|null $callback = null, callable|null $default = null)

Apply the callback if the given "value" is (or resolves to) falsy.

Parameters

mixed $value
callable|null $callback
callable|null $default

Return Value

mixed

at line 48
__construct(Container $container, Collection $jobs)

Create a new pending batch instance.

Parameters

Container $container
Collection $jobs

at line 62
PendingBatch add(iterable|object $jobs)

Add jobs to the batch.

Parameters

iterable|object $jobs

Return Value

PendingBatch

at line 80
protected void ensureJobIsBatchable(object|array $job)

Ensure the given job is batchable.

Parameters

object|array $job

Return Value

void

Exceptions

RuntimeException

at line 102
PendingBatch before(callable $callback)

Add a callback to be executed when the batch is stored.

Parameters

callable $callback

Return Value

PendingBatch

at line 112
array beforeCallbacks()

Get the "before" callbacks that have been registered with the pending batch.

Return Value

array

at line 122
PendingBatch progress(callable $callback)

Add a callback to be executed after a job in the batch have executed successfully.

Parameters

callable $callback

Return Value

PendingBatch

at line 132
array progressCallbacks()

Get the "progress" callbacks that have been registered with the pending batch.

Return Value

array

at line 142
PendingBatch then(callable $callback)

Add a callback to be executed after all jobs in the batch have executed successfully.

Parameters

callable $callback

Return Value

PendingBatch

at line 152
array thenCallbacks()

Get the "then" callbacks that have been registered with the pending batch.

Return Value

array

at line 162
PendingBatch catch(callable $callback)

Add a callback to be executed after the first failing job in the batch.

Parameters

callable $callback

Return Value

PendingBatch

at line 172
array catchCallbacks()

Get the "catch" callbacks that have been registered with the pending batch.

Return Value

array

at line 182
PendingBatch finally(callable $callback)

Add a callback to be executed after the batch has finished executing.

Parameters

callable $callback

Return Value

PendingBatch

at line 192
array finallyCallbacks()

Get the "finally" callbacks that have been registered with the pending batch.

Return Value

array

at line 205
PendingBatch allowFailures(mixed $param = true)

Indicate that the batch should not be canceled when a job within the batch fails.

Optionally, add callbacks to be executed upon each job failure.

Parameters

mixed $param

Return Value

PendingBatch

at line 225
bool allowsFailures()

Determine if the pending batch allows jobs to fail without cancelling the batch.

Return Value

bool

at line 235
array failureCallbacks()

Get the "failure" callbacks that have been registered with the pending batch.

Return Value

array

at line 255
PendingBatch name(string $name)

Set the name for the batch.

Parameters

string $name

Return Value

PendingBatch

at line 267
PendingBatch onConnection(UnitEnum|string $connection)

Specify the queue connection that the batched jobs should run on.

Parameters

UnitEnum|string $connection

Return Value

PendingBatch

at line 279
string|null connection()

Get the connection used by the pending batch.

Return Value

string|null

at line 289
PendingBatch onQueue(UnitEnum|string|null $queue)

Specify the queue that the batched jobs should run on.

Parameters

UnitEnum|string|null $queue

Return Value

PendingBatch

at line 301
string|null queue()

Get the queue used by the pending batch.

Return Value

string|null

at line 311
PendingBatch viaOutbox()

Dispatch batched jobs through the transactional outbox by default.

Return Value

PendingBatch

at line 323
PendingBatch withoutOutbox()

Dispatch batched jobs without the transactional outbox by default.

Return Value

PendingBatch

at line 337
PendingBatch onOutboxDatabase(UnitEnum|string $connection)

Stage batched jobs on the given database connection by default.

Parameters

UnitEnum|string $connection

Return Value

PendingBatch

at line 356
PendingBatch withOption(string $key, mixed $value)

Add additional data into the batch's options array.

Parameters

string $key
mixed $value

Return Value

PendingBatch

at line 368
Batch dispatch()

Dispatch the batch.

Return Value

Batch

Exceptions

Throwable

at line 399
Batch dispatchAfterResponse()

Dispatch the batch after the response is sent to the browser.

Return Value

Batch

at line 415
protected void dispatchExistingBatch(Batch $batch)

Dispatch an existing batch.

Parameters

Batch $batch

Return Value

void

Exceptions

Throwable

at line 438
Batch|null dispatchIf(bool|Closure $boolean)

Dispatch the batch if the given truth test passes.

Parameters

bool|Closure $boolean

Return Value

Batch|null

at line 446
Batch|null dispatchUnless(bool|Closure $boolean)

Dispatch the batch unless the given truth test passes.

Parameters

bool|Closure $boolean

Return Value

Batch|null

at line 454
protected Batch store(BatchRepository $repository)

Store the batch using the given repository.

Parameters

BatchRepository $repository

Return Value

Batch

at line 487
static void flushState()

Flush all static state.

Return Value

void