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 に答える