How to build the image :

Without the builder

docker build -t php-symfony-apache:8.1.19 --build-arg FULL_PHP_VERSION=8.1.19  --build-arg PHP_IMAGE_VERSION=8.1 --build-arg SYMFONY_VERSION=6.1 . # Build for php version 8.2.1
docker build  -t php-symfony-apache:8.1.19 --build-arg PHP_BUILD_VERSION=8.1.19 --build-arg PHP_IMAGE_VERSION=8.1 --build-arg SYMFONY_VERSION=6.1 . --no-cache # Build for php version 8.1.19

With the builder :

./builder.sh -p 8.1.19 -s 6.2
./builder.sh --php-full-version=8.1.19 --symfony-version=6.2
./builder.sh -h # Show Help

Note : The builder is just here to parse arg so that people don't have to give the full docker build arg.

Todo :

• Make a FROM php:${Variable} dynamic
• Create dynamic env variable
• Make FROM php-xx to use the var parsed
• Make the image work with Symfony
• Verify if the file used by systemsdk/docker-apache-php-symfony are correct. (file in docker/*)

Improuvements :

1. Might be better to use a Makefile or a .sh to build the Dockerfile since we can't parse variable in the Dockerfile

Somethink like

./builder -p 8.1.19

and will result in a docker commande like

docker build --build-arg PHP_IMAGE_TAG_VERSION=8.1 --build-arg FULL_PHP_VERSION=8.1.19

And the script will do somethink like :

# Vérifier si le premier argument est vide
if [ -z "$1" ]; then
    echo "usage : ./builder FULL_PHP_VERSION=8.1.19" 
    exit 1
fi
#FULL_PHP_VERSION=8.1.19
DOCKER_ARG_PHP_IMAGE_VERSION="PHP_IMAGE_TAG_VERSION=$(echo "$PHP_BUILD_VERSION" | cut -d. -f1,2)" # Result in DOCKER_ARG_PHP_IMAGE_VERSION=PHP_IMAGE_TAG_VERSION=8.1
DOCKER_ARG_FULL_PHP_VERSION="FULL_PHP_VERSION=$(echo "$PHP_BUILD_VERSION" | cut -d. -f1,2)" # Result in DOCKER_ARG_FULL_PHP_VERSION=FULL_PHP_VERSION=8.1.19

docker build --build-arg ${DOCKER_ARG_PHP_IMAGE_VERSION} --build-arg ${DOCKER_ARG_FULL_PHP_VERSION}
# Will result in : 
docker build --build-arg PHP_IMAGE_TAG_VERSION=8.1 --build-arg FULL_PHP_VERSION=8.1.19

This script can be usefull because we can't parse Variable in a Dockerfile, so the script is used to only give 1 arguments (AKA FULL_PHP_VERSION)
The script will parse the FULL_PHP_VERSION and exctract <PHP_IMAGE_TAG_VERSION> used for the FROM php-${PHP_IMAGE_TAG_VERSION}

3. Make an option for --no-cache for docker

Issues :

1. Not possible to parse variable in the dockerfile.
   I wanted to only give one variable with --build-arg FULL_BUILD_VERSION=8.1.19, and do :

RUN PHP_IMAGE_VERSION=$(echo "$PHP_BUILD_VERSION" | cut -d. -f1,2) && \
    export PHP_IMAGE_VERSION && \
    echo "Exported PHP_IMAGE_VERSION variable with value : $PHP_IMAGE_VERSION" # So that PHP_IMAGE_VERSION=8.1
# To use like so : 
FROM php:${PHP_IMAGE_VERSION}

But it doesn work because :

Each RUN statement in a Dockerfile is run in a separate shell. So once a statement is done, all environment variables are lost. Even if they are exported.

So we can't parse FULL_PHP_VERSION to get only Major.Minor

2. Outdate : BuildKit is the builder for docker.

BuildKit only builds the stages that the target stage depends on.

So if we build as usual, BuildKit will see that the FROM debian is not useful, and will not build the layer. And therefor, will not check if --build-arg is set correctly

Solution 1 : We can trick the builder to force the specific stage to build, AKAK DEBIAN_BUILD from FROM debian:12-slim as DEBIAN_BUILD. So we build like so docker build --target DEBIAN_BUILD.

⚠️ This doesn't fully work because it only limit to the target, and don't do the other FROM

Solution 2 : Or, we could use the old BuildKit with DOCKER_BUILDKIT=0, but : The legacy builder is deprecated and will be removed in a future release.
BuildKit is currently disabled; enable it by removing the DOCKER_BUILDKIT=0 environment-variable.

**Solution 3 : ** Remove the checking variable in the dockerfile.

Workaround : We might be able to use the COPY --from=.

1. Instruction from systemsdk/docker-apache-php-symfony use the latest composer.
   Might be better to change it. We might need an other arg in the Builder.sh to do so.

COPY --from=composer:latest /usr/bin/composer /usr/bin/composer

Note for docker :

The ${variable_name} syntax also supports a few of the standard bash modifiers as specified below: ${variable:-word} indicates that if variable is set then the result will be that value. If variable is not set then word will be the result. ${variable:+word} indicates that if variable is set then word will be the result, otherwise the result is the empty string.