2010-02-14 13 views
22

Niektóre z nowych funkcji PHP 5.3, włączając przestrzenie nazw i anonimowe funkcje, nie są kompatybilne z PHPDocumentor, nawet z najnowszą wersją. Na przykład, po prostu wywołuje błąd, gdy napotyka "funkcję bez nazwy", tj. Zamknięcie. Czy są jakieś inne narzędzia open-source, które generują dokumentację API (najlepiej w HTML) z komentarzy w stylu Javadoc w kodzie PHP 5.3?Czy istnieje zastępstwo dla PHPDocumentor obsługujące PHP 5.3?

+0

* Może * 'Doxygen' http://stackoverflow.com/questions/2112654/php-5-3-documentor – mre

+2

Doxygen udaje się zakończyć tworzenie dokumentacji, ale wynik jest nadal bezsensowny. Wydaje się, że nie poprawnie analizuje deklaracji przestrzeni nazw, ani nie rozróżnia deklaracji zamknięcia od wywołań funkcji. –

Odpowiedz

11

Cóż, znalazłem PHPDoctor, który działa całkiem dobrze z PHP 5.3. Chociaż nadal byłbym zainteresowany, gdyby ktoś znalazł coś lepszego, więc nie zamykam pytania.

+0

Żałuję tylko, że mam tylko jeden głos do oddania !! Szukałem i szukałem czegoś, co faktycznie obsługuje PHP5.3, a teraz znalazłem to !! –

+0

Mam dość PHPDocumentora na PHP5.3, miałem zainstalowany PHPDoctor, skonfigurowałem i wygenerowałem pełną dokumentację 10 minut po tym, jak się nauczyłem. Miły. – Eli

3

Osobiście oceniam Doxygen. To przyjemny system dokumentacji obsługujący wiele języków i kilka formatów wyjściowych.

14

Można spróbować DocBlox; który ma być alternatywą dla phpDocumentor, ale z obsługą dodatkowych funkcji, których pełne wsparcie PHP 5.3 jest jedno. Dodatkową korzyścią jest to, że jest dość szybki i zużywa stosunkowo mało pamięci.

można przeczytać więcej na http://www.docblox-project.org lub zobacz demo na http://demo.docblox-project.org/default

+3

Aktualizacja: od marca 2012 r. PhpDocumentor i DocBlox zostały połączone w phpDocumentor2 – mvriel

0

To już wspomniano w komentarzu przez @mvriel, ale zrobię to odpowiedź: następca PhpDocumentor jest phpDocumentor 2. Ze strony internetowej:

phpDocumentor 2 jest zbudowany w celu generowania dokumentacji API dla wszystkich funkcji dostępnych w PHP 5.3 i nowszych.

phpDocumentor 2 to wynik połączenia phpDocumentora z DocBlox. Z merge announcement w witrynie DocBlox za:

Ogłaszając PhpDocumentor 2 - łączących się ze starego (phpDocumentor) i nowy (DocBlox).

...

Stary phpDocumentor przechodzi na emeryturę. Niektóre poprawki błędów mogą w dalszym ciągu doprowadzić do zamknięcia phpDocumentor 1.x, ale większość wysiłków będzie przeznaczona na 2.x.

Jest nadal w fazie alfa (stan na 2013-04-01), ale można go używać.

Powiązane problemy