PHP中的property注解是一種非常方便的編程方法，它允許您在類中定義用戶定義的元數據標記。這些標記用于表示代碼中的元素和狀態，例如類成員變量和方法。

舉個例子，假設您正在編寫一個web應用程序來處理用戶評論。您想跟蹤哪些評論已被批準，哪些正在等待批準。你可以在類定義中使用@property標記來清晰地表達這種狀態：

class Comment {
/**
* @var boolean
* @property-read
*/
protected $approved = false;
/**
* @var boolean
* @property-read
*/
protected $pending = false;
/**
* Sets the comment as approved.
* @return void
*/
public function approve(){
$this->approved = true;
$this->pending = false;
}
/**
* Sets the comment as pending.
* @return void
*/
public function setPending(){
$this->approved = false;
$this->pending = true;
}
}

在這個例子中，我們使用了兩個boolean屬性(@var) - $approved和$pending，并用@property-read標記來表明這兩個屬性只能通過類中的方法進行修改。

但是，請注意，只為屬性添加@property標記是不夠的。你還需要在類中的其他地方使用這些注解來告訴編譯器關于這些屬性的細節。例如：

class CommentController {
/**
* @param Comment $comment
* @return void
*/
public function markAsApproved(Comment $comment){
$comment->approve();
}
/**
* @param Comment $comment
* @return void
*/
public function markAsPending(Comment $comment){
$comment->setPending();
}
}

在這里，我們在方法的文檔注釋中使用了類本身的注解，并且使用了這些注解來幫助說明每個處理程序要完成的工作。這使得代碼更加可讀，更容易理解和維護。

我們還可以使用@property標記來指定一些其他的元數據，例如默認值或者特定的序列化規則：

class User {
/**
* @var int
* @default 0
*/
protected $age;
/**
* @var string
* @serializer json_encode
*/
protected $bio;
}

在這個例子中，@default和@serializer都是部分標準的property注解，它們告訴編譯器有關每個屬性的默認值和序列化規則。

總的來說，php property注解是一個強大的工具，可以幫助您在PHP應用程序中更好地定義和管理元數據。如果您一直在使用注釋來記錄類和屬性的狀態，那么property注解可能會讓您的編碼生活更加簡單和舒適。