有没有理由不对类属性进行分组？

Question

我使用docblocks来输入类属性，并且最近才意识到类属性可以这样分组：

    /**
     * @var string
     */
    private $firstname, $surname, $location;

这比以下更容易阅读和更短：

    /**
     * @var string
     */
    private $firstname;

    /**
     * @var string
     */
    private $surname;

    /**
     * @var string
     */
    private $location;

有没有理由不这样做？

Answer 1

我更喜欢第一种方法，因为PSR-2 says＆＃34;每个语句不得超过一个属性。＆＃34;。这有很好的理由，这里有一些我的想法，我猜PSR-2的作者也有：

• 人们不希望每行看到多个声明（至少我和我的同事）;
• 更改变量的类型比较困难，例如$location从字符串到位置类。
• 读取差异更加困难：如果任何变量的名称发生变化，则该行将被标记为已更改，并且审阅者必须阅读整行。这种线有更高的改变概率;
• 从组中评论单个变量并不容易。