生成自动文档SlimFramework

Question

我有一个简单的Slim，它已经使用RESTful框架构建了。

代码示例：

$app->group('/settings','authenticate','is_admin',function () use($app){
    $app->get('/gear', function () use ($app) {
        ...
    });

    $app->group('/users',function() use($app){
        $app->get('/', function () use ($app) {...});
        $app->post('/', function () use ($app) {...});
        $app->put('/:id', function ($id) use ($app) {...});
        $app->delete('/:id', function () use ($app) {...});
    });
});

现在，我需要构建一个简单的页面，将我的所有路由组作为“资源”列出，并在每个组下嵌套路由，以便为每个路由组/方法添加一些文本文档，这些文档将在稍后的数据库或文件存储中保存。

总括而言，我的问题是：

1. 像这样的东西已经存在了吗？
2. 如何在中列出所有路由和路由组？

我现在的黑客：

$app->get('/', function () use ($app) {
    $data=[];
    //$router->routes is a protected variable, so i had to change it to public, same for $r->methods and pattern
    foreach($app->router->routes as $r){
        $x = explode('/',$r->pattern);
        $x = $x[1];
        $data[$x][$r->methods[0]][]=$r->pattern."[".implode(',',$r->middleware)."]";
    }
    print_r($data);
});

我给出的结果如下：

Array
(
    [auth] => Array
        (
            [GET] => Array
                (
                    [0] => /auth/me[authenticate]
                    [1] => /auth/logout[]
                )

            [POST] => Array
                (
                    [0] => /auth/login[]
                )

            [DELETE] => Array
                (
                    [0] => /auth/logout[]
                )

        )

    [settings] => Array
        (
            [GET] => Array
                (
                    [0] => /settings/classes[authenticate,is_admin]
                    [1] => /[authenticate,is_admin]
                )

            [POST] => Array
                (
                    [0] => /settings/grades/:id/class[authenticate,is_admin]
                    [1] => /settings/grades/:id/subject[authenticate,is_admin]
                    [2] => /settings/departments/:id/grade[authenticate,is_admin]
                    [3] => /settings/subjects/:id/skills[authenticate,is_admin]
                )

        )

Answer 1

所以我想要这样做，它有一些限制，但它会使你的道路的一部分。

我使用了瘦中间件并创建了自己的中间件。http://docs.slimframework.com/middleware/overview/

然后，每次使用路由时，我都会得到请求模式和方法。如果是get，我将使用phps反射函数来获取变量类型、整数或字符串。如果是post，我会让请求体解析它并获得变量类型。然后，我会将这些保存到一个json文件(每个路由一个文件)，半遵循swagger规范。然后，我将swagger指向另一个php脚本，该脚本将查看包含所有json文件的目录，并将其合并到一个json文件中，该文件遵循swagger-ui规范，我响应json到swagger。

这种方法在很大程度上不尽如人意，就像对所有事物的描述一样，但它却使我们达到了目的。这条线上有什么。

`

class MyMiddleware extends \Slim\Middleware
{
public $myRoute;
    public function call()
    {
                //The Slim application
                $app = $this->app;
                $this->app->hook('slim.before.dispatch', array($this, 'onBeforeDispatch'));
                //The Environment object
                $env = $app->environment;
                //The Request object
                $req = $app->request;
                $method = $req->getMethod();
                $return['operations'] = array('method'=> $req->getMethod(),"summary" =>'',"type"=>'',"nickname"=>'',"parameters"=>array());
                if($method == "POST"){
                        $parameters = json_decode($env->offsetGet('slim.input'));
                        $return['operations']['parameters'] = $parameters;
                }
                //The Response object
                $res = $app->response;
                $body = $res->getBody();
                $this->return = $return;
                //call the next middleware
                $this->next->call();
    }
         public function onBeforeDispatch()
    {
        $route = $this->app->router()->getCurrentRoute();
        $this->myRoute = $route;
         $return['path'] = $route->getPattern();
                $return = $this->return;
                if($return['operations']['method'] == "GET"){
                        $refFunc = new ReflectionFunction($route->callable);
                        foreach ($refFunc->getParameters()  as $refParameter) {
                                $return['operations']['parameters'] = array();
                                $return['operations']['parameters']['name'] = $refParameter->name;
                                $return['operations']['parameters']['required'] = $refParameter->isOptional();
                        }
                }
                echo json_encode($return);
    }
}
$app->add(new MyMiddleware);

“”不管怎样，我希望它能帮上忙。