Are PHPDoc fields from the stub overrides corresponding PHPDocs from the original class?

[VBelozyorov]

I've read the docs, but still have one question.

Are corresponding PHPDoc fields from stub and class somehow merging together, or PHPDoc from the stub completely overrides PHPDoc from the class?

For example, is it expected that PHPStan warns about MyClass::someMethod() is undefined in the following case?

MyClass.php:

/**
 * @method void someMethod()
 */
class MyClass 
{
    public function __call(string $name, array $args)
    {
        // …
    }

    public function realMethod(): bool
    {
        return true;
    }
}

MyClass.stub

/**
 * @property string $someProp
 */
class MyClass 
{
}

[ondrejmirtes]

Stubs are not merged, if you override the PHPDoc on the top of the class, the one from the stub file is going to be used. But of course if the original class has a different PHPDoc for example above some property, and you don't override that one in the stub, the original one is going to be used.

[VBelozyorov]

Thanks for so quick reply!

And following is also useless in case if $someProp wasn't defined inside class itself, right?

MyClass.stub:

class MyClass 
{
    /** @var string */
    public $someProp;
}

[ondrejmirtes]

This stub is only useful if the original class for example looks like this and you want to fix int to string:

class MyClass 
{
    /** @var int */
    public $someProp;
}

[rudiedirkx]

This doesn't seem to be true (anymore). I have a stub for many classes, eg StripsLog with many @property doc. And the real StripsLog has a few @property doc. When I run phpstan, it finds all the stub properties, but not the real class properties. If I copy or move the real class properties to the sub file, phpstan finds them. They're different properties, not overrides.

[rudiedirkx]

But of course if the original class has a different PHPDoc for example above some property, and you don't override that one in the stub, the original one is going to be used.

Waaait, you mean per property, not the class phpdoc. So the entire class phpdoc is used from only 1 source? I can't have a few properties in the real class and a few other properties in the stub?