php - 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将魔法属性定义为只读。