phpDocumentor

2012 年 10 月 27 日6310

What is phpDocumentor 2?

phpDocumentor 2 is a tool with which it is possible to generate documentation from your PHP source code. With this

documentation you can provide your consumers with more information regarding the functionality embedded within

your source and not only what is usable to them from your user interface.

Documentation generated by phpDocumentor 2 does not aim to be a replacement for conventional documentation but

is rather supplemental, or reference, documentation.

This documention can prove to be very useful in the following, example, situations:

High performance

phpDocumentor 1 needs 220 seconds to generate documentation for

phing.

A bare phpDocumentor 2 run needs

120 seconds and with optimalizations this can even be reduced to less than

90 seconds!

Template System

phpDocumentor 2 contains an incredibly flexible template system which enabled you to alter your output in any

way imaginable. This can range from simply applying your own branding for the HTML output by merely altering

a couple of CSS files to determining which types of output are generated and where they are made available.

Reports & Charts

phpDocumentor 2 is capable of extracting interesting information and present those in the form of graphs and

reports. The following are currently supported:

This list will only grow in the future to help you determine where to invest your resources in order to make

your code more stable and maintainable.

Plugins

phpDocumentor 2 is build with extendability in mind. Using ideas from Aspect Oriented Development (AoP)

that are powered by the Event Dispatcher by symfony are phpDocumentor 2 Plugins one of the more powerful

tools in the toolset.

0 0