feat: migrated to a Symfony app

Author: thorsten

.gitignore

@@ -1 +1,4 @@
-# .gitignore
+# .gitignore
+/.idea
+/var
+/vendor

.htaccess

@@ -4,22 +4,19 @@
 Options +FollowSymlinks -MultiViews -Indexes
 
 # ----------------------------------------------------------------------
-# | Rewrite rules for api.phpmyfaq.de                                  |
+# | Redirect all requests to public/ (Front Controller)                |
 # ----------------------------------------------------------------------
 <IfModule mod_rewrite.c>
     RewriteEngine On
     RewriteBase /
 
-    # Handle preflight OPTIONS requests
+    # Handle preflight OPTIONS requests early
     RewriteCond %{REQUEST_METHOD} OPTIONS
     RewriteRule ^ - [R=204,L]
 
-    # Existing rewrite rules
-    RewriteRule ^versions$            /version.php [L]
-    RewriteRule ^version/stable$      /version.php?branch=stable [L]
-    RewriteRule ^version/development$ /version.php?branch=development [L]
-    RewriteRule ^version/nightly$     /version.php?branch=nightly [L]
-    RewriteRule ^verify/(.+)$         /verify.php?version=$1 [L]
+    # Send everything to public/, keep existing paths
+    RewriteRule ^public/ - [L]
+    RewriteRule ^(.*)$ public/$1 [L]
 </IfModule>
 
 # ----------------------------------------------------------------------

README.md

@@ -18,7 +18,7 @@ JSON Response:
         "nightly_released: "2023-09-21"
     }
 
-### api.phpmyfaq.de/verify/<version>
+### api.phpmyfaq.de/verify/<version>
 
 JSON Response:
 
@@ -64,3 +64,40 @@ Requests:
 Mozilla Public License 2.0, see LICENSE.md for more information.
 
 Copyright © 2014-2023 Thorsten Rinne
+
+
+<!-- Added: Symfony-like lightweight front controller + routing -->
+
+## Lightweight Symfony-based front controller
+
+- Front controller: `public/index.php` using `symfony/http-foundation` and `symfony/routing`.
+- Controller: `src/Controller/ApiController.php` implements all endpoints.
+- Apache rewrites: root `.htaccess` forwards all requests to `public/`, and `public/.htaccess` routes to the front controller.
+- CORS support: default `Access-Control-*` headers and `OPTIONS` preflight handling.
+
+### Requirements
+- PHP >= 8.2
+
+### Local run
+Install deps and start a local server:
+
+```bash
+composer install
+composer serve
+# or
+php -S 127.0.0.1:3000 -t public public/index.php
+```
+
+Try:
+
+```bash
+curl http://127.0.0.1:3000/
+curl http://127.0.0.1:3000/versions
+curl http://127.0.0.1:3000/version/stable
+curl "http://127.0.0.1:3000/verify/2.8.18"
+```
+
+### Notes
+- Nightly value is generated as `nightly-<yesterday>`; its release date equals yesterday.
+- `verify` responds with 418 for missing or invalid versions.
+- CORS headers are always present; `OPTIONS` returns 204.

composer.json

@@ -0,0 +1,39 @@
+{
+  "name": "thorsten/phpmyfaq-api-app",
+  "description": "Mini Symfony-based API for phpMyFAQ version and verification endpoints",
+  "type": "project",
+  "license": "MPL-2.0",
+  "authors": [
+    {
+      "name": "Thorsten Rinne",
+      "email": "thorsten@phpmyfaq.de"
+    }
+  ],
+  "version": "1.0.0",
+  "minimum-stability": "stable",
+  "prefer-stable": true,
+  "require": {
+    "php": ">=8.4",
+    "symfony/http-foundation": "^7.3",
+    "symfony/routing": "^7.3",
+    "symfony/framework-bundle": "^7.3"
+  },
+  "require-dev": {
+    "phpunit/phpunit": "^12.0",
+    "symfony/phpunit-bridge": "^7.3",
+    "symfony/browser-kit": "^7.3",
+    "symfony/dom-crawler": "^7.3"
+  },
+  "autoload": {
+    "psr-4": {
+      "App\\": "src/"
+    }
+  },
+  "config": {
+    "sort-packages": true
+  },
+  "scripts": {
+    "serve": "php -S localhost:3000 -t public",
+    "test": "vendor/bin/phpunit"
+  }
+}