README.md
DTS 分布式任务调度队列
Usage
1:在配置文件中配置好需要使用的队列，完整的配置代码如下：
数据库队列
'queue' => [
'class' => 'DTS\Queue\Db', //队列使用的类
'storage' => [//队列中间件链接器配置（这是因为使用数据库，所以使用yii\db\Connection作为数据库链接实例）
'class' => 'yii\db\Connection',
'dsn' => 'mysql:host=localhost;dbname=yii-queue',
'username' => 'root',
'password' => '',
'charset' => 'utf8',
],
'table' => 'jobs', //存储队列数据表名
'queue' => 'default', //队列的名称
'expire' => 60, //任务过期时间
'maxJob' =>0, //队列允许最大任务数，0为不限制
'failed' => [//任务失败日志记录（目前只支持记录到数据库）
'logFail' => true, //开启任务失败处理
'provider' => [ //任务失败处理类
'class' => 'DTS\Queue\Failed\Db',
'storage' => [ //数据库链接
'class' => 'yii\db\Connection',
'dsn' => 'mysql:host=localhost;dbname=yii-queue',
'username' => 'root',
'password' => '111111',
'charset' => 'utf8',
],
'table' => 'failed_jobs' //存储失败日志的表名
],
],
]
redis队列
'queue' => [
'class' => 'DTS\Queue\Redis',
'storage' => [ //需要安装 predis\predis 扩展来操作redis
'class' => 'shmilyzxt\queue\connectors\PredisConnector',
'parameters' => [
'scheme' => 'tcp',
'host' => '127.0.0.1',
'port' => 6379,
//'password' => '1984111a',
'db' => 0
],
'options'=> [],
],
'queue' => 'default',
'expire' => 60,
'maxJob' => 0,
'failed' => [
'logFail' => true,
'provider' => [
'class' => 'DTS\Queue\Failed\Db',
'storage' => [
'class' => 'yii\db\Connection',
'dsn' => 'mysql:host=localhost;dbname=yii2advanced',
'username' => 'root',
'password' => '',
'charset' => 'utf8',
],
'table' => 'failed_jobs'
],
],
]
2：在components数组配置项中配置好队列后，就可以开始使用队列了，首先是任务入队列，提供两个方法： \Yii::$app->redisQueue->pushOn($hander,$data,$queue='default') 即时任务入队列：这样的任务入队列后，如果队列监听在运行，那么任务会立刻进入ready状态，可以被监听进程执行。 该方法有3个参数，第一个为任务处理handler，第二个为任务数据，第三个为队列名称，默认为 default。 \Yii::$app->redisQueue->laterOn($delay,$handler,$data,$queue='default') 延时任务入队列：这样的任务入队列后不会立刻被队列监听进程之行，需要等待 $delay秒后任务才就绪。
\Yii::$app->redisQueue->pushOn(function($job,$data){var_dump($data)},['email'=>'49783121@qq.com','title'=>'test','content'=>'email test'],'email');
\Yii::$app->redisQueue->pushOn(120,function($job,$data){var_dump($data)},['email'=>'49783121@qq.com','title'=>'test','content'=>'email test'],'email');
3：启动后台队列监听进程，对任务进行处理，您可以使用yii console app来启动,你也可以使用更高级的如swoole来高效的运行队列监听， 目前提供了一个Worker类，在控制台程序使用Worker::work(Queue $queue,$queueName='default',$attempt=10,$memory=512,$sleep=3,$delay=0)可以 启动队列监听进程，其中 $attempt是任务尝试次数，$memory是允许使用最大内存，$sleep表示每次尝试从队列中获取任务的间隔时间，$delay代表把任务重新加入队列 时是否延时（0代表不延时），一个标准yii console app 启动队列监听进程代码如下;
class WorkerController extends \yii\console\Controller
{
public function actionListen()
{
$worker = new Worker();
$queueName = 'default';
$options = [
'attempt' => 10,
'memory' => 128,
'sleep' => 3,
'delay' => 0,
];
$worker::work(\Yii::$app->redisQueue, $queueName, $options);
}
}
yii worker/listen default 10 128 3 0
当后台监听任务启动起来后，一但有任务加入队列，队列就会调用入队列时设置的handler对队列任务进行处理了。每次会pop出一个任务进行处理，处理完成后删除任务，直到队列为空。
5：关于任务失败处理： 默认情况下，一个任务在执行时出现异常或者一个任务失败时并不是认为它真正失败了，此时会检测它的尝试次数是否已经超出设置的attempt，如果没超出会重新入队列尝试，如果超出了， 则该任务才是真正失败，这是会先调用任务处理handler类的failed()方法处理失败操作,如果没有failed()方法（比如handler为闭包或者您自定义的继承自shmilyzxt\queue\base\JobHandler 的类没有写failed()方法），则会尝试使用扩展自身的失败日志处理机制（配置项里的failed配置），会尝试把失败任务的详细信息写入到数据库表中（目前只支持数据库方式）。 建议您采用继承shmilyzxt\queue\base\JobHandler的方式生成任务处理handler并写自己的failed方法处理失败任务。