🔥码云GVP开源项目 12k star Uniapp+ElementUI 功能强大 支持多语言、二开方便! 广告
## **简介** 传统的程序执行流程一般是 即时|同步|串行的,在某些场景下,会存在并发低,吞吐量低,响应时间长等问题。在大型系统中,一般会引入消息队列的组件,将流程中部分任务抽离出来放入消息队列,并由专门的消费者作针对性的处理,从而降低系统耦合度,提高系统性能和可用性。 一般来说,可以抽离的任务具有以下的特点: * **允许延后|异步|并行处理**(相对于传统的**即时|同步|串行**的执行方式) * **允许延后**: 抢购活动时,先快速缓冲有限的参与人数到消息队列,后续再排队处理实际的抢购业务; * **允许异步**: 业务处理过程中的邮件,短信等通知 * **允许并行**: 用户支付成功之后,邮件通知,微信通知,短信通知可以由多个不同的消费者并行执行,通知到达的时间不要求先后顺序。 * **允许失败和重试** * 强一致性的业务放入核心流程处理 * 无一致性要求或最终一致即可的业务放入队列处理 thinkphp-queue是thinkphp 官方提供的一个消息队列服务,它支持消息队列的一些基本特性: * 消息的**发布**,**获取**,**执行**,**删除**,**重发**,**失败处理**,**延迟执行**,**超时控制**等 * 队列的**多队列**,**内存限制**,**启动**,**停止**,**守护**等 * 消息队列可**降级为同步执行** thinkphp-queue 内置了**Redis**,**Database**,**Topthink**,**Sync**这四种驱动。本文主要介绍 thinkphp-queue 结合其内置的 redis 驱动的使用方式和基本原理。 ## **安装** > composer require topthink/think-queue ## **配置** > 配置文件位于`config/queue.php` ### 公共配置 ~~~ [ 'default'=>'sync' //驱动类型,可选择 sync(默认):同步执行,database:数据库驱动,redis:Redis驱动//或其他自定义的完整的类名 ] ~~~ ## **创建任务类** > 单模块项目推荐使用`app\job`作为任务类的命名空间 多模块项目可用使用`app\module\job`作为任务类的命名空间 也可以放在任意可以自动加载到的地方 任务类不需继承任何类,如果这个类只有一个任务,那么就只需要提供一个`fire`方法就可以了,如果有多个小任务,就写多个方法,下面发布任务的时候会有区别 每个方法会传入两个参数`think\queue\Job $job`(当前的任务对象) 和`$data`(发布任务时自定义的数据) 还有个可选的任务失败执行的方法`failed`传入的参数为`$data`(发布任务时自定义的数据) ### 下面写两个例子 ``` namespace app\job; use think\queue\Job; class Job1{ public function fire(Job $job, $data){ //....这里执行具体的任务 if ($job->attempts() > 3) { //通过这个方法可以检查这个任务已经重试了几次了 } //如果任务执行成功后 记得删除任务,不然这个任务会重复执行,直到达到最大重试次数后失败后,执行failed方法 $job->delete(); // 也可以重新发布这个任务 $job->release($delay); //$delay为延迟时间 } public function failed($data){ // ...任务达到最大重试次数后,失败了 } } ``` ``` namespace app\lib\job; use think\queue\Job; class Job2{ public function task1(Job $job, $data) { } public function task2(Job $job, $data) { } public function failed($data) { } } ``` ## **发布任务** ``` // 立即执行 think\facade\Queue::push($job, $data = '', $queue = null) // 在`$delay`秒后执行 think\facade\Queue::later($delay, $job, $data = '', $queue = null) ``` `$job`是任务名 单模块的,且命名空间是`app\job`的,比如上面的例子一,写`Job1`类名即可 多模块的,且命名空间是`app\module\job`的,写`model/Job1`即可 其他的需要些完整的类名,比如上面的例子二,需要写完整的类名`app\lib\job\Job2` 如果一个任务类里有多个小任务的话,如上面的例子二,需要用@+方法名`app\lib\job\Job2@task1`、`app\lib\job\Job2@task2` `$data`是你要传到任务里的参数 `$queue`队列名,指定这个任务是在哪个队列上执行,同下面监控队列的时候指定的队列名,可不填 ## **监听任务并执行** ``` php think queue:listen php think queue:work ``` 两种,具体的可选参数可以输入命令加`--help`查看 > 可配合supervisor使用,保证进程常驻