Allow configuring custom PHPDoc tags that reference classes

[ruudk]

In our project we use a custom PHPDoc tag @throwable-from paired with a PHPStan rule that validates the referenced class and method exist. For example:

    /**
     * @throwable-from NotificationHandler::createPayload
     * @throwable-from UserSpecificPayloadNotificationHandler::createPayloadForUser
     */
    final class MessageShouldBeIgnoredException extends Exception

Rector's unused import removal does not recognize class references in custom PHPDoc tags and removes the corresponding use statements. The class resolver in PhpDocTagGenericUsesDecorator was hardcoded to only @uses, @used-by, and @see.

This adds a configurable list of additional PHPDoc tag names that should be treated as containing class references, so their imports are preserved:

    RectorConfig::configure()
        ->withPhpDocTagsWithClassReference(['@throwable-from']);

/cc @samsonasik

[TomasVotruba]

I'd prefer generic solution that would not require configuration per project.

[ruudk]

How would you like to do that with a custom phpdoc like this? I believe this was done for performance reasons?

[samsonasik]

I am on mobile, how about just remove the : if (! in_array() check? The next line already check on explode on :.

This of course need to verify other decorator that doing similar logic on different docblock node to avoid overwritten.

[ruudk]

Yeah i think that would be fine too!