마법 필드가있는 IntelliJ/PhpStorm 인라인 @var

Question

PHPDoc 인라인 @var 올바른 유형을 설정하기 위해 마법 필드 변수를 정의하려고하지만 IDE가 자동 완성 기능을 사용하지 않습니다.

"마법 필드를 통해 접근하는 필드"를 보여줍니다. 검사 설정에서 제거하려고했지만 경고가 표시되지 않고 계속 자동 완성되지 않습니다. 나는 새로운 변수를 정의하면 작동됩니다

/** @var \NameSpace\SomeClass $this->field */ 
$this->field->someMethod(); // Not auto-completing 

/** @var \NameSpace\SomeClass $this::field */ 
$this->field->someMethod(); // Not auto-completing 

반면의 경우 :

내가 성공하지 않고 다른 방법을 시도

$field = $this->field; 

/** @var \NameSpace\SomeClass $field */ 
$field->someMethod(); // Auto-completing correctly 

누군가는 자동을 작동하도록하는 방법을 알고 새로운 변수를 정의하지 않고 기능을 완성합니까? 가능한가?

업데이트 : $ field는 (는) 항상 주 클래스의 동일한 클래스가 아니므로 @property 특성을 사용할 수 없습니다.

Answer 1

클래스 수준의 PHPDoc 코멘트에 @property 태그를 사용하여 입력해야합니다.

https://docs.phpdoc.org/references/phpdoc/tags/property.html

---

/** @var \NameSpace\SomeClass $this->field */ 

/** 
* My special class 
* 
* @property \NameSpace\SomeClass $field Optional my magical variable description 
*/ 
class MySpecialClass { 
.... 

이 작동하지 않습니다 - 당신은 인라인 @var를 사용하여 2 레벨의 변수/요소 ( $this->field)에 대한 typehint를 제공 할 수 없습니다. 첫 번째 레벨 엔티티 만 유형을 지정할 수 있습니다.

Answer 2

인라인 @var (thank to @LazyOne)을 사용하여 2 차 변수/요소 ($ this-> field)에 유형 힌트를 제공 할 수 없습니다.

그래서 가능한 솔루션은 메인 클래스에서 사용하는 모든 클래스와 @property 설정됩니다 :이 방법으로

/** 
* My special class 
* 
* @property \NameSpace\SomeClass|OtherSomeClass|OneMore $field 
*/ 
class MySpecialClass { 

에게 마법 필드 $field를 자동으로 완성 정의 된 모든 클래스의 모든 방법이 될 것입니다.