System Requirements

If you are using the official Docker container, or the Github Action, you do not need to worry about this and can directly skip to the chapter Using Docker.

phpDocumentor has several dependencies on other software packages. Please make sure that you have these available before installing phpDocumentor.

Installing phpDocumentor

Using Phive

If phive is globally installed, you can run the following command:

$ phive install phpDocumentor

Once you run the command, phpDocumentor will be installed and it can be executed directly.

For more information about Phive have a look at the Phive website.

By downloading the PHAR

You can download the latest PHAR file from or download a specific version from

The phar file can be used by invoking PHP directly and providing the phar file as a parameter:

$ php phpDocumentor.phar -d . -t docs/api

or, on Mac and Linux, you can mark it as executable and move it to your bin folder:

$ chmod +x phpDocumentor.phar
$ mv phpDocumentor.phar /usr/local/bin/phpDocumentor

After that you can run it globally:

$ phpDocumentor -d . -t docs/api

Using Docker

Although not an actual installation method; the easiest method to use phpDocumentor, if you have Docker installed, is to use our Docker image. The Docker image comes with all dependencies pre-installed so that you do not have to install these locally.

To run phpDocumentor using docker, the following should suffice:

$ docker run --rm -v $(pwd):/data phpdoc/phpdoc:3

And next

  • It is recommended to read the What is a DocBlock? section next as it will explain how to quickly start using phpDocumentor.

Search results