Anything better than PHPDoc out there?

Question

Does anybody use anything else to document their PHP code than PHPDoc? Are there any tools that read the same documentation syntax but give richer output?

Please precise 'richer output'. Otherwise it's difficult to give precise answer. — Paweł Hajdan, Sep 19 '08 at 13:20
What problems are you having with 5.3? (Also, running the doc generator via the command line version of PHP (with a custom ini with a larger memory allocation if necessary) would probably resolve the memory issue. — John Parker, Jan 21 '10 at 20:37
From what I understand of the situation, phpDocumentor does not support namespaces. The memory issue is one I'm sure they've tried, though I could double check. — user256162, Jan 21 '10 at 21:51
@user256162 It works with PHP 5.3, but all classes go to default package. I expected it to treat namespaces like packages. Anyone managed to do this? — umpirsky, Feb 03 '11 at 22:11

score 19 · Accepted Answer · answered Sep 20 '08 at 08:29

I´ll go for doxygen too.

Here are several reasons :

compatible with phpdoc tags and other popular ones : it´s interoperable
works with various programming languages : a better time investment
there is alternative syntaxes : can choose the commenting style that suit you
very efficient with advanced formating / tagging / metadata
there is a GUI that is not linked to any IDE and an eclipse plugin as well

And still free, multiplatform, and open source :-)

It´s easy to learn, but harder that phpdoc because a lot richer.

score 8 · Answer 2 · answered May 11 '11 at 19:36

You could try DocBlox; which is intended to be an alternative for phpDocumentor but with support for additional features of which full PHP 5.3 support is one. An additional benefit is that is it quite fast and uses relatively little memory.

You can read more on http://www.docblox-project.org or see a demo at http://demo.docblox-project.org/default

score 7 · Answer 3 · edited Mar 24 '19 at 14:49

7

Another option other than phpDocumentor is Doxygen documentation with PHP support.

edited Mar 24 '19 at 14:49

albert

8,285
3
19
32

answered Jan 21 '10 at 20:39

Yada

30,349
24
103
144

You know know if the memory footprint of Doxygen is smaller than that of phpDocumentor? Thanks! – user256162 Jan 21 '10 at 21:58
1

To answer my own question, Doxygen is able to be pointed at much larger portions of our codebase than phpDocumentor. – user256162 Jan 29 '10 at 19:55

score 5 · Answer 4 · edited Sep 20 '08 at 08:30

5

Doxygen (www.doxygen.org).

edited Sep 20 '08 at 08:30

Polsonby

22,825
19
59
74

answered Sep 19 '08 at 11:18

Roel

19,338
6
61
90

score 3 · Answer 5 · edited Dec 23 '18 at 10:35

3

I've not used it with PHP, but doxygen claims to support the language.

edited Dec 23 '18 at 10:35

albert

8,285
3
19
32

answered Jan 21 '10 at 20:39

GreenMatt

18,244
7
53
79

score 3 · Answer 6 · answered Dec 31 '11 at 19:52

3

ApiGen

http://apigen.org/

ApiGen has support for PHP 5.3 namespaces, packages, linking between documentation, cross referencing to PHP standard classes and general documentation, creation of highlighted source code and experimental support for PHP 5.4 traits.

DocBlox

http://www.docblox-project.org/

PHP 5.3 compatible API Documentation generator aimed at projects of all sizes and Continuous Integration.

able to fully parse and transform Zend Framework 2

answered Dec 31 '11 at 19:52

M A Hossain Tonu

1,437
15
14

http://apigen.org is lovley and I've been using that now. It supports namespaces and has a lovely code output too. Here's my ant config for it: ` ` – Jujhar Singh Jul 29 '12 at 19:06

score 2 · Answer 7 · answered Sep 20 '08 at 08:45

2

I am using Doxygen too - you get used to the various keywords really fast - they are kind of self-explaining. ;)

RubyDoc is nice too, I espcially like they layout of the rdocs.

answered Sep 20 '08 at 08:45

unexist

2,518
23
27

score 2 · Answer 8 · answered Feb 25 '11 at 03:45

2

Doctrine uses PHPDoctor, which appears to work well with 5.3 in my tests.

http://peej.github.com/phpdoctor/#download

answered Feb 25 '11 at 03:45

KevBurnsJr

4,869
2
25
16

+1 for PHPDoctor - it works amazingly well. – Jonathan Chan Aug 14 '11 at 03:12

score 1 · Answer 9 · edited Oct 26 '11 at 03:09

1

If you need to document code for PHP 5.3+, eg. if it uses namespaces Ted Kulp's fork of PHPDoctor might be your answer.

edited Oct 26 '11 at 03:09

Peter O.

32,158
14
82
96

answered Oct 25 '11 at 13:38

h00ligan

1,471
9
17

Anything better than PHPDoc out there?

9 Answers9

ApiGen

DocBlox

Linked

Related