PHP Zend Framework 编码标准，哪种方法更具可读性？

Question

这是一个主观问题，我需要您对编码标准和格式实践的感受和想法。

PHP Zend 编码标准要求像这样编写多行函数调用:

$returnedValue = $object->longMethodName(
    $argument1,
    $otherArgument,
    42
);

我认为下面的方法更具可读性:

$returnedValue = $object->longMethodName($argument1,
                                         $otherArgument,
                                         42);

因为左边只有一行，说明这只是一条语句，参数更接近方法名。

您更喜欢哪一个？

Answer 1

第二种方法给您留下了一个额外的问题:行长度。 Zend 编码标准建议“任何一行 PHP 代码的最大长度为 120 个字符。”

这意味着，如果您想要好的(长的、描述性的)变量名称，并且您恰好有一个用于返回值、对象、一个好的命名函数和一个长参数，您更有可能达到 120 个字符的限制。

除此之外，根据您的标准，最大长度可能只有 80 个字符或介于两者之间。

此外，如果反复使用，我更喜欢第一个

$returnedValue = $object->longMethodName(
    $argument1,
    $otherArgument,
    42
);
$returnedValue = $object->longMethodName(
    $argument1,
    $otherArgument,
    42
);
$returnedValue = $object->longMethodName(
    $argument1,
    $otherArgument,
    42
);
$returnedValue = $object->longMethodName(
    $argument1,
    $otherArgument,
    42
);

$returnedValue = $object->longMethodName($argument1,
                                         $otherArgument,
                                         42);
$returnedValue = $object->longMethodName($argument1,
                                         $otherArgument,
                                         42);
$returnedValue = $object->longMethodName($argument1,
                                         $otherArgument,
                                         42);
$returnedValue = $object->longMethodName($argument1,
                                         $otherArgument,
                                         42);

就像 Pekka 所说的那样，少跳眼。