可能重复:
是否有记录 GET/POST 参数的标准?
试图找出通过 phpdoc 以有意义的方式记录请求参数的最佳方法。具体来说,我有一些 Zend Framework 控制器操作,它们通过 GET/POST 接收参数,但不是功能参数。这有意义吗?
/**
* Display a pagination/grid list of rows.
*
* @param string $_GET['order'] What field to sort on
* @param string $_GET['dir'] Direction to sort; either ASC|DESC
*
* @return void
*/
public function listAction()
{
$order = $this->_request->order;
...
如果我为此方法生成文档,则不会有迹象表明“order”和“dir”可以通过 url 字符串传递给该方法。这样做会更有意义吗
@param string $order
我应该改用@var 吗?
欢迎提出想法。