Class @method not take precedence

Ray

Take a look at the over simplified example below. Basically the @method should override any method signatures for the class and they are not. In this case the the following warning is produced:

Argument '1' passed to setWeekdays() is expected to be of type null|string, array givenPHP(PHP0406)

Example:

/**
 * @method static setWeekdays(string[] $weekdays)
 */
class Event {
  
  /**
  * @return static
  * @param string|null $value
  */
  public function setWeekdays($value) {
    return $this->setDboValue("weekdays", $value);
  }
  
  public function doSomething() {
    $this->setWeekdays([]);
  }
}

JakubMisek

Thank you for the suggestion.

Actually @method is meant for documenting "magic" methods inside the class - i.e. those handled by the magic __call and __callStatic methods.

In the example above, the use of @method is unnecessary. Also, it is ambiguous and does not make much sense, since it documents the same method twice.

Is there any reason, the actual PHPDoc for setWeekdays is documented incorrectly?