Php 是否有任何理由不将类属性分组?

Php 是否有任何理由不将类属性分组?,php,coding-style,Php,Coding Style,我使用docblocks键入提示类属性,直到最近才意识到类属性可以按如下方式分组: /** * @var string */ private $firstname, $surname, $location; 以下哪种方式更容易阅读,也更简短: /** * @var string */ private $firstname; /** * @var string */ private $s

我使用docblocks键入提示类属性,直到最近才意识到类属性可以按如下方式分组:

    /**
     * @var string
     */
    private $firstname, $surname, $location;
以下哪种方式更容易阅读,也更简短:

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

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

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

有什么理由不这样做吗?

我更喜欢第一种方法,因为PSR-2“每个语句声明的属性不能超过一个”。这有很好的理由,以下是我的一些想法,我猜PSR-2的作者也有:

  • 人们不希望每行看到一个以上的声明(至少我和我的同事)
  • 将变量的类型(例如,
    $location
    的类型)从字符串更改为位置类更为困难
  • 更难阅读差异:如果任何变量的名称发生变化,该行将被VCS标记为已更改,并且审阅者将不得不阅读整行内容。这种线路有较高的变化概率
  • 对一个组中的单个变量进行注释并不容易

可能是关于使用什么变量的注释。我真的很讨厌99,9%的变量注释。类型+名称应该足够了。如果不是的话,你可能把它命名错了。某些东西是品味和个人喜好的问题。如果您发现您的第一个示例适合您的用例,那么没有理由不使用它。有些人更喜欢第二种方法,有些人更喜欢第一种方法。这完全由你来决定你想用什么。为什么投票结果很接近?这种风格是否适合你是基于意见的,但我只是想看看我是否忽略了一些不同性质的东西。