2017 © Pedro Peláez
 

library apigen

PHP 7.1 source code API generator.

image

apigen/apigen

PHP 7.1 source code API generator.

  • Monday, April 23, 2018
  • by jadb
  • Repository
  • 105 Watchers
  • 1782 Stars
  • 413,440 Installations
  • PHP
  • 307 Dependents
  • 7 Suggesters
  • 297 Forks
  • 44 Open issues
  • 24 Versions
  • 4 % Grown

The README.md

Smart and Readable Documentation for PHP projects

ApiGen is easy to use and modern API doc generator supporting all PHP 8.3 features., (*1)

Features

Built on Shoulders of Giants

Install

With Docker

ApiGen is available as apigen/apigen Docker image which you can directly use., (*2)

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., (*3)

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., (*4)

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:, (*5)

apigen src --output docs

Configuration

ApiGen can be configured with apigen.neon configuration file., (*6)

parameters:
  # string[], passed as arguments in CLI, e.g. ['src']
  paths: []

  # string[], --include in CLI, included files mask, e.g. ['*.php']
  include: ['*.php']

  # string[], --exclude in CLI, excluded files mask, e.g. ['tests/**']
  exclude: []

  # bool, should protected members be excluded?
  excludeProtected: false

  # bool, should private members be excluded?
  excludePrivate: true

  # string[], list of tags used for excluding class-likes and members
  excludeTagged: ['internal']

  # string, --output in CLI
  outputDir: '%workingDir%/api'

  # string | null, --theme in CLI
  themeDir: null

  # string, --title in CLI
  title: 'API Documentation'

  # string, --base-url in CLI
  baseUrl: ''

  # int, --workers in CLI, number of processes that will be forked for parallel rendering
  workerCount: 8

  # string, --memory-limit in CLI
  memoryLimit: '512M'

The Versions

01/09 2014

v2.8.1

2.8.1.0 http://apigen.org/

API documentation generator for PHP 5.3+

  Sources   Download

BSD-3-Clause

The Requires

 

api generator documentation phpdoc phpdocumentor docblock

29/09 2012

2.8.0

2.8.0.0 http://apigen.org/

API documentation generator for PHP 5.3+

  Sources   Download

BSD-3-Clause

The Requires

 

api generator documentation phpdoc phpdocumentor docblock