Is there any replacement for PHPDocumentor that supports PHP 5.3?
Asked Answered
C

5

22

Some of the new PHP 5.3 features, including namespaces and anonymous functions, are not compatible with PHPDocumentor, even with the latest release. For example, it just raises an error when it encounters "a function with no name", i.e. a closure. So, are there any other open-source tools that generate API documentation (preferably in HTML) from Javadoc-style comments in PHP 5.3 code?

Conlen answered 14/2, 2010 at 11:43 Comment(2)
Maybe Doxygen https://mcmap.net/q/527474/-anything-better-than-phpdoc-out-there-closedLuminiferous
Doxygen manages to finish creating the documentation, but the result is still nonsensical. It doesn't seem to parse the namespace declarations correctly, nor does it distinguish closure declarations from function calls.Conlen
C
11

Well, I've found PHPDoctor, which works pretty well with PHP 5.3. Although, I'd be still interested if anyone found something better, so I'm not closing the question.

Conlen answered 15/2, 2010 at 19:46 Comment(2)
My only regret is that I have but one vote to give!! I've been searching and searching for something that actually supported PHP5.3 and now I've found it!!Moncada
Being fed up with PHPDocumentor on PHP5.3, I had PHPDoctor installed, configured, and full documentation generated 10 minutes after learning it existed. Nice.Tia
L
14

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

Landgrabber answered 11/5, 2011 at 19:27 Comment(1)
Update: As of March 2012 has phpDocumentor and DocBlox merged into phpDocumentor2Landgrabber
C
11

Well, I've found PHPDoctor, which works pretty well with PHP 5.3. Although, I'd be still interested if anyone found something better, so I'm not closing the question.

Conlen answered 15/2, 2010 at 19:46 Comment(2)
My only regret is that I have but one vote to give!! I've been searching and searching for something that actually supported PHP5.3 and now I've found it!!Moncada
Being fed up with PHPDocumentor on PHP5.3, I had PHPDoctor installed, configured, and full documentation generated 10 minutes after learning it existed. Nice.Tia
H
6

Check ApiGen API documentation generator with PHP 5.3 support

Hygienics answered 1/3, 2011 at 10:58 Comment(0)
I
1

YUI Doc is language agnostic. It could be used. Here's a video describing its use: http://developer.yahoo.com/yui/theater/video.php?v=woods-yuiconf2009-yuidoc

Ithunn answered 15/2, 2010 at 20:5 Comment(0)
K
1

This was already mentioned in a comment by @mvriel, but I'll make it an answer: phpDocumentor's successor is phpDocumentor 2. From its website:

phpDocumentor 2 is build to generate API documentation for all features available in PHP 5.3 and higher.

phpDocumentor 2 is the result of the merge between phpDocumentor and DocBlox. From the merge announcement in DocBlox's website:

Announcing phpDocumentor 2 – the merging of the old (phpDocumentor) and the new (DocBlox).

...

Old phpDocumentor is retiring. Some bugfix effort may continue into bringing phpDocumentor 1.x to a close, but most effort going forward will be spent on 2.x.

It's still in alpha stage (as of 2013-04-01), but usable.

Kersey answered 1/4, 2013 at 23:9 Comment(0)

© 2022 - 2024 — McMap. All rights reserved.