Как объявить волшебное свойство устаревшим в PHPDoc? ⇐ Php

[Anonymous]

Есть ли способ пометить магическое свойство как устаревшее? Рассмотрим следующий упрощенный код:

Код: Выделить всё

/**
* Example class
*
* @property string $foo A foo variable.
*/
class Example {
/**
* Magic getter
*/
public function __get($var) {
if('foo' === $var) {
// do & return something
}
}
}

Теперь, как указать другим разработчикам, что им больше не следует использовать example::$foo? Единственное рабочее решение, которое мне приходит на ум:

Код: Выделить всё

/**
* Example class
*/
class Example {
/**
* A foo variable.
*
* @var string
* @deprecated
*/
public $foo;

/**
* Magic getter
*/
public function __get($var) {
if('foo' === $var) {
// do & return something
}
}
}

Но это нарушает мой код (геттер не вызывается) и выглядит не очень элегантно.

Подробнее здесь: https://stackoverflow.com/questions/375 ... -in-phpdoc