Phpdocumentor 和 Slim 路由器文档

Question

我使用 phpdocumentor 为我的项目生成文档。它为我的功能生成了很好的文档，例如：

    /**
       * Hash generator
       *
       * Long description
       *
       * @param string $password Password
       * @return string
       */
    function generate_hash($password) {
        global $PASSWORD_SALT;
        return crypt($password, $PASSWORD_SALT);
    }

但我还没有找到一种方法来记录 slim（php 框架）的映射：

    /**
     * Delete news
     *
     * Delete news by id
     *
     * @link /news/delete/:id
     *
     */
    $app->get('/news/delete/:id', function ($id) use ($app) {
        $item = ORM::for_table('news')->find_one($id);
        if ($item)
            $item->delete();
        $app->redirect('/');
    })->conditions(array('id'=>'\d+'));

记录此类事情的正确方法是什么？

Answer 1

为了将我的评论描述为答案，我会向您指出类似的东西：

/**
 * Delete news
 *
 * Delete news by id
 *
 * @link /news/delete/:id
 *
 */
public function deleteNewsByID (&$app, $id)
{
     return $app->get('/news/delete/:id', function ($id) use ($app) {
         $item = ORM::for_table('news')->find_one($id);
         if ($item)
             $item->delete();
         $app->redirect('/');
     })->conditions(array('id'=>'\d+'));
}

但我对 slim 不熟悉，所以我不能保证这会起作用。而且不推荐也不漂亮，如下面的cmets所述。