👷 docker support for OSS contributors (#34)

.gitattributes

@@ -1,9 +1,11 @@
 /.github           export-ignore
 /art               export-ignore
+/docker            export-ignore
 /tests             export-ignore
 .gitattributes     export-ignore
 .gitignore         export-ignore
 CONTRIBUTING.md    export-ignore
+docker-compose.yml export-ignore
 LICENSE.md         export-ignore
 phpstan.neon.dist  export-ignore
 phpunit.xml.dist   export-ignore

CONTRIBUTING.md

@@ -66,3 +66,20 @@ Unit tests:
 ```bash
 composer test:unit
 ```
+
+## Simplified setup using Docker
+
+If you have Docker installed, you can quickly get all dependencies for jql-builder in place using Docker files. Assuming you have the repository cloned, you may run the following
+commands:
+
+1. `docker compose build` to build the Docker image
+2. `docker compose run --rm composer install` to install Composer dependencies
+3. `docker compose run --rm composer test` to run the project tests and analysis tools
+
+If you want to check things work against a specific version of PHP, you may include the `PHP` build argument when building the image:
+
+```bash
+docker compose build --build-arg PHP=8.2
+```
+
+The default PHP version will always be the lowest version of PHP supported by jql-builder.

docker-compose.yml

@@ -0,0 +1,14 @@
+version: "3.8"
+
+services:
+    php:
+        build:
+            context: ./docker
+        volumes:
+            - .:/var/www/html
+    composer:
+        build:
+            context: ./docker
+        volumes:
+            - .:/var/www/html
+        entrypoint: ["composer"] 

docker/Dockerfile

@@ -0,0 +1,23 @@
+ARG PHP=8.0
+FROM php:${PHP}-cli-alpine
+
+RUN apk update \
+    && apk add zip libzip-dev icu-dev git
+
+RUN docker-php-ext-configure zip
+RUN docker-php-ext-install zip
+RUN docker-php-ext-enable zip
+
+RUN docker-php-ext-configure intl
+RUN docker-php-ext-install intl
+RUN docker-php-ext-enable intl
+
+RUN apk add --no-cache $PHPIZE_DEPS linux-headers
+RUN pecl install pcov
+RUN docker-php-ext-enable pcov
+
+COPY --from=composer:2 /usr/bin/composer /usr/bin/composer
+
+WORKDIR /var/www/html
+
+ENTRYPOINT ["php"]