feat: add Docker support (FrankenPHP) and Swagger UI support

Author: Fahl-Design

.dockerignore

@@ -0,0 +1,12 @@
+.git
+.github
+.idea
+vendor
+tests
+_output
+.php-cs-fixer.cache
+.phpunit.result.cache
+Dockerfile
+compose.yml
+.env
+*.md

.releaserc

@@ -0,0 +1,34 @@
+{
+  "tagFormat": "${version}",
+  "branches": ["main"],
+  "plugins": [
+    [
+      "@semantic-release/commit-analyzer", {
+      "preset": "conventionalcommits",
+    }
+    ],
+    [
+      "@semantic-release/release-notes-generator", {
+      "preset": "conventionalcommits",
+    }
+    ],
+    [
+      "@semantic-release/github",
+      {
+        "labels": "semantic-release,bot"
+      }
+    ],
+    [
+      "@semantic-release/changelog",
+      {
+        "changelogTitle": "# Changelog\n\nAll notable changes to this project will be documented in this file. See\n[Conventional Commits](https://conventionalcommits.org) for commit guidelines."
+      }
+    ],
+    [
+      "@semantic-release/git",
+      {
+        "message": "chore(release): version ${nextRelease.version} \n\n${nextRelease.notes}"
+      }
+    ]
+  ]
+}

Dockerfile

@@ -0,0 +1,50 @@
+# Stage 1: Install dependencies
+FROM composer:2 AS composer_build
+
+WORKDIR /app
+
+# Copy only composer files first to leverage Docker cache
+COPY composer.json ./
+
+# Install production dependencies
+# We ignore platform reqs here because we know they are met in the final image
+RUN composer install \
+    --no-dev \
+    --optimize-autoloader \
+    --no-interaction \
+    --no-progress \
+    --no-scripts \
+    --ignore-platform-reqs
+
+# Stage 2: Final image
+FROM dunglas/frankenphp:latest
+
+# Disable HTTPS by default for the container
+ENV SERVER_NAME=:80
+
+# Enable production PHP settings
+RUN mv "$PHP_INI_DIR/php.ini-production" "$PHP_INI_DIR/php.ini"
+
+# Install additional PHP extensions
+RUN install-php-extensions \
+    bcmath \
+    curl \
+    intl \
+    zip \
+    opcache \
+    sodium
+
+# Set the working directory
+WORKDIR /app
+
+# Copy vendor from builder
+COPY --from=composer_build /app/vendor /app/vendor
+
+# Copy application code
+COPY . /app
+
+# Set default environment variables
+ENV OPENAPI_SPEC=data/openapi.yaml
+
+# Expose port 80
+EXPOSE 80

compose.yml

@@ -0,0 +1,20 @@
+services:
+  mock-server:
+    build:
+      context: .
+      dockerfile: Dockerfile
+    image: webproject/php-openapi-mock-server:latest
+    container_name: openapi-mock-server
+    restart: unless-stopped
+    ports:
+      - "8080:80"
+    environment:
+      # Path or URL to the OpenAPI specification
+      - OPENAPI_SPEC=${OPENAPI_SPEC:-data/openapi.yaml}
+      # Enable FrankenPHP watcher for hot-reload
+      - FRANKENPHP_WATCHER=1
+    volumes:
+      # Mount source code for hot-reload
+      - .:/app
+      # Map data if you want to use local spec files
+      - ./data:/app/data:ro

grumphp.yml

@@ -0,0 +1,23 @@
+grumphp:
+    process_timeout: 120
+    fixer:
+        enabled: false
+        fix_by_default: false
+    parallel:
+        enabled: true
+        max_workers: 8
+    tasks:
+        phpcsfixer:
+            config: .php-cs-fixer.php
+            allow_risky: true
+        phpstan:
+            configuration: phpstan.neon
+            level: 8
+            use_grumphp_paths: false
+#        rector:
+#            config: rector.php
+#            no_diffs: false
+#            triggered_by: ['php']
+        codeception:
+            config_file: codeception.yml
+            fail_fast: true

phpbench.json

@@ -0,0 +1,10 @@
+{
+    "$schema": "./vendor/phpbench/phpbench/phpbench.schema.json",
+    "runner.bootstrap": "vendor/autoload.php",
+    "runner.path": "tests/Benchmark",
+    "runner.php_config": {
+        "opcache.enable_cli": "1",
+        "opcache.jit": "tracing",
+        "opcache.jit_buffer_size": "128M"
+    }
+}

rector.php

@@ -0,0 +1,48 @@
+<?php
+
+declare(strict_types=1);
+
+use Rector\Config\RectorConfig;
+use Rector\Set\ValueObject\SetList;
+use Rector\ValueObject\PhpVersion;
+
+return RectorConfig::configure()
+    ->withPaths([
+        __DIR__ . '/config',
+        __DIR__ . '/public',
+        __DIR__ . '/src',
+        __DIR__ . '/tests',
+    ])
+    // Target PHP version
+    ->withPhpVersion(PhpVersion::PHP_83)
+    ->withPhpSets(php83: true)
+    ->withPreparedSets(
+        deadCode: true,
+        codeQuality: true,
+        typeDeclarations: true,
+        privatization: true,
+        earlyReturn: true,
+        naming: true,
+    )
+    ->withSets([
+        SetList::CODING_STYLE,
+        SetList::INSTANCEOF,
+    ])
+    // Import settings
+    ->withImportNames(
+        importNames: true,
+        removeUnusedImports: true,
+    )
+    // PHPStan config for better type inference
+    ->withPHPStanConfigs([
+        __DIR__ . '/phpstan.neon',
+        __DIR__ . '/vendor/slam/phpstan-laminas-framework/extension.neon',
+    ])
+    // Parallel processing
+    ->withParallel(
+        timeoutSeconds: 120,
+        maxNumberOfProcess: 8,
+    )
+    ->withSkip([
+        __DIR__ . '/tests/Support/_generated',
+    ]);