Hyperf路由分组定义教程怎么写-php教程-PHP中文网

hyperf 路由分组通过 router::addgroup() 统一管理前缀、中间件和公共配置，支持基础分组、嵌套分组及参数传递，提升 api 结构清晰度与可维护性。

hyperf路由分组定义教程怎么写

Hyperf 路由分组通过 Router::addGroup() 统一管理前缀、中间件和公共配置，让 API 结构更清晰、维护更方便。

基础分组写法：带前缀和中间件

最常用场景是为一组接口统一添加版本前缀（如 /v1）和鉴权中间件：

use Hyperf\HttpServer\Router\Router;

Router::addGroup('/v1', function () {
    Router::get('/users', 'App\Controller\UserController::index');
    Router::post('/users', 'App\Controller\UserController::store');
}, ['middleware' => [AuthMiddleware::class]]);

这样所有子路由自动继承 /v1 前缀，并在执行前经过 AuthMiddleware 检查。

Hyperf 3.2.4

Hyperf 3.2.4 官方源码下载，适合 PHP 协程框架、微服务组件和高并发应用升级，覆盖 3.2 分支新增函数与稳定性优化。

下载

嵌套分组：多层路径与权限隔离

适合模块化设计，比如后台管理接口可再按资源细分：

Router::addGroup('/admin', function () {
    Router::addGroup('/users', function () {
        Router::get('/', 'App\Controller\Admin\UserController::list');
        Router::delete('/{id}', 'App\Controller\Admin\UserController::delete');
    }, ['middleware' => [AdminPermissionMiddleware::class]]);

    Router::addGroup('/orders', function () {
        Router::get('/', 'App\Controller\Admin\OrderController::list');
    }, ['middleware' => [AdminPermissionMiddleware::class]]);
}, ['middleware' => [LoginMiddleware::class]]);

外层 /admin 分组应用登录中间件
内层 /users 和 /orders 各自加权限控制，互不影响
最终路由为 /admin/users、/admin/orders 等

分组参数与变量传递

分组本身不支持直接定义参数，但子路由可正常使用占位符，且分组前缀会拼接：

Router::addGroup('/api', function () {
    Router::get('/posts/{id:\d+}', 'App\Controller\PostController::show');
    Router::put('/posts/{id:\d+}', 'App\Controller\PostController::update');
});

匹配路径为 /api/posts/123，其中 {id:\d+} 保证只接受数字 ID，提升安全性。