2

我正在努力弄清楚如何构建我的代码,以便 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.

有人有什么建议吗?

4

1 回答 1

1

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

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

于 2013-08-20T13:40:13.953 回答