Skip to content
The official PHP buildpack for Heroku.
Shell PHP Ruby Other
Branch: master
Clone or download
Latest commit aa8752d Aug 30, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github CODEOWNERS Mar 21, 2018
bin PHP/7.3.9 Aug 30, 2019
conf Apache/2.4.41 Aug 21, 2019
support PHP/7.3.9 Aug 30, 2019
test Fix test setups for Heroku CI Aug 30, 2019
.gitignore no longer need to ignore Hammer 'builds' dirs Apr 28, 2014
.rspec_parallel use runtime logs for parallel_tests Aug 8, 2019
.travis.yml seven parallel_rspec processes Aug 8, 2019
LICENSE trailing newlines everywhere Dec 9, 2016 Show build status in readme May 25, 2016
buildpack.toml buildpack.toml May 24, 2018
hatchet.json import test infra Mar 12, 2019
hatchet.lock import test infra Mar 12, 2019
requirements.txt move bob dep decls to wildcards where possible Mar 27, 2019

Heroku buildpack: PHP Build Status


This is the official Heroku buildpack for PHP applications.

It uses Composer for dependency management, supports PHP or HHVM (experimental) as runtimes, and offers a choice of Apache2 or Nginx web servers.


You'll need to use at least an empty composer.json in your application.

$ echo '{}' > composer.json
$ git add composer.json
$ git commit -m "add composer.json for PHP app detection"

If you also have files from other frameworks or languages that could trigger another buildpack to detect your application as one of its own, e.g. a package.json which might cause your code to be detected as a Node.js application even if it is a PHP application, then you need to manually set your application to use this buildpack:

$ heroku buildpacks:set heroku/php

This will use the officially published version. To use the master branch from GitHub instead:

$ heroku buildpacks:set

Please refer to Dev Center for further usage instructions.

Custom Platform Repositories

The buildpack uses Composer repositories to resolve platform (php, hhvm, ext-something, ...) dependencies.

To use a custom Composer repository with additional or different platform packages, add the URL to its packages.json to the HEROKU_PHP_PLATFORM_REPOSITORIES config var:


To allow the use of multiple custom repositories, the config var may hold a list of multiple repository URLs, separated by a space character, in ascending order of precedence.

If the first entry in the list is "-" instead of a URL, the default platform repository is disabled entirely. This can be useful when testing development repositories, or to forcefully prevent the use of unwanted packages from the default platform repository.

For instructions on how to build custom platform packages (and a repository to hold them), please refer to the instructions further below.

Please note that Heroku cannot provide support for issues related to custom platform repositories and packages.


The following information only applies if you're forking and hacking on this buildpack for your own purposes.

Pull Requests

Please submit all pull requests against develop as the base branch.

Custom Platform Packages and Repositories

Please refer to the README in support/build/ for instructions.

You can’t perform that action at this time.