Question

我很好奇将多个参数传递给方法的最佳做法是什么。具体来说，我想知道是否在新行上调用带有注释和参数的方法将被认为是不好的做法。

// get json from database
$json = $this->mysql->get_json_from_entries($this->table,   // data table
                                            $foo,           // column
                                            $bar,           // column value
                                            $this->limit);  // maximum rows to retrieve

而不是

// get json from database
$json = $this->mysql->get_json_from_entries($this->table, $foo, $bar, $this->limit);

Answer 1

这是一个品味的问题，但通常是从我在一条线上看到它的全部，然后你像这样使用你的DOC块：

/**
  *  Get json from database
  *
  * @param $this->table object data table
  * @param $foo string column name
  * ...etc
  */
$json = $this->mysql->get_json_from_entries($this->table, $foo, $bar, $this->limit);

Answer 2

就个人而言，我认为真正的长线更糟糕。

您可能更感兴趣的是Zend Framework Coding Standard for PHP。

Answer 3

我通常喜欢倾向于最佳实践，但有时候（如果函数有太多参数），第一种风格也是我的首选。

但是，有两件事：如果函数有太多参数，您可以考虑重构它，可能将参数放在新类中或更改类本身的实现其次，尝试使用详细名称声明变量，其中描述了其用法。提示：php不遵循这些做法：）

使用新行上的参数调用方法会被视为不良做法吗？

3 个答案: