ApiGen

Smart and Readable Documentation for PHP projects

ApiGen is easy to use and modern API doc generator supporting all PHP 8.3 features.

Features

• phpDoc
  • all types supported by PHPStan
  • generic class declarations
  • local type aliases
• PHP 8.3
  • typed class constants
• PHP 8.2
  • constants in traits
  • fetch enum properties in const expressions
  • disjunctive normal form types
  • readonly classes
  • true, false and null types
• PHP 8.1
  • enums
  • pure intersection types
  • never type
  • final class constants
  • new in initializers
  • readonly properties
• PHP 8.0
  • constructor property promotion
  • union types
  • mixed type
  • static return type
• PHP 7.4
  • typed properties
• PHP 7.2
  • object type
• PHP 7.1
  • nullable types
  • iterable type
  • void type
  • class constant visibility
• PHP 7.0
  • scalar types
  • return types
• PHP 5.6
  • constant scalar expressions
  • variadic functions
• PHP 5.4
  • traits
  • callable type
  • binary integer notation

Built on Shoulders of Giants

• nikic/php-parser
• phpstan/phpdoc-parser
• latte/latte
• league/commonmark

Install

With Docker

ApiGen is available as apigen/apigen Docker image which you can directly use.

docker run --rm --interactive --tty --volume "$PWD:$PWD" --workdir "$PWD" \
  apigen/apigen:edge \
  src --output docs

With Phar

This will install ApiGen phar binary to tools/apigen.

mkdir -p tools
curl -L https://github.com/ApiGen/ApiGen/releases/latest/download/apigen.phar -o tools/apigen
chmod +x tools/apigen
tools/apigen src --output docs

With Composer

This will install ApiGen to tools/apigen directory with executable entry point available in tools/apigen/bin/apigen.

composer create-project --no-dev apigen/apigen:^7.0@alpha tools/apigen
tools/apigen/bin/apigen src --output docs

Usage

Generate API docs by passing source directories and destination option:

apigen src --output docs

Configuration

ApiGen can be configured with apigen.neon configuration file.

…