자동으로 PHPDoc에 힘내 버전 추가하기

Question

파일/저장소에 대한 Git 버전을 주석 블록에 삽입하는 방법을 아는 사람이 있는지 궁금해서 PHP 문서가 문서 생성시이를 자동으로 반영 할 수 있습니까?

Answer 1

프로젝트의 최신 버전을 찾을 수있는 phing 스크립트를 만들 수 있습니다. 토큰을 각 파일/선택된 파일의 버전으로 대체하십시오. 당신이 버전을 svn을 이름으로 토큰을 넣어 원하는 위치

예를 들어 파일에서

<svnlastrevision workingcopy="${path.to.project.dir}" propertyname="svn.lastrevision" /> 

를 최신 SVN 버전을 얻을 당신이 스크립트

에게

를 phing에 (나는 SVN 예제를 사용했다) @svn.lastrevision@

다음 코드는 버전 번호와이 토큰을 대체 할

<!-- Apply the version change to all files. --> 
     <reflexive> 
      <fileset dir="${dir.to.change.version}"> 
       <include name="**/*.*" /> 
      </fileset> 
      <filterchain> 
       <replacetokens> 
        <token key="svn.lastrevision" value="${svn.lastrevision}" /> 
       </replacetokens> 
      </filterchain> 
     </reflexive> 

Answer 2

phpDocumentor는 그 정보를 문서에 넣는 것이 아니라 이미 문서 블록에 표시해야합니다.

코드 블록 (일명 "키워드 확장")을 체크 아웃하면 CVS 및 SVN에 의해 ​​자동으로 채워지는 docblock에 $ Id $ 태그를 사용하는 것처럼 들리는 것 같습니다.

힘내네도 허용됩니다. - https://git-scm.com/book/en/v2/Customizing-Git-Git-Attributes#_keyword_expansion.