在PHPDoc中记录控制器操作的好方法？

Question

我试图想出一个在php mvc框架中记录控制器动作的好方法.对我来说非常重要的是,有一种方法可以将动作的网址粘贴在那里,我的问题是我似乎无法找到一种方法使其适合phpdoc的模式.

Answer 1

我不太明白你的问题/问题。您可以将任何内容放入 phpdoc 块中，包括控制器操作的相关 URL（如果需要，您甚至可以使用标记）：

/**
 * This is some foo action.
 *
 * URL: /foo/bar/baz
 */
public function fooAction(/* ... */) {
    // ...
}

也就是说，如果您特别想使用自定义标签之类@url的东西，那么您只需要使用-ct命令行选项告诉 phpdoc 您不希望它在遇到自定义标签时抛出解析错误:

# Will specify custom tag @url
phpdoc -ct url ...