build: add a PHP environment

php/.gitignore

@@ -0,0 +1,2 @@
+/.phpunit.result.cache
+/vendor/

php/Dockerfile

@@ -0,0 +1,20 @@
+FROM php:8.1-cli-bullseye
+
+ENV PATH=$PATH:/app/vendor/bin
+
+COPY --from=composer /usr/bin/composer /usr/bin/composer
+
+WORKDIR /app
+
+RUN apt-get update -yqq \
+  && apt-get install -yqq git unzip \
+  && adduser --disabled-password app \
+  && chown app:app -R /app
+
+USER app
+
+COPY --chown=app:app composer.* ./
+
+RUN composer install
+
+COPY --chown=app:app . .

php/composer.json

@@ -0,0 +1,11 @@
+{
+    "require-dev": {
+        "phpunit/phpunit": "^9.5",
+        "pestphp/pest": "^1.22"
+    },
+    "config": {
+        "allow-plugins": {
+            "pestphp/pest-plugin": true
+        }
+    }
+}

php/docker-compose.yaml

@@ -0,0 +1,6 @@
+services:
+  php:
+    build: .
+    volumes:
+      - ./:/app
+    command: "bash"

php/justfile

@@ -0,0 +1,16 @@
+# List all recipes.
+default:
+  just --list
+
+# Run a Composer command.
+composer *args:
+  docker compose run --rm -it php composer {{ args }}
+
+# Run tests with Pest.
+test *args:
+  clear
+  docker compose run --rm -it php pest {{ args }}
+
+# Run tests with Pest and watch for changes.
+test-watch *args:
+  find src tests -type f | entr just test {{ args }}

php/phpunit.xml

@@ -0,0 +1,18 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<phpunit xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
+         xsi:noNamespaceSchemaLocation="./vendor/phpunit/phpunit/phpunit.xsd"
+         bootstrap="vendor/autoload.php"
+         colors="true"
+>
+    <testsuites>
+        <testsuite name="Test Suite">
+            <directory suffix="Test.php">./tests</directory>
+        </testsuite>
+    </testsuites>
+    <coverage processUncoveredFiles="true">
+        <include>
+            <directory suffix=".php">./app</directory>
+            <directory suffix=".php">./src</directory>
+        </include>
+    </coverage>
+</phpunit>

php/tests/ExampleTest.php

@@ -0,0 +1,5 @@
+<?php
+
+it('should return true', function () {
+    expect(false)->toBeTrue();
+});