komentarze jako typy zmiennych

ostatnio spotkałem się z pewnym kodem gdzie zmienne były deklarowane w ten sposób:

protected /* string */ foo = ...
protected /* int */ bar = ...
protected /* array[]string */ foobar = ...

czy jest to normalna praktyka w php? bo z takim czymś się jeszcze nie spotkałem a może jestem zbyt krótko w tym języku

To jest pewien standard i wykorzystywane to jest np. przez phpDocumentatora, takiego narzędzia do tworzenia dokumentacji, np.:

 /**
   * Jeżeli tak, prezesyłka jest płatna przy odbiorze..
   * 
   * @var boolean 
   */
 protected $COD = true;

i później, po wygenerowaniu dokumentacji masz informacje o zmiennej $COD w jakiejś klasie - jakiego jest typu (boolean) i do czego służy.

Raczej korzysta się z @var, a nie pisze protected /* int */ $foo.

Można użyć @property ale nie trzeba, bo stosuje się raczej do magicznych metod __get() i __set(), zamiast tego właściwszy jest @var, pełna lista tagów PHPDoc-a:

http://docs.phpdoc.org/references/phpdoc/index.html

Polecam używać PHP 7.0+ i korzystać z type hintów tam gdzie można, będzie bezpieczniej, szybciej i php doc nie będzie potrzebny to opisywania typów :)