PHPDOCS中`@ property`和`@ property-read`有什么区别？

Question

我看到了魔法属性的两种不同实现。

<?php

/**
 * @property string first_name
 * @property-read string last_name
 */
class Demo
{
    // Code...
}

@property和@property-read命名约定之间有什么区别？

Answer 1

phpDocumentor文档非常清楚地解释了这一点：

http://www.phpdoc.org/docs/latest/references/phpdoc/tags/property-read.html

@property和@ property-read（以及@ property-write）用于记录可通过魔术方法__get()和/或__set()访问的魔术属性。

不同之处在于@ property-read将magic属性定义为只读。