Usage

For using these images you'll usually want to create a Dockerfile or go further and use Docker Compose to simplify usage of multiple containers for your application.

Dockerfile

Create a Dockerfile for your setup:

Alpine Nginx

For images that use Alpine Linux as a base, you can create a simple Nginx container with PHP FPM in the following way:

FROM phpearth/php:7.1-nginx

Alpine OpenLiteSpeed

FROM phpearth/php:7.1-litespeed

PHP CLI script

To run a CLI PHP script:

docker run -it --rm --name my-cli-script -v "$PWD":/usr/src/myapp -w /usr/src/myapp phpearth/php php script.php

PHP 7.2

To use PHP 7.2 images just prepend the tag name with 7.2:

  • phpearth/php:7.2
  • phpearth/php:7.2-nginx
  • phpearth/php:7.2-litespeed
  • phpearth/php:7.2-apache
  • phpearth/php:7.2-cgi

Install PHP extensions

To install additional PHP extensions, you can use our packages from the PHP.earth Alpine repository:

FROM phpearth/php:7.1-nginx

RUN apk add --no-cache php7.1-libsodium php7.1-mcrypt php7.1-soap

Services

Best practice with Docker is to use one process per container. However sometimes you want to package multiple services into a single container for various reasons: simpler deployment, simpler usage, and similar cases.

To run multiple services in a single container there are multiple ways:

  • Supervisord

    A solid solution to run and customize services. It requires Python.

  • runit

    These images use runit because for smaller usage resources and image sizes.



Found a typo? Something wrong with this content?

Just fork and edit it.

Content of this work is licensed under a Creative Commons Attribution-ShareAlike 4.0 International (CC BY-SA 4.0) license. Code snippets in examples are published under the CC0 1.0 Universal (CC0 1.0). Thanks to all contributors.