laravel-5

Queues 314
.
In this example, note that we were able to pass an Eloquent model directly into the queued job’s
constructor. Because of the SerializesModels trait that the job is using, Eloquent models will be
gracefully serialized and unserialized when the job is processing. If your queued job accepts an
Eloquent model in its constructor, only the identifier for the model will be serialized onto the queue.
When the job is actually handled, the queue system will automatically re-retrieve the full model
instance from the database. It’s all totally transparent to your application and prevents issues that
can arise from serializing full Eloquent model instances.
The handle method is called when the job is processed by the queue. Note that we are able to typehint
dependencies on the handle method of the job. The Laravel service container automatically
injects these dependencies.
When Things Go Wrong
If an exception is thrown while the job is being processed, it will automatically be released back
onto the queue so it may be attempted again. The job will continue to be released until it has been
attempted the maximum number of times allowed by your application. The number of maximum
attempts is defined by the --tries switch used on the queue:listen or queue:work Artisan jobs.
More information on running the queue listener can be found below.
Manually Releasing Jobs
If you would like to release the job manually, the InteractsWithQueue trait, which is already
included in your generated job class, provides access to the queue job release method. The release
method accepts one argument: the number of seconds you wish to wait until the job is made available
again:
.
1 public function handle(Mailer $mailer)
2 {
3 if (condition) {
4 $this->release(10);
5 }
6 }
Checking The Number Of Run Attempts
As noted above, if an exception occurs while the job is being processed, it will automatically be
released back onto the queue. You may check the number of attempts that have been made to run
the job using the attempts method: