brucechu / docker-php

Heroku Docker image for PHP

Heroku PHP Docker Image

This image is for use with the Heroku Docker CLI plugin.

Usage

Your project must contain at least the following files:

• composer.json & composer.lock;
• a Procfile with a command to launch PHP-FPM together with a web server

Then, create an app.json file in the root directory of your application with at least these contents:

{
  "name": "Your App's Name",
  "description": "An example app.json for heroku-docker",
  "image": "heroku/php"
}

Install the heroku-docker toolbelt plugin:

$ heroku plugins:install heroku-docker

Initialize your app:

$ heroku docker:init
Wrote Dockerfile
Wrote docker-compose.yml

And run it with Docker Compose:

$ docker-compose up web

The first time you run this command, composer will download all dependencies into the container, build your application, and then run it. Subsequent runs will use cached dependencies (unless your composer.json/composer.lock file has changed).

You'll be able to access your application at http://<docker-ip>:8080, where <docker-ip> is either the value of running boot2docker ip if you are on Mac or Windows, or your localhost if you are running Docker natively.

For boot2docker users:

$ open "http://$(boot2docker ip):8080"

Hacking

To test changes locally, you can edit this image and rebuild it, replacing the heroku/php image on your machine:

docker build -t heroku/php .

To return to the official image:

docker pull heroku/php