PHPDoctor: The PHP Documentation Creator

aka Peej's Quick & Dirty PHPDoc Clone

PHPDoctor is a Javadoc style comment parser for PHP, written with an emphasis on speed and simplicity. It is designed to be as close a clone to Javadoc as possible.

Installation

You can clone it from Github but you're better off using Composer to install it within your project:

{
    require: "peej/phpdoctor": "2.0.5"
}

Then run Composer:

$ curl -s https://getcomposer.org/installer | php
$ composer.phar install

And then if everything went according to plan, run PHPDoctor with it's default configuration:

$ bin/phpdoc

Configuration

PHPDoctor will run with default options that will process all *.php files within and below the current directory, unless you provide a configuration file.

Configuration is done via a PHP style ini file. If there's a file called phpdoctor.ini in the current directory, PHPDoctor will use this, alternatively you can pass in the name of a configuration as the first commandline option.

PHPDoctor supports a number of configuration directives:

• files - Names of files to parse. This can be a single filename, or a comma separated list of filenames. Wildcards are allowed.

• ignore - Names of files or directories to ignore. This can be a single filename, or a comma separated list of filenames. Wildcards are NOT allowed.

• source_path - The directory to look for files in, if not used the PHPDoctor will look in the current directory (the directory it is run from).

• subdirs - If you do not want PHPDoctor to look in each sub directory for files uncomment this line.

• quiet - Quiet mode suppresses all output other than warnings and errors.

• verbose - Verbose mode outputs additional messages during execution.

• doclet - Select the doclet to use for generating output.

• doclet_path - The directory to find the doclet in. Doclets are expected to be in a directory named after themselves at the location given.

• taglet_path - The directory to find taglets in. Taglets allow you to make PHPDoctor handle new tags and to alter the behavour of existing tags and their output.

• default_package - If the code you are parsing does not use package tags or not all elements have package tags, use this setting to place unbound elements into a particular package.

• overview - Specifies the name of a HTML file containing text for the overview documentation to be placed on the overview page. The path is relative to "source_path" unless an absolute path is given.

• package_comment_dir - Package comments will be looked for in a file named package.html in the same directory as the first source file parsed in that package or in the directory given below. If the directive below is used then package comments should be named ".html".

• globals - Parse out global variables.

• constants - Parse out global constants.

• private - Generate documentation for all class members.

• protected - Generate documentation for public and protected class members.

• public - Generate documentation for only public class members.

  The following directives are specific for the standard doclet:

• d - The directory to place generated documentation in. If the given path is relative to it will be relative to "source_path".

• windowtitle - Specifies the title to be placed in the HTML