这个图是基于丝路项目的流程逻辑, 并不和下边的类相符, 下边的类是用 Hyperf 原生进行定义的

注解

Class 注解

注解是将一系列的数据进行关联的一种方式

类的注解以及生成的数据(全部)

1
2
3
4
5
6
7
8
9
10
11
12

array(2) {
  ["App\Service\AnClass\ClassAllIn"]=>
  object(App\Annotation\AnClass)#25 (1) {
    ["name"]=>
    string(5) "allin"
  }
  ["App\Service\AnClass\ClassQ"]=>
  object(App\Annotation\AnClass)#49 (1) {
    ["name"]=>
    string(1) "q"
  }
}

这里有一个注解类, 两个注解实现类
这里表明注册在 class 中可用, 传入的参数代表可以将参数初始化到 公共变量中, 在变量初始化的时候是进行如此设定的

1
2
3
4
5
6
7
8
9
10
11
12
13

# file : AbstractAnnotation.php

# 初始化
public function __construct($value = null)
{
    if (is_array($value)) {
        foreach ($value as $key => $val) {
            if (property_exists($this, $key)) {
                $this->{$key} = $val;
            }
        }
    }
}

1
2
3
4
5
6
7
8
9

# file : ClassQ.php

# 使用
/**
 * @AnClass(name="q")
 */
class ClassQ
{
}

注解的传参 : Url : https://hyperf.wiki/2.1/#/zh-cn/annotation?id=%E6%B3%A8%E8%A7%A3%E5%8F%82%E6%95%B0%E4%BC%A0%E9%80%92

• 传递主要的单个参数 @DemoAnnotation("value")
• 传递字符串参数 @DemoAnnotation(key1="value1", key2="value2")
• 传递数组参数 @DemoAnnotation(key={"value1", "value2"})

1
2
3
4
5
6
7
8

/**
 * @Annotation
 * @Target({"CLASS"})
 */
class AnClass extends AbstractAnnotation
{
    public string $name = '';
}

property (属性)

将属性/方法/定义传参

1
2
3
4
5
6
7
8
9
10

[
  [
    ["class"]=> "App\Service\Annotation\PropertyAllIn"
    ["property"]=> "actionName"
    ["annotation"]=>
      object(App\Annotation\AnProperty)#22 (1) {
        ["name"]=>  "allin"
      }
  ]
]

Method(方法)

1
2
3
4
5
6
7
8
9

[
  "App\Annotation\AnMethodByParams"=>
    object(App\Annotation\AnMethodByParams)#24 (2) {
    ["method"]=> "allin"
    ["params"]=> [
      [0]=>  string(2) "id"
    ]
  }
]

注解的分类

切面单独独立出来

@Annotation

注解的标识

@Target

注解的解析位置 CLASS, METHOD, PROPERTY, ALL

@Constants

常量数据

@Inject

标记属性, Hyperf 会自动注入对应的对象和值

@AutoController 以及控制器相关的代码

路由的注解
@Controller : 表明当前类是一个控制器类
@RequestMapping(path=”index”, methods=”get,post”) : 定义路由访问, 路径是控制器 + 当前定义的 path
@GetMapping : Get 方法
@PostMapping : Post
@PutMapping : Put
@PatchMapping : Patch 方法(对资源进行部分修改)
@DeleteMapping : Delete 删除

@Listener

切面 (Aspect)

通过动态代理等技术实现程序功能的统一维护的一种技术.
使用 Aop 扩展业务逻辑, 并使耦合度降低, 提高程序的可重用性

Socket

@SocketIONamespace(“/“)

socket 命名空间定义, 这里的命名空间和 socket.io 指定的相符, 也可以通过相关的路由来添加

@Event

以方法名作为事件名来分发事件, 如果写在控制器中则自动进行方法的映射.

1. Hyperf\HttpMessage\Exception\NotFoundHttpException

1
2
3

Hyperf\HttpMessage\Exception\NotFoundHttpException: Not Found(0)
in /webdata/www/dev_game/vendor/hyperf/http-server/src/CoreMiddleware.php:173
...

这个地方我是使用的是 nginx 转发, 这个地方使用 socket 进行转发的时候

2. WebSocket hande shake failed, because the class does not exists

鉴权失败, 抛出的错误, 直接考虑鉴权
具体详细在错误中抛出