heroku-buildpack-php

by Welkio

GitHub Readme.md

Heroku buildpack: PHP

This is a 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.

Extras

This is a customized buildpack based on the Official PHP Buildpack. It includes the ability to use your own custom binaries and has built-in PHP LDAP support.

Usage

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

heroku create --buildpack https://github.com/Welkio/heroku-buildpack-php
echo '{}' > composer.json
git add composer.json
git commit -m "add composer.json for PHP app detection"

For existing PHP applications:

heroku buildpacks:set https://github.com/Welkio/heroku-buildpack-php

Please refer to Dev Center for further usage instructions.

LDAP Support

Enable PHP LDAP support by requiring ext-ldap in your composer.json. Remember, you will need to compile and host your own binaries.

"require": {
  "php": "~5.6.0",
  "ext-ldap": "*",
}

Custom Binaries

You may specify a custom S3 bucket for your compiled binaries by adding a BUILDPACK_S3_BUCKET config variable.

heroku config:set BUILDPACK_S3_BUCKET=your-bucket-name

During slug compilation, the buildpack will download binaries from https://your-bucket-name.s3.amazonaws.com.

Development

Compiling Binaries

The folder support/build contains Bob build scripts for all binaries and dependencies.

To get started with it, create a Python app (Bob is a Python application) on Heroku inside a clone of this repository, and set your S3 config vars:

$ heroku create --buildpack https://github.com/heroku/heroku-buildpack-python
$ heroku ps:scale web=0
$ heroku config:set WORKSPACE_DIR=/app/support/build
$ heroku config:set AWS_ACCESS_KEY_ID=<your_aws_key>
$ heroku config:set AWS_SECRET_ACCESS_KEY=<your_aws_secret>
$ heroku config:set S3_BUCKET=<your_s3_bucket_name>
$ heroku config:set S3_PREFIX=<optional_s3_subfolder_to_upload_to>

Then, shell into an instance and run a build by giving the name of the formula inside support/build:

$ heroku run bash
Running `bash` attached to terminal... up, run.6880
~ $ bob build php-5.5.11RC1

Fetching dependencies... found 2:
  - libraries/zlib
  - libraries/libmemcached
Building formula php-5.5.11RC1:
    === Building PHP
    Fetching PHP v5.5.11RC1 source...
    Compiling PHP v5.5.11RC1...

If this works, run bob deploy instead of bob build to have the result uploaded to S3 for you.

To speed things up drastically, it'll usually be a good idea to heroku run bash --size PX instead.

If the dependencies are not yet deployed, you can do so by e.g. running bob deploy libraries/zlib.

Hacking

To work on this buildpack, fork it on Github. You can then use Anvil with a local buildpack to easily iterate on changes without pushing each time.

Alternatively, you may push changes to your fork (ideally in a branch if you'd like to submit pull requests), then create a test app with heroku create --buildpack <your-github-url#branch> and push to it.