Hyperf addRoute怎么使用-php教程-PHP中文网

addroute的基本调用形式为addroute(array $methods, string $path, $handler, array $options = [])：$methods必须是数组（如['get']），$path支持静态/动态路径（{}必填、[]选填），$handler可为闭包、完整命名空间字符串或数组，$options主要支持middleware和timeout。

hyperf addroute怎么使用

addRoute 的基本调用形式和参数顺序

addRoute 是 Hyperf 路由注册的底层方法，比 get/post 等快捷方法更灵活，但参数顺序和类型容易出错。它签名是：addRoute(array $methods, string $path, $handler, array $options = [])。

常见错误是把 $path 和 $handler 位置写反，或传入字符串类名但没加命名空间（如写成 'IndexController@index' 而非 'App\Controller\IndexController@index'）。

$methods 必须是数组，即使只支持一个方法也要写成 ['GET']，不能传字符串 'GET'
$path 支持静态路径（'/api/users'）、带必填参数（'/api/users/{id:\d+}'）、选填参数（'/api/users/{id:\d+}[/{name}]'），注意 {} 和 [] 的语义差异
$handler 可以是闭包、类方法字符串（'App\Controller\UserController@index'）、数组形式（[Usercontroller::class, 'index']），三者行为一致，但字符串需完整命名空间

为什么 addRoute 注册后访问 404？

最常见原因是路由未被实际加载——addRoute 只是往当前 RouteCollector 实例里加数据，但框架启动后不会自动重刷 FastRoute\Dispatcher。如果你在运行时（比如某个命令或中间件里）调用 addRoute，它不会生效。

正确做法是在 config/routes.php 文件中调用，确保它在服务启动的路由收集阶段执行。若必须动态添加，得手动重建 Dispatcher 并通过 Router::setDispatcher()（v3.0+）或反射替换（v2.2），不是简单调一次 addRoute 就行。

检查 config/autoload/server.php 中 'type' => 'http' 是否启用，且端口未被占用
执行 php bin/hyperf.php route:list 确认该路由是否出现在列表中
路径中含正则时（如 {id:\d+}），请求 URL 必须严格匹配，/api/users/abc 会 404

addRoute 和 get/post 等快捷方法的区别

get/post 本质是 addRoute 的封装，只固定了 $methods 参数。它们用起来更安全，因为默认做了方法限制和参数校验；而 addRoute 更“裸”，适合需要多方法共用同一 handler 或精细控制 $options 的场景。

Hyperframes Creative

HyperFrames视频非动画创意指导，包括设计规范（frame.md/design.md）处理、配色、字体设计、旁白及节奏规划等。

下载

比如要让一个接口同时响应 GET 和 HEAD，又想加中间件和超时配置，用 addRoute 更直接：

Router::addRoute(
    ['GET', 'HEAD'],
    '/status',
    'App\Controller\HealthController::check',
    [
        'middleware' => [AuthMiddleware::class],
        'timeout' => 3000,
    ]
);

get('/path', ...) 等同于 addRoute(['GET'], '/path', ...)
addGroup 内部也是调 addRoute，前缀拼接发生在内部，不用手动处理
所有快捷方法都不支持传 $options，想配中间件或超时，只能用 addRoute

addRoute 的 options 参数能做什么

$options 数组目前主要支持两个键：middleware 和 timeout（后者仅对 GatewayRoute 有效，普通 HTTP 路由不识别 timeout）。它不是扩展点，不要往里塞自定义字段。

中间件配置是唯一常用项，值为字符串类名数组，会按顺序执行：

Router::addRoute(
    ['POST'],
    '/upload',
    'App\Controller\UploadController::handle',
    ['middleware' => [AuthMiddleware::class, UploadLimitMiddleware::class]]
);