PHPDoc보다 더 나은 것이 있나요?[닫은]
-
01-07-2019 - |
문제
누구든지 자신의 문서를 문서화하기 위해 다른 것을 사용합니까? PHP
코드보다 PHPDoc?
동일한 문서 구문을 읽으면서 더 풍부한 출력을 제공하는 도구가 있습니까?
해결책
저도 doxygen 사러 가겠습니다.
다음은 몇 가지 이유입니다.
- phpdoc 태그 및 기타 널리 사용되는 태그와 호환됩니다.상호 운용 가능
- 다양한 프로그래밍 언어와 함께 작동합니다.더 나은 시간 투자
- 대체 구문이 있습니다.자신에게 맞는 댓글 스타일을 선택할 수 있습니다
- 고급 형식 지정/태그 지정/메타데이터를 사용하면 매우 효율적입니다.
- IDE와 Eclipse 플러그인에 연결되지 않은 GUI도 있습니다.
그리고 여전히 무료, 멀티플랫폼, 오픈 소스입니다 :-)
배우기는 쉽지만 훨씬 더 풍부하기 때문에 phpdoc보다 어렵습니다.
다른 팁
DocBlox를 사용해 볼 수 있습니다.이는 phpDocumentor의 대안으로 고안되었지만 전체 PHP 5.3 지원 중 하나인 추가 기능을 지원합니다.추가적인 이점은 매우 빠르며 상대적으로 적은 메모리를 사용한다는 것입니다.
자세한 내용은 다음에서 확인할 수 있습니다. http://www.docblox-project.org 또는 다음에서 데모를 확인하세요. http://demo.docblox-project.org/default
독시젠(www.doxygen.org).
APIGen
ApiGen은 PHP 5.3 네임스페이스, 패키지, 문서 간 연결, PHP 표준 클래스 및 일반 문서에 대한 상호 참조, 강조 표시된 소스 코드 생성 및 PHP 5.4 특성에 대한 실험적 지원을 지원합니다.
DocBlox
http://www.docblox-project.org/
모든 규모의 프로젝트와 지속적인 통합을 목표로 하는 PHP 5.3 호환 API 문서 생성기입니다.
Zend Framework 2를 완전히 구문 분석하고 변환할 수 있습니다.
Doctrine은 PHPDoctor를 사용하는데, 내 테스트에서는 5.3에서 잘 작동하는 것으로 나타났습니다.
PHP에서는 사용해본 적이 없지만 독산소 언어를 지원한다고 주장합니다.
PHP 5.3+용 코드를 문서화해야 하는 경우, 예를 들어 다음과 같습니다.Ted Kulp의 네임스페이스를 사용하는 경우 PHPDoctor의 포크 당신의 대답이 될 수도 있습니다.