我很好奇向一个方法传递多个参数的最佳做法是什么。特别是,我想知道是否在新行中调用带有注释和参数的方法会被认为是坏做法。
// 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);
这是一个品味问题,但通常从我所看到的来看,它都在一行上,然后你像这样使用你的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);
就我个人而言,我认为真正的长队更糟糕。
您可能对PHP的Zend框架编码标准更感兴趣。
我通常喜欢倾向于最佳实践,但有时(如果函数有太多参数)我也更喜欢第一种风格。
不过有两件事:如果一个函数的参数太多,您可能会考虑对其进行重构,或者将参数放入一个新的类中,或者更改类本身的实现其次,尝试用详细的名称来声明变量,详细的名称描述了变量的用法。提示:php不遵循以下做法:)