Composer PHP docker image

About

This repository is a docker image based on official php, composer and alpine docker images to help you to build and test your PHP projects with different PHP version.
This docker image contains a necessary tools you need to analyze and test your PHP project

• xdebug
• phpunit
• rector
• phpstan
• psalm
• phpcs
• php-cs-fixer
• phpmd
• phpcpd (available from php 7.3 version)

Below is the list of docker images available by PHP versions:

PHP version	Docker image tags
PHP 8.4	ghcr.io/devgine/composer-php:latest ghcr.io/devgine/composer-php:v2-php8.4-alpine
PHP 8.3	ghcr.io/devgine/composer-php:v2-php8.3-alpine
PHP 8.2	ghcr.io/devgine/composer-php:v2-php8.2-alpine
PHP 8.1	ghcr.io/devgine/composer-php:v2-php8.1-alpine
PHP 8.0	ghcr.io/devgine/composer-php:v2-php8.0-alpine
PHP 7.4	ghcr.io/devgine/composer-php:v2-php7.4-alpine
PHP 7.3	ghcr.io/devgine/composer-php:v2-php7.3-alpine
PHP 7.2	ghcr.io/devgine/composer-php:v2-php7.2-alpine

Usage

Install from the command line

docker run -ti -v LOCAL_PROJECT_DIR:/var/www/composer ghcr.io/devgine/composer-php:latest sh

All versions

Use as base image in Dockerfile

FROM ghcr.io/devgine/composer-php:latest

# Add your custom instructions here
# example: install bash
RUN apk add --no-cache bash

# example: expose 8080 port
EXPOSE 8080
#...

Use components

Inside the container, you can run any tool you need from any working directory.
Global vendor binaries are added to the PATH environment.

Composer

composer --help

PHP Unit

simple-phpunit --help

Rector

rector --help

PHPStan

phpstan --help

Psalm

psalm --help

PHP Code sniffer

phpcs --help

PHP Coding Standards Fixer

php-cs-fixer --help

PHP Mess Detector

phpmd --help

PHP Copy Past Detector

phpcpd --help

Use image in continuous integration

GitHub action

name: 'Workflow name'
on:
  push
jobs:
  job-id:
    runs-on: ubuntu-latest
    ...
    container:
      image: ghcr.io/devgine/composer-php:latest
    steps:
      - name: 'Run Tests'
        run: simple-phpunit --coverage-text
      ...

An example with matrix strategy

name: 'Matrix strategy'
on:
    push
jobs:
  job-id:
    runs-on: ubuntu-latest
    ...
    strategy:
      fail-fast: false
      matrix:
        tag: ['v2-php8.3-alpine', 'v2-php8.2-alpine', 'v2-php8.1-alpine', 'v2-php8.0-alpine', 'v2-php7.4-alpine']
    container:
      image: ghcr.io/devgine/composer-php:${{ matrix.tag }}
    steps:
      - name: 'Run Tests'
        run: simple-phpunit --coverage-text
      ...

Gitlab CI

tests:
  image: ghcr.io/devgine/composer-php:latest
  ...
  script:
    - simple-phpunit --coverage-text

An example with matrix strategy

tests:
  parallel:
    matrix:
      TAG: ['v2-php8.3-alpine', 'v2-php8.2-alpine', 'v2-php8.1-alpine', 'v2-php8.0-alpine', 'v2-php7.4-alpine']
  image: ghcr.io/devgine/composer-php:${TAG}
  ...
  script:
    - simple-phpunit --coverage-text

References

• PHP Unit supported versions
• Xdebug compatibility
• PHP Unit
• Rector
• PHPStan
• Psalm
• PHP CS
• PHP Coding Standards Fixer
• PHP Mess Detector
• PHP Copy Past detector