Add route for dynamic image generation on application side (#462)

Author: gomzyakov

.php-cs-fixer.dist.php

@@ -1,7 +1,7 @@
 <?php
 
-use Gomzyakov\CS\Finder;
-use Gomzyakov\CS\Config;
+use Gomzyakov\CodeStyleFinder;
+use Gomzyakov\CodeStyleConfig;
 
 // Routes for analysis with `php-cs-fixer`
 $routes = [
@@ -13,4 +13,4 @@
     __DIR__ . '/tests',
 ];
 
-return Config::createWithFinder(Finder::createWithRoutes($routes));
+return CodeStyleConfig::createWithFinder(CodeStyleFinder::createWithRoutes($routes));

app/Http/Controllers/PlaceholderController.php

@@ -0,0 +1,49 @@
+<?php
+
+declare(strict_types = 1);
+
+namespace App\Http\Controllers;
+
+use Gomzyakov\ImagePlaceholder;
+use Illuminate\Http\Request;
+use Illuminate\Http\Response;
+use RuntimeException;
+
+class PlaceholderController extends Controller
+{
+    /**
+     * Generate a placeholder image.
+     */
+    public function generate(Request $request, int $width = 640, int $height = 480): Response
+    {
+        if ($width < 1 || $width > 2000) {
+            return response('Width must be between 1 and 2000', 400);
+        }
+        if ($height < 1 || $height > 2000) {
+            return response('Height must be between 1 and 2000', 400);
+        }
+
+        $cx   = (int) $request->get('cx', 4); // blurhash components on X axis
+        $cy   = (int) $request->get('cy', 3); // blurhash components on Y axis
+
+        if ($cx < 1 || $cx > 9) {
+            return response('cx must be between 1 and 9', 400);
+        }
+        if ($cy < 1 || $cy > 9) {
+            return response('cy must be between 1 and 9', 400);
+        }
+
+        $seed = (string) $request->get('seed', 'default');
+
+        try {
+            $generator  = new ImagePlaceholder();
+            $image_data = $generator->generate($width, $height, $seed, $cx, $cy);
+
+            return response($image_data)
+                ->header('Content-Type', 'image/png')
+                ->header('Cache-Control', 'public, max-age=31536000');
+        } catch (RuntimeException $e) {
+            return response($e->getMessage(), 500);
+        }
+    }
+}

composer.json

@@ -7,6 +7,8 @@
     "require": {
         "php": "^8.4",
         "ext-intl": "*",
+        "ext-gd": "*",
+        "gomzyakov/image-placeholder": "^1.0",
         "laravel/framework": "^11.9",
         "laravel/tinker": "^2.10.0",
         "laravel/ui": "^4.5",
@@ -15,7 +17,7 @@
     "require-dev": {
         "fakerphp/faker": "^1.23.1",
         "friendsofphp/php-cs-fixer": "^3.53",
-        "gomzyakov/php-cs-fixer-config": "^1.75",
+        "gomzyakov/code-style": "^2.1",
         "mockery/mockery": "^1.6",
         "nunomaduro/collision": "^8.0",
         "phpstan/phpstan": "^1.10",
@@ -38,10 +40,10 @@
     "scripts": {
         "phpunit": "@php ./vendor/bin/phpunit ./tests --no-coverage --color=always",
         "phpstan": "@php ./vendor/bin/phpstan analyze -c ./phpstan.neon.dist --no-progress --ansi --verbose",
+        "fix": "@php ./vendor/bin/php-cs-fixer fix --config=.php-cs-fixer.dist.php",
         "cs-check": "@php ./vendor/bin/php-cs-fixer fix --config=.php-cs-fixer.dist.php --dry-run --diff",
-        "cs-fix": "@php ./vendor/bin/php-cs-fixer fix --config=.php-cs-fixer.dist.php",
+        "rector": "@php ./vendor/bin/rector process",
         "rector-check": "@php ./vendor/bin/rector process --dry-run",
-        "rector-fix": "@php ./vendor/bin/rector process",
         "test": [
             "@cs-check",
             "@phpstan",

composer.lock

@@ -6,8 +6,6 @@
 use Illuminate\Database\Eloquent\Factories\Factory;
 use Illuminate\Support\Str;
 
-use function mt_rand;
-
 /**
  * @extends Factory<Post>
  */
@@ -23,8 +21,8 @@ public function definition(): array
         return [
             'title'         => $title = fake()->text(100),
             'slug'          => Str::slug($title),
-            'preview_image' => 'https://loremflickr.com/640/480?random=' . mt_rand(1, 9999),
-            'main_image'    => 'https://loremflickr.com/640/480?random=' . mt_rand(1, 9999),
+            'preview_image' => route('placeholder.generate', ['width' => 640, 'height' => 480, 'seed' => Str::slug($title) . '-preview']),
+            'main_image'    => route('placeholder.generate', ['width' => 640, 'height' => 480, 'seed' => Str::slug($title) . '-main']),
             'content'       => fake()->realText(5000),
         ];
     }

database/factories/PostFactory.php

@@ -2,6 +2,7 @@
 
 use App\Http\Controllers\AboutController;
 use App\Http\Controllers\ContactsController;
+use App\Http\Controllers\PlaceholderController;
 use App\Http\Controllers\PostController;
 use Illuminate\Support\Facades\Auth;
 use Illuminate\Support\Facades\Route;
@@ -19,6 +20,11 @@
 
 Route::get('/', [PostController::class, 'showHomepage'])->name('main.index');
 
+// Placeholder image generation
+Route::get('/placeholder/{width}/{height}', [PlaceholderController::class, 'generate'])
+    ->where(['width' => '[0-9]+', 'height' => '[0-9]+'])
+    ->name('placeholder.generate');
+
 Auth::routes(['verify' => false]);
 
 Route::prefix('contacts')->group(function () {