php - 如何为苗条的框架路由/回调生成 phpdoc

Question

我正在努力弄清楚如何构建我的代码，以便 phpDocumentor 可以使用代码块。

/**
 * GET -- Book, either filtered by id or a full list.
 *
 * @param   SlimApplication     $app    The application object instance.
 * @param   integer             $id The id of the book
 */
$callbackFunction = function($id) use ($app)
{
    //some functionality here.
};
$app->get('/books(/:id)', $callbackFunction );

我可能应该继续使用内联use语句，这样我就可以使用$app.

有人有什么建议吗？

Answer 1

phpDocumentor 没有特殊的语法来记录这样的匿名函数。如果要记录闭包本身，则需要将其实际定义为第一类函数，然后可以这样记录它。

如果知道闭包存在并且文档阅读者需要知道它的细节，那么作为一等函数可能就足够重要了？再说一次，作为一个闭包，它实际上在代码的 API 上不可用......所以它甚至需要记录吗？