Reference documentation and code samples for the Google Cloud PHP shared dependency, providing functionality useful to all components. Client class BatchRunner.
A class for executing jobs in batch.
Methods
__construct
Determine internal implementation and loads the configuration.
Parameters | |
---|---|
Name | Description |
configStorage |
Google\Cloud\Core\Batch\ConfigStorageInterface
[optional] The ConfigStorage object to use. Defaults to null. This is only for testing purpose. |
processor |
Google\Cloud\Core\Batch\ProcessItemInterface
[optional] The processor object to use. Defaults to null. This is only for testing purpose. |
registerJob
Register a job for batch execution.
Parameters | |
---|---|
Name | Description |
identifier |
string
Unique identifier of the job. |
func |
callable
Any Callable except for Closure. The callable should accept an array of items as the first argument. |
options |
array
Configuration options. |
↳ batchSize |
int
The size of the batch. |
↳ callPeriod |
float
The period in seconds from the last execution to force executing the job. |
↳ numWorkers |
int
The number of child processes. It only takes effect with the Google\Cloud\Core\Batch\BatchDaemon. |
↳ bootstrapFile |
string
A file to load before executing the job. It's needed for registering global functions. |
Returns | |
---|---|
Type | Description |
bool | true on success, false on failure |
submitItem
Submit an item.
Parameters | |
---|---|
Name | Description |
identifier |
string
Unique identifier of the job. |
item |
mixed
It needs to be serializable. |
Returns | |
---|---|
Type | Description |
void |
getJobFromId
Get the job with the given identifier.
Parameter | |
---|---|
Name | Description |
identifier |
string
Unique identifier of the job. |
Returns | |
---|---|
Type | Description |
Google\Cloud\Core\Batch\BatchJob|null |
getJobFromIdNum
Get the job with the given numeric id.
Parameter | |
---|---|
Name | Description |
idNum |
int
A numeric id of the job. |
Returns | |
---|---|
Type | Description |
Google\Cloud\Core\Batch\BatchJob|null |
getJobs
Get all the jobs.
Returns | |
---|---|
Type | Description |
array<Google\Cloud\Core\Batch\BatchJob> |
loadConfig
Load the config from the storage.
Returns | |
---|---|
Type | Description |
bool | true on success |
getProcessor
Gets the item processor.
Returns | |
---|---|
Type | Description |
Google\Cloud\Core\Batch\ProcessItemInterface |