class Batch implements Arrayable, JsonSerializable (View source)

Properties

protected Factory $queue

The queue factory implementation.

protected BatchRepository $repository

The repository implementation.

string $id

The batch ID.

string $name

The batch name.

int $totalJobs

The total number of jobs that belong to the batch.

int $pendingJobs

The total number of jobs that are still pending.

int $failedJobs

The total number of jobs that have failed.

array $failedJobIds

The IDs of the jobs that have failed.

array $options

The batch options.

CarbonImmutable $createdAt

The date indicating when the batch was created.

CarbonImmutable|null $cancelledAt

The date indicating when the batch was cancelled.

CarbonImmutable|null $finishedAt

The date indicating when the batch was finished.

Methods

void
__construct(Factory $queue, BatchRepository $repository, string $id, string $name, int $totalJobs, int $pendingJobs, int $failedJobs, array $failedJobIds, array $options, CarbonImmutable $createdAt, CarbonImmutable|null $cancelledAt = null, CarbonImmutable|null $finishedAt = null)

Create a new batch instance.

fresh()

Get a fresh instance of the batch represented by this ID.

add(Enumerable|array $jobs)

Add additional jobs to the batch.

prepareBatchedChain(array $chain)

Prepare a chain that exists within the jobs being added.

int
processedJobs()

Get the total number of jobs that have been processed by the batch thus far.

int
progress()

Get the percentage of jobs that have been processed (between 0-100).

void
recordSuccessfulJob(string $jobId)

Record that a job within the batch finished successfully, executing any callbacks if necessary.

decrementPendingJobs(string $jobId)

Decrement the pending jobs for the batch.

bool
finished()

Determine if the batch has finished executing.

bool
hasThenCallbacks()

Determine if the batch has "success" callbacks.

bool
allowsFailures()

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

bool
hasFailures()

Determine if the batch has job failures.

void
recordFailedJob(string $jobId, Throwable $e)

Record that a job within the batch failed to finish successfully, executing any callbacks if necessary.

incrementFailedJobs(string $jobId)

Increment the failed jobs for the batch.

bool
hasCatchCallbacks()

Determine if the batch has "catch" callbacks.

bool
hasFinallyCallbacks()

Determine if the batch has "finally" callbacks.

void
cancel()

Cancel the batch.

bool
canceled()

Determine if the batch has been cancelled.

bool
cancelled()

Determine if the batch has been cancelled.

void
delete()

Delete the batch from storage.

void
invokeHandlerCallback(callable $handler, Batch $batch, Throwable $e = null)

Invoke a batch callback handler.

array
toArray()

Convert the batch to an array.

array
jsonSerialize()

Get the JSON serializable representation of the object.

mixed
__get(string $key)

Dynamically access the batch's "options" via properties.

Details

void __construct(Factory $queue, BatchRepository $repository, string $id, string $name, int $totalJobs, int $pendingJobs, int $failedJobs, array $failedJobIds, array $options, CarbonImmutable $createdAt, CarbonImmutable|null $cancelledAt = null, CarbonImmutable|null $finishedAt = null)

Create a new batch instance.

Parameters

Factory $queue
BatchRepository $repository
string $id
string $name
int $totalJobs
int $pendingJobs
int $failedJobs
array $failedJobIds
array $options
CarbonImmutable $createdAt
CarbonImmutable|null $cancelledAt
CarbonImmutable|null $finishedAt

Return Value

void

Batch fresh()

Get a fresh instance of the batch represented by this ID.

Return Value

Batch

Batch add(Enumerable|array $jobs)

Add additional jobs to the batch.

Parameters

Enumerable|array $jobs

Return Value

Batch

protected Collection prepareBatchedChain(array $chain)

Prepare a chain that exists within the jobs being added.

Parameters

array $chain

Return Value

Collection

int processedJobs()

Get the total number of jobs that have been processed by the batch thus far.

Return Value

int

int progress()

Get the percentage of jobs that have been processed (between 0-100).

Return Value

int

void recordSuccessfulJob(string $jobId)

Record that a job within the batch finished successfully, executing any callbacks if necessary.

Parameters

string $jobId

Return Value

void

UpdatedBatchJobCounts decrementPendingJobs(string $jobId)

Decrement the pending jobs for the batch.

Parameters

string $jobId

Return Value

UpdatedBatchJobCounts

bool finished()

Determine if the batch has finished executing.

Return Value

bool

bool hasThenCallbacks()

Determine if the batch has "success" callbacks.

Return Value

bool

bool allowsFailures()

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

Return Value

bool

bool hasFailures()

Determine if the batch has job failures.

Return Value

bool

void recordFailedJob(string $jobId, Throwable $e)

Record that a job within the batch failed to finish successfully, executing any callbacks if necessary.

Parameters

string $jobId
Throwable $e

Return Value

void

UpdatedBatchJobCounts incrementFailedJobs(string $jobId)

Increment the failed jobs for the batch.

Parameters

string $jobId

Return Value

UpdatedBatchJobCounts

bool hasCatchCallbacks()

Determine if the batch has "catch" callbacks.

Return Value

bool

bool hasFinallyCallbacks()

Determine if the batch has "finally" callbacks.

Return Value

bool

void cancel()

Cancel the batch.

Return Value

void

bool canceled()

Determine if the batch has been cancelled.

Return Value

bool

bool cancelled()

Determine if the batch has been cancelled.

Return Value

bool

void delete()

Delete the batch from storage.

Return Value

void

protected void invokeHandlerCallback(callable $handler, Batch $batch, Throwable $e = null)

Invoke a batch callback handler.

Parameters

callable $handler
Batch $batch
Throwable $e

Return Value

void

array toArray()

Convert the batch to an array.

Return Value

array

array jsonSerialize()

Get the JSON serializable representation of the object.

Return Value

array

mixed __get(string $key)

Dynamically access the batch's "options" via properties.

Parameters

string $key

Return Value

mixed