상수에 대해 PHPDocs를 올바르게 기술하는 방법은 무엇입니까?

코드는 다음과 같습니다. /** * Days to parse * @var int */ const DAYS_TO_PARSE = 10; … 나는 그것을 사용한다고 생각하지 않는다.@var상수에 대해 정확하고, 어떤 것도 보이지 않습니다.@constantPHPDoc 태그올바른 방법은 무엇입니까? 질문에 대한 답변 PHP-FIG는 다음을 권장합니다.@var상수의 경우. 7.22.@var 를 사용할 수 있습니다.@var태그를 사용하여 다음 “구조 요소”의 “유형”을 기록합니다. 클래스 및 글로벌 범위 모두 상수 … Read more

PHPDoc에서 어레이 옵션을 문서화하는 가장 좋은 방법

함수에 전달되는 어레이 옵션의 멀티 트리 구조를 설명하는 읽기 쉽고 이해하기 쉬운 문서를 작성하는 데 어려움을 겪고 있습니다. 다음은 어레이 구조의 예입니다. $arr = [ ‘fields’ => [ ‘title’ => [ ‘name’ => ‘Document.title’, ‘format’ => ‘string’, ‘readonly’ => true ] ] ]; 위의 배열에는 여러 가지 옵션이 있지만, 이 옵션은 해당 구조를 인식하는 함수의 … Read more

Netbeans(PHP)에서의 변수형 힌트

netbean에 정규 변수에 대한 유형 힌트를 줄 수 있는 방법이 있는지 궁금해서 인텔리센스가 이를 포착할 수 있습니다.클래스 속성, 함수 매개 변수, 반환 유형 등에 대해 수행할 수 있지만 일반 변수에 대해 수행할 방법을 찾을 수 없습니다.이것은 다른 오브젝트 타입(서비스 로케이터 등)을 반환할 수 있는 메서드가 있는 경우에 매우 도움이 됩니다. 예를 들어 다음과 같습니다. /** … Read more

PHP 함수 주석

PHP 함수가 상단에 코멘트되어 있는 것을 알 수 없는 포맷을 사용하고 있는 것을 보았습니다. /** * * Convert an object to an array * * @param object $object The object to convert * @return array * */ IDE에 의해 @param이나 @return 등의 드롭다운 선택이 가능하기 때문에 어딘가에 문서화해야 합니다.구글을 검색해 봤는데 @ 기호가 검색되지 않아요. … Read more

오브젝트 배열에 대한 PPDoc 유형 힌트

따라서 PHPDoc에서는 다음을 지정할 수 있습니다.@var멤버 변수 선언 위에 해당 유형을 암시합니다.그러면 PHPEd와 같은 IDE는 어떤 유형의 오브젝트로 동작하고 있는지 알고 해당 변수에 대한 코드 통찰력을 제공할 수 있습니다. <?php class Test { /** @var SomeObj */ private $someObjInstance; } ?> 나중에 오브젝트를 반복할 때 적절한 힌트를 얻을 수 있도록 오브젝트 배열에 대해 같은 작업을 … Read more