Laravel框架中的延迟任务（Delayed Job）使用示例

本文中的laravel框架版本：laravel5.8

需求：关闭未支付订单

在创建订单的同时我们减去了对应商品的库存，恶意用户可以通过下大量的订单又不支付来占用商品库存，让正常的用户因为库存不足而无法下单进行购买商品。因此我们需要有一个关闭未支付订单的机制，当创建订单之后，一定时间内没有进行支付，将关闭订单并退回减去的库存。

对于这个需求我们可以用 Laravel 提供的延迟任务（Delayed Job）功能来解决。当我们的系统触发了一个延迟任务，Laravel会用当前的时间加上任务的延迟时间计算出任务的执行时间戳，然后将这个时间戳和任务信息序列化之后存入队列，，Laravel 的队列处理器会不断查询并执行队列中满足预计执行时间等于或早于当前时间的任务。PS：其实这个就是开发者口中常说的"延时队列"

1、创建任务

我们可以通过 make:job 命令来创建一个任务：

php artisan make:job CloseOrder

创建的任务类保存在 app/Jobs 目录下，现在编辑刚刚创建的任务类：

app/Jobs/CloseOrder.php

<?php

namespace App\Jobs;

use Illuminate\Bus\Queueable;
use Illuminate\Queue\SerializesModels;
use Illuminate\Queue\InteractsWithQueue;
use Illuminate\Contracts\Queue\ShouldQueue;
use Illuminate\Foundation\Bus\Dispatchable;
use App\Models\Order;

// 代表这个类需要被放到队列中执行，而不是触发时立即执行
class CloseOrder implements ShouldQueue
{
    use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;

    protected $order;

    public function __construct(Order $order, $delay)
    {
        $this->order = $order;
        // 设置延迟的时间，delay() 方法的参数代表多少秒之后执行
        $this->delay($delay);
    }

    // 定义这个任务类具体的执行逻辑
    // 当队列处理器从队列中取出任务时，会调用 handle() 方法
    public function handle()
    {
        // 判断对应的订单是否已经被支付
        // 如果已经支付则不需要关闭订单，直接退出
        if ($this->order->paid_at) {
            return;
        }
        // 通过事务执行 sql
        \DB::transaction(function() {
            // 将订单的 closed 字段标记为 true，即关闭订单
            $this->order->update(['closed' => true]);
            // 循环遍历订单中的商品 SKU，将订单中的数量加回到 SKU 的库存中去
            foreach ($this->order->items as $item) {
                $item->productSku->addStock($item->amount);
            }
        });
    }
}

2、触发任务

接下来我们需要在创建订单之后触发这个任务：

app/Http/Controllers/OrdersController.php

use App\Jobs\CloseOrder;
    .
    .
    .
    public function store(OrderRequest $request)
    {
        .
        .
        .
        $this->dispatch(new CloseOrder($order, config('app.order_ttl')));

        return $order;
    }

CloseOrder 构造函数的第二个参数，延迟时间我们从配置文件中读取，为了方便我们测试，把这个值设置成 30 秒：

config/app.php