jestefane/php-dev repository overview

⁠PHP Development Docker Images

PHP Versions: 5.5, 5.6, 7.0, 7.1, 7.2, 7.3, 7.4

PHP Variants: cli, fpm

Images based on the Official PHP Images⁠

Also installed:

• Composer⁠
• PHP modules XDebug, PDO MySQL

⁠Installation

Pull the latest version:

$ docker pull jestefane/php-dev

Pull a specific version:

$ docker pull jestefane/php-dev:7.4-cli

Pick between the various images provided in this repository⁠.

(Optionally) Install the Shortcuts:

To use the Docker images more like binaries, we're providing Shortcuts⁠ that can easily be installed on your system⁠.

⁠Images

Image names have the following format:

<docker repo>:<php version>-<php variant>-<branch or version>

For convenience, the latest stable version/variant is also tagged as:

<docker repo>:<php version>-<php variant>

⁠CLI

Images names:

• jestefane/php-dev:7.4-cli
• jestefane/php-dev:7.3-cli
• jestefane/php-dev:7.2-cli
• jestefane/php-dev:7.1-cli
• jestefane/php-dev:7.0-cli
• jestefane/php-dev:5.6-cli
• jestefane/php-dev:5.5-cli

Shortcuts: php-cli⁠, composer⁠

Example:

$ docker run jestefane/php-dev:7.2-cli hello-world.php

# or using one of the provided shortcuts
$ php-7.2-cli hello-world.php

⁠FPM

Images names:

• jestefane/php-dev:7.4-fpm
• jestefane/php-dev:7.3-fpm
• jestefane/php-dev:7.2-fpm
• jestefane/php-dev:7.1-fpm
• jestefane/php-dev:7.0-fpm
• jestefane/php-dev:5.6-fpm
• jestefane/php-dev:5.5-fpm

Shortcuts: php-fpm⁠

Example:

$ docker run jestefane/php-dev:7.4-fpm hello-world.php

# or using one of the provided shortcuts
$ php-7.2-fpm hello-world.php

⁠Shortcuts

Shortcuts are simple bash scripts wrapping the docker command that facilitate command-line-use of the images in this repository.

⁠Install the Shortcuts

From the root of this directory:

# If you haven't done so, clone this repository
$ git clone https://github.com/grimzy/php-dev.git

# Get in there!
# Yes, you have to! the script doesn't always work when running from outside
$ cd php-dev

# Generate the scripts and install the shortcuts
make shortcuts

This generates bash scripts in the scripts directory (via. Script Template⁠). It also adds them to your PATH environment variable (Linux and Mac OS only) by creating symlinks of the generated bash scripts inside /usr/local/bin.

For more info on the shortcuts task, please checkout the Makefile command reference⁠.

⁠Aliasing your Preferred Version Shortucts

Optionally, you can alias your preferred shortcuts by adding them to your ~/.bash_profile:

# Aliases for the jestefane/php-dev preferred versions
alias php="php-7.2-cli"
alias composer="composer-7.2"

⁠Script Templates

You'll notice that the directory that should contain the scripts doesn't exist; that's because you first need to generate them. This is automatically done prior to creating the symlinks. But if you've deleted a script or changed the templates in some way, you can regenerate scripts with:

# Removes the scripts directory and generates them back
$ make scripts

For more info on the scripts task Makefile command reference⁠.

⁠Shortcuts Reference

⁠PHP CLI

Images: All respective versions of the PHP CLI variant⁠

Shortcuts: php-5.5-cli, php-5.6-cli, php-7.0-cli, php-7.1-cli, php-7.2-cli, php-7.3-cli, php-7.4-cli

Script template: template/php.template⁠

⁠PHP FPM

Images: All respective versions of the PHP FPM variant⁠

Shortcuts: php-5.5-fpm, php-5.6-fpm, php-7.0-fpm, php-7.1-fpm, php-7.2-fpm, php-7.3-fpm, php-7.4-fpm

Script template: template/php.template⁠

⁠Composer

Images: All respective versions of jestefane/php-dev images⁠ (Composer⁠ is installed on every image)

Shortcuts: composer-5.5, composer-5.6, composer-7.0, composer-7.1, composer-7.2, composer-7.3, composer-7.4

Script template: template/composer.template⁠

⁠Makefile Commands Reference

⁠Variables

⁠Tasks

⁠Build the Images

Locally builds all images from all possible combinations of PHP_VERSIONS and PHP_VARIANTS. SOURCE_BRANCH is appended to the image name. The DOCKER_TAG is used to target a specific PHP version and variant.

Command:

$ make build [PHP_VERSIONS=] [PHP_VARIANTS=] [SOURCE_BRANCH=] [DOCKER_TAG=] [DOCKER_REPO=] [DOCKER_TAG=]

⁠Remove the Images

Remove all locally cached images from all possible combinations of PHP_VERSIONS and PHP_VARIANTS. The DOCKER_TAG is used to target a specific PHP version, variant.

Command:

$ make rm_build [PHP_VERSIONS=] [PHP_VARIANTS=] [SOURCE_BRANCH=] [DOCKER_TAG=] [DOCKER_REPO=]

⁠Rebuild the Images

Alias for removing then building the images: make rm_build build.

⁠Generate the Scripts

Generate the bash scripts from templates⁠ in the template directory. Generated scripts are saved in the SCRIPTS_DIR directory. The PHP_VERSION PHP_VARIANT and SOURCE_BRANCH are passed to the templates⁠.

Command:

This task first runs: rm_scripts_dir

$ make scripts [PHP_VERSIONS=] [PHP_VARIANTS=] [SOURCE_BRANCH=] [SCRIPTS_DIR=]

⁠Remove the Generated Scripts Directory

Removes the SCRIPTS_DIR directory.

Command:

$ make rm_scripts_dir [SCRIPTS_DIR=]

⁠Create the Shortcuts

This task creates symlinks of the scripts inside of SCRIPTS_DIR inside of the BIN_DIR. This adds them to your PATH environment variable (Linux and Mac OS only) easily making them available for use on your command line.

Command:

$ make shortcuts [SCRIPTS_DIR=] [BIN_DIR=]

Before run: make scripts

⁠Remove the Shortcuts

This task removes this repository's scripts' symlinks from the BIN_DIR.

Command:

$ make rm_shortcuts [PHP_VERSIONS=] [PHP_VARIANTS=] [BIN_DIR=]

⁠Post Push

Pushes the images to Dockerhub.

Command:

make post_push [PHP_VERSIONS=] [PHP_VARIANTS=] [SOURCE_BRANCH=] [DOCKER_TAG=] [DOCKER_REPO=]

⁠Remove Dangling Volumes and Images

Command:

$ make rm_dangling

⁠License

MIT⁠ © Joseph Estefane