Generic PHPDoc support

[Hornet-Wing]

Would it be possible to support Generic PHPDocs?

For example:

class Zoo
{
    /** @var Animal[] */
    public $animals;
}

would be:

class Zoo
{
    /** @var array<Animal> */
    public $animals;
}

[cweiske]

Is that only for arrays, or are there other types that need to be handled differently?
Also, where do you get that from? Any official sources for that type of array definition?

[dktapps]

Not sure about Psalm docs, but PHPStan implements generics which are mostly equivalent to Psalm's: https://phpstan.org/blog/generics-in-php-using-phpdocs

[Hornet-Wing]

Yes, that is correct. I was looking at PHPStan's implementation, but mostly just for array annotation.

[cweiske]

When looking at https://phpstan.org/blog/generics-in-php-using-phpdocs#these-rules-are-useful%2C-but-sometimes-limiting it gets complicated:

/**
 * @template T of Message
 */
interface Consumer
{
  /**
   * @param T $message
   */
  function consume(Message $message);
}

/**
 * @implements Consumer<SendMailMessage>
 */
class SendMailMessageConsumer implements Consumer
{
	function consume(Message $message) { ... }
}

This means that JsonMapper would need to fetch and combine information from different classes in complicated ways.
I will not do that.

Patches welcome, but I guess they complicate the code a lot, for little gain in my eyes. So I'll probably reject them.