Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/evilwizardcreations/php5.6-cli-docker-example

A base PHP 5.6 CLI image for demonstrating legacy projects.
https://github.com/evilwizardcreations/php5.6-cli-docker-example

development docker docker-compose docker-container docker-image dockerfile dockerhub dockerhub-image legacy legacy-application legacy-support php56 php56-cli

Last synced: 27 days ago
JSON representation

A base PHP 5.6 CLI image for demonstrating legacy projects.

Awesome Lists containing this project

README

        

# PHP 5.6 CLI Dockerfile Example

A base PHP 5.6 CLI image[^docker_pull_cmd_note] for demonstrating legacy projects available at [EWC Docker Hub](https://hub.docker.com/r/ewc2020/web).

An older version of ***PHP*** that some older codebases would require such an environment to run in.

Other Packages Included:

- Composer v1.7.1
- libxml2-dev
- libzip-dev
- yaml
- yaml-dev
- zip
- unzip
- git
- gettext
- gettext-dev
- mariadb-dev
- vim
- pcre-dev ${PHPIZE_DEPS}[^pcre-dev_note]
- autoconf

PHP Extensions:

- gettext
- mysqli
- pdo_mysql
- zip
- yaml

## Build & Compose Up

Note that the `php-5-6-cli` is the Docker Compose Service to ***Build***.

There is a build script included that uses the local `.env` file & an [Evil Wizard Creations Protocol](https://bitbucket.org/evilwizardcreations/ewc-protocols) that makes this much simpler.

```bash
build-up-php-5-6-cli.sh
```

Alternatively there is the *full Procedure*.

1. Build the Image using the `docker-compose-build.yaml` configuration.

```bash
docker-compose -f ./docker-compose-build.yaml build --no-cache php-5-6-cli
```

1. Compose *Up* using the `docker-compose-build.yaml` configuration will use the new built Image and `-d` to *detach*.

```bash
docker-compose -f ./docker-compose-build.yaml up -d
```

## Build Image The Long Way

Build the ***Docker Image*** without using ***cached*** versions of previous image build stages.

```bash
sudo docker build \
-f php-5-6-cli.Dockerfile \
--target build-php-5-6-cli \
--build-arg APP_ENV=local \
--no-cache \
-t php-5.6-cli:latest \
.
```

**N.B.**

- Using `-f php-5-6-cli.Dockerfile`

To specify the *filename* to ***build*** otherwise it is expected to be named `Dockerfile`.

- Using `--target build-php-5-6-cli`

To select the ***build target stage***[^multi_stage_builds_note] from the *Dockerfile*.

- Using `--build-arg ARG=value`

To set build argument values to use.

### Create A Container

This creates a named container and attaches it to the ***host network*** and may cause port conflict if the host machine is already listening on any exposed ports from the ***Docker Image*** being used.

```bash
sudo docker run \
-d \
--network host \
-v "$(pwd)"/public_html:/var/www/html \
--name php-5-6-cli \
php-5-6-cli:latest
```

**OR**

This creates a named container and attaches it to the ***bridge network*** and allows for ***port forward mapping*** from the ***host*** to the ***Container***.

```bash
sudo docker run \
-d \
--network bridge \
-p 8080:80/tcp \
-v "$(pwd)"/public_html:/var/www/html \
--name php-5-6-cli \
php-5-6-cli:latest
```

**N.B.**

- Using `-v "$(pwd)"/public_html:/var/www/html`

To ***Volume Mount*** the folder `public_html` from the current folder to `/var/www/html` on the ***running*** container.

- Using `-p 8080:80/tcp`

To map port **8080** on the ***Host*** machine to port **80** on the ***Container*** using the ***bridge network***.

- Using `--name php-5-6-cli`

To name the ***Container*** being created.

### Start Container

```bash
sudo docker start php-5-6-cli
```

### Stop Container

```bash
sudo docker stop php-5-6-cli
```

## Connect To Container

```bash
sudo docker exec -it php-5-6-cli /bin/sh
```

# Disclaimer

This PHP 5.6 CLI build environment should ***NOT*** be used anywhere near a ***production*** environment. This build is for showcasing legacy systems that simple would not run in modern environments & as such it is littered with security holes and exploitation's.

[^docker_pull_cmd_note]: Use `docker pull ewc2020/web:php-5.6-cli-latest` to get a copy of the image.

[^pcre-dev_note]: The `pcre-dev` application is uninstalled after the extensions have been installed.

[^multi_stage_builds_note]: Used mostly in ***Multi Stage*** image builds.

[^compose_name_note]: The `php-5-6-cli` container name to build the image for.