自定义进程

hyperf/process 可以添加一个用户自定义的工作进程,此函数通常用于创建一个特殊的工作进程,用于监控、上报或者其他特殊的任务。在 Server 启动时会自动创建进程,并执行指定的子进程函数,进程意外退出时,Server 会重新拉起进程。

创建一个自定义进程

在任意位置实现一个继承 Hyperf\Process\AbstractProcess 的子类,并实现接口方法 handle(): void,方法内实现您的逻辑代码,我们通过代码来举例:

  1. <?php
  2. declare(strict_types=1);
  3. namespace App\Process;
  4. use Hyperf\Process\AbstractProcess;
  5. class FooProcess extends AbstractProcess
  6. {
  7. public function handle(): void
  8. {
  9. // 您的代码 ...
  10. }
  11. }

这样即完成了一个自定义进程类,但该自定义进程类尚未被注册到 进程管理器(ProcessManager) 内,我们可以通过 配置文件注解 两种方式的任意一种来完成注册工作。

通过配置文件注册

只需在 config/autoload/processes.php 内加上您的自定义进程类即可:

  1. // config/autoload/processes.php
  2. return [
  3. \App\Process\FooProcess::class,
  4. ];

通过注解注册

只需在自定义进程类上定义 @Process 注解,Hyperf 会收集并自动完成注册工作:

  1. <?php
  2. declare(strict_types=1);
  3. namespace App\Process;
  4. use Hyperf\Process\AbstractProcess;
  5. use Hyperf\Process\Annotation\Process;
  6. /**
  7. * @Process(name="foo_process")
  8. */
  9. class FooProcess extends AbstractProcess
  10. {
  11. public function handle(): void
  12. {
  13. // 您的代码 ...
  14. }
  15. }

使用 @Process 注解时需 use Hyperf\Process\Annotation\Process; 命名空间;

为进程启动加上条件

有些时候,并不是所有时候都应该启动一个自定义进程,一个自定义进程的启动与否可能会根据某些配置或者某些条件来决定,我们可以通过在自定义进程类内重写 isEnable(): bool 方法来实现,默认返回 true,即会跟随服务一同启动,如方法返回 false,则服务启动时不会启动该自定义进程。

  1. <?php
  2. declare(strict_types=1);
  3. namespace App\Process;
  4. use Hyperf\Process\AbstractProcess;
  5. use Hyperf\Process\Annotation\Process;
  6. /**
  7. * @Process(name="foo_process")
  8. */
  9. class FooProcess extends AbstractProcess
  10. {
  11. public function handle(): void
  12. {
  13. // 您的代码 ...
  14. }
  15. public function isEnable($server): bool
  16. {
  17. // 不跟随服务启动一同启动
  18. return false;
  19. }
  20. }

设置自定义进程

自定义进程存在一些可设置的参数,均可以通过 在子类上重写参数对应的属性 或 在 @Process 注解内定义对应的属性 两种方式来进行定义。

  1. <?php
  2. declare(strict_types=1);
  3. namespace App\Process;
  4. use Hyperf\Process\AbstractProcess;
  5. use Hyperf\Process\Annotation\Process;
  6. /**
  7. * @Process(name="user-process",redirectStdinStdout=false, pipeType=2, enableCoroutine=true)
  8. */
  9. class FooProcess extends AbstractProcess
  10. {
  11. /**
  12. * 进程数量
  13. * @var int
  14. */
  15. public $nums = 1;
  16. /**
  17. * 进程名称
  18. * @var string
  19. */
  20. public $name = 'user-process';
  21. /**
  22. * 重定向自定义进程的标准输入和输出
  23. * @var bool
  24. */
  25. public $redirectStdinStdout = false;
  26. /**
  27. * 管道类型
  28. * @var int
  29. */
  30. public $pipeType = 2;
  31. /**
  32. * 是否启用协程
  33. * @var bool
  34. */
  35. public $enableCoroutine = true;
  36. }

使用示例

我们创建一个用于监控失败队列数量的子进程,当失败队列有数据时,报出警告。

  1. <?php
  2. declare(strict_types=1);
  3. namespace App\Process;
  4. use Hyperf\Process\AbstractProcess;
  5. use Hyperf\Process\Annotation\Process;
  6. use Hyperf\Contract\StdoutLoggerInterface;
  7. /**
  8. * @Process(name="demo_process")
  9. */
  10. class DemoProcess extends AbstractProcess
  11. {
  12. public function handle(): void
  13. {
  14. $logger = $this->container->get(StdoutLoggerInterface::class);
  15. while (true) {
  16. $redis = $this->container->get(\Redis::class);
  17. $count = $redis->llen('queue:failed');
  18. if ($count > 0) {
  19. $logger->warning('The num of failed queue is ' . $count);
  20. }
  21. sleep(1);
  22. }
  23. }
  24. }