PHP项目中缺少方法实现

Question

Recently I got someones PHP site project (and this someone don't wan't to help me), so I have to understand his code. And maybe my answer would be stupid, but...

But there's some methods before class, that are doxumented as in example:

namespace Base\Classes;

/**
 * @method int method1()
 * @method $this method2(int $parameter)
 */

class SomeClass extends ParentClass
{
    public $_s_a = false;
    public $_user_roles = [];

    public function SomeClassMethod() {
        somethingDone();
    }
}

And as you can see in this example, these documented methods are not implemented in defined class. But what my question is about - this methods are called from another classes and templates. And PHPStorm (my IDE) connects this documentation lines with calls, and ctrl+B leads from between references. But I can't find exact implementation of this methods. They cannot be found in parent classes, they are not in this file. And I thought maybe this is some syntax sugar that I'm not familiar with. Am I right? Or there something I'm missing, and all implementations somewhere in another place? (search by method name in folder gives nothing for me)

Answer 1

PHP has a few magic methods, and one of them is __call().

When you have an object that implements __call() (by itself or by one of the parent classes), you may call an inaccessible method on it, and the __call() method will be called instead. This happens, for example, when you call a private method from the outside, or when you call a method that was not defined in code.

When you use such calls to inaccessible methods, IDEs will most likely show a warning that the method does not exist, although the code itself will probably work at runtime. These warnings are quite annoying, so you can add a @method tag to your class, and the IDE will know that this method exists, and will not show a warning.

So, to support the code that you got from someone, take a look at the __call() method implementation. Be aware that this method may be implemented in one of the parent classes, so check them out as well.