Cool Ways to Use FrankenPHP for Kiosks: Because Regular Kiosks Are So 2010

7. August 2025

Communication / Consulting / Design / Development / Digital Kiosk / Digital Signage / Hardware / Mini PC

.SHARE

Let’s be honest—most kiosks out there are pretty boring. They’re slow, clunky, and feel like they’re running on a potato from the early 2000s. But what if I told you there’s a way to make kiosks actually cool? Enter FrankenPHP, the frankenstein monster of web servers that’s about to shake up the kiosk game.

If you haven’t heard of FrankenPHP yet, imagine taking PHP (yes, PHP!) and injecting it with some serious performance steroids. It’s basically the Caddy web server with PHP baked right in, and it’s absolutely perfect for kiosk applications. Here’s why this combo is so brilliant and some seriously creative ways to use it.

FrankenPHP has been of the center what I have been building for the past year over at REALFUSION and these are some of the things that inspired me. (FrankePHP in 2025 / FrankePHP with Docker)

Why FrankenPHP Is Perfect for Kiosks

Before we dive into the fun stuff, let’s talk about why FrankenPHP is such a game-changer for kiosks. Traditional PHP setups are like that friend who takes forever to get ready—lots of back-and-forth between the web server and PHP processor. FrankenPHP cuts out the middleman by embedding PHP directly into the Caddy server.

But here’s the real kicker: worker mode. Instead of starting fresh for every request (like your typical PHP setup), FrankenPHP can keep your application running in memory. It’s like having your app always ready to go, no warming up required. Perfect for kiosks that need to be snappy 24/7.

1. Real-Time Digital Signage That Actually Updates in Real-Time

Remember those digital menu boards that still show last week’s specials? Yeah, let’s fix that. FrankenPHP comes with built-in support for the Mercure protocol—think of it as a super-efficient way to push updates to your kiosks instantly.

Here’s How It Works:

Instead of your kiosks constantly asking “any updates? any updates?” like an impatient kid in the backseat, Mercure lets your server push updates directly to all connected displays. It’s using Server-Sent Events under the hood, which is way more battery-friendly than WebSockets.


// On your server, when something changes:
$mercure = new Publisher('http://localhost/.well-known/mercure', 'your-secret-key');
$mercure->publish([
    'topic' => 'cafe/menu',
    'data' => json_encode([
        'item' => 'Pumpkin Spice Latte', 
        'status' => 'SOLD OUT',
        'timestamp' => time()
    ])
]);

// On your server, when something changes:

$mercure = new Publisher('http://localhost/.well-known/mercure', 'your-secret-key');

$mercure->publish([

'topic' => 'cafe/menu',

'data' => json_encode([

'item' => 'Pumpkin Spice Latte',

'status' => 'SOLD OUT',

'timestamp' => time()

])

]);


<!-- On your kiosk display: -->
<script>
const updates = new EventSource('/.well-known/mercure?topic=cafe/menu');
updates.onmessage = function(event) {
    const data = JSON.parse(event.data);
    if (data.status === 'SOLD OUT') {
        document.getElementById(data.item).classList.add('sold-out');
    }
};
</script>

const updates = new EventSource('/.well-known/mercure?topic=cafe/menu');

updates.onmessage = function(event) {

const data = JSON.parse(event.data);

if (data.status === 'SOLD OUT') {

document.getElementById(data.item).classList.add('sold-out');

}

};

</script>

Why This Rocks:

Updates happen in milliseconds, not minutes
No polling = better battery life
Your coffee shop customers won’t order something that’s been sold out for hours

2. Turn Your Kiosk Into a Mini Data Center

This one’s for the nerds (said with love). What if your kiosk wasn’t just displaying information, but actually processing it? With FrankenPHP’s lightweight footprint and HTTP/3 support, you can turn kiosks into edge computing nodes.

Picture This:

A smart building kiosk that monitors foot traffic, air quality, temperature—the whole nine yards. Instead of sending all that data to the cloud and waiting for a response, your kiosk processes everything locally.


// This runs continuously in worker mode
$sensors = ['footTraffic', 'airQuality', 'temperature', 'humidity'];

frankenphp_handle_request(function() use ($sensors) {
    static $readings = [];
    
    foreach ($sensors as $sensor) {
        $newReading = getSensorData($sensor);
        $readings[$sensor][] = $newReading;
        
        // Process locally instead of sending to cloud
        if (count($readings[$sensor]) >= 50) {
            $trend = calculateTrend($readings[$sensor]);
            updateDisplay($sensor, $trend);
            
            // Keep memory usage reasonable
            $readings[$sensor] = array_slice($readings[$sensor], -25);
        }
    }
    
    return new Response(json_encode($readings));
});

// This runs continuously in worker mode

$sensors = ['footTraffic', 'airQuality', 'temperature', 'humidity'];

frankenphp_handle_request(function() use ($sensors) {

static $readings = [];

foreach ($sensors as $sensor) {

$newReading = getSensorData($sensor);

$readings[$sensor][] = $newReading;

// Process locally instead of sending to cloud

if (count($readings[$sensor]) >= 50) {

$trend = calculateTrend($readings[$sensor]);

updateDisplay($sensor, $trend);

// Keep memory usage reasonable

$readings[$sensor] = array_slice($readings[$sensor], -25);

}

return new Response(json_encode($readings));

});

The Benefits:

Lightning-fast responses (no cloud roundtrip)
Works even when the internet is down
Saves money on cloud computing costs
Your building manager gets real-time insights

3. Multi-Store Mall Kiosk (Because Sharing Is Caring)

Here’s a cool one: what if a single kiosk could host multiple store applications simultaneously? Like having different apps for each store in a mall, all running on the same hardware but completely isolated from each other.

FrankenPHP’s worker mode makes this possible by running separate workers for each application. Check out this Caddyfile setup:


{
    frankenphp {
        worker store-a/public/worker.php {
            num 2
        }
        worker store-b/public/worker.php {
            num 2  
        }
        worker mall-directory/public/worker.php {
            num 1
        }
    }
}

# Different subdomains for different stores
nike.mallkiosk.local {
    root * store-a/public
    php_server
}

starbucks.mallkiosk.local {
    root * store-b/public
    php_server
}

{

frankenphp {

worker store-a/public/worker.php {

num 2

}

worker store-b/public/worker.php {

num 2

}

worker mall-directory/public/worker.php {

num 1

}

# Different subdomains for different stores

nike.mallkiosk.local {

root * store-a/public

php_server

}

starbucks.mallkiosk.local {

root * store-b/public

php_server

}

What Makes This Awesome:

One piece of hardware, multiple applications
Each store gets their own isolated environment
Automatic scaling based on usage
Mall operators save big on hardware costs

4. Voice-Controlled Kiosks (Yes, Really!)

Accessibility is super important, and voice control can be a game-changer for users with visual impairments or mobility issues. FrankenPHP’s real-time capabilities make it perfect for building responsive voice interfaces.


class VoiceKioskController {
    private $mercure;
    
    public function __construct() {
        $this->mercure = new Publisher('/.well-known/mercure', $_ENV['JWT_KEY']);
    }
    
    public function handleVoiceCommand(Request $request) {
        $audioData = $request->getContent();
        
        // Use something like Google Speech-to-Text API
        $command = $this->convertSpeechToText($audioData);
        
        $response = match(strtolower($command)) {
            'show store directory' => $this->getStoreDirectory(),
            'find nearest restroom' => $this->findRestrooms(),
            'call security' => $this->alertSecurity(),
            'help' => $this->getHelp(),
            default => ['error' => 'Sorry, I didn\'t understand that']
        };
        
        // Push response to all connected displays
        $this->mercure->publish([
            'topic' => 'voice/response',
            'data' => json_encode($response)
        ]);
        
        return new JsonResponse($response);
    }
}

class VoiceKioskController {

private $mercure;

public function __construct() {

$this->mercure = new Publisher('/.well-known/mercure', $_ENV['JWT_KEY']);

}

public function handleVoiceCommand(Request $request) {

$audioData = $request->getContent();

// Use something like Google Speech-to-Text API

$command = $this->convertSpeechToText($audioData);

$response = match(strtolower($command)) {

'show store directory' => $this->getStoreDirectory(),

'find nearest restroom' => $this->findRestrooms(),

'call security' => $this->alertSecurity(),

'help' => $this->getHelp(),

default => ['error' => 'Sorry, I didn\'t understand that']

};

// Push response to all connected displays

$this->mercure->publish([

'topic' => 'voice/response',

'data' => json_encode($response)

]);

return new JsonResponse($response);

}

Why This Is Cool:

Immediate voice feedback (no waiting around)
Works alongside touch interfaces
Makes kiosks accessible to everyone
Your users will feel like they’re in a sci-fi movie

5. IoT Sensor Hub (For the Smart Building Enthusiasts)

This is where things get really interesting. Modern buildings are packed with sensors—temperature, occupancy, air quality, you name it. Your kiosk can become the central hub for all this data.


class SmartBuildingSensorHub {
    private static $instance = null;
    
    public static function getInstance() {
        return self::$instance ??= new self();
    }
    
    public function aggregateSensorData() {
        $sensors = [
            'hvac_zone_1' => 'http://hvac1.building.local/status',
            'occupancy_lobby' => 'http://occupancy.building.local/lobby',
            'air_quality' => 'http://airquality.building.local/reading',
            'energy_usage' => 'http://energy.building.local/current'
        ];
        
        // Use cURL multi to fetch all sensor data simultaneously
        $multiHandle = curl_multi_init();
        $curlHandles = [];
        
        foreach ($sensors as $name => $url) {
            $curlHandles[$name] = curl_init($url);
            curl_setopt($curlHandles[$name], CURLOPT_RETURNTRANSFER, true);
            curl_setopt($curlHandles[$name], CURLOPT_TIMEOUT, 3);
            curl_multi_add_handle($multiHandle, $curlHandles[$name]);
        }
        
        // Execute all requests at once
        do {
            curl_multi_exec($multiHandle, $running);
            curl_multi_select($multiHandle);
        } while ($running > 0);
        
        $results = [];
        foreach ($curlHandles as $name => $handle) {
            $results[$name] = json_decode(curl_multi_getcontent($handle), true);
            curl_multi_remove_handle($multiHandle, $handle);
            curl_close($handle);
        }
        
        curl_multi_close($multiHandle);
        return $results;
    }
}

class SmartBuildingSensorHub {

private static $instance = null;

public static function getInstance() {

return self::$instance ??= new self();

}

public function aggregateSensorData() {

$sensors = [

'hvac_zone_1' => 'http://hvac1.building.local/status',

'occupancy_lobby' => 'http://occupancy.building.local/lobby',

'air_quality' => 'http://airquality.building.local/reading',

'energy_usage' => 'http://energy.building.local/current'

];

// Use cURL multi to fetch all sensor data simultaneously

$multiHandle = curl_multi_init();

$curlHandles = [];

foreach ($sensors as $name => $url) {

$curlHandles[$name] = curl_init($url);

curl_setopt($curlHandles[$name], CURLOPT_RETURNTRANSFER, true);

curl_setopt($curlHandles[$name], CURLOPT_TIMEOUT, 3);

curl_multi_add_handle($multiHandle, $curlHandles[$name]);

}

// Execute all requests at once

do {

curl_multi_exec($multiHandle, $running);

curl_multi_select($multiHandle);

} while ($running > 0);

$results = [];

foreach ($curlHandles as $name => $handle) {

$results[$name] = json_decode(curl_multi_getcontent($handle), true);

curl_multi_remove_handle($multiHandle, $handle);

curl_close($handle);

}

curl_multi_close($multiHandle);

return $results;

}

The Payoff:

Real-time building insights displayed on your kiosk
All sensor data collected simultaneously (not one by one)
Building managers can spot issues before they become problems
Visitors get useful info like “Meeting Room B is currently available”

6. Offline-First Kiosks (Because WiFi Isn’t Always Reliable)

Ever been stuck at an airport with broken kiosks because the WiFi went down? FrankenPHP’s HTTP/3 support and excellent caching make it perfect for building Progressive Web Apps that work offline.


class OfflineKioskController {
    public function getServiceWorker() {
        $serviceWorker = <<<js const="" cache_name="airport-kiosk-v1" ;="" essentialassets="[" '="" ',="" styles="" app.css',="" js="" app.js',="" flights="" cached-schedule.json',="" maps="" terminal-layout.svg',="" info="" emergency-contacts.json'="" ];="" self.addeventlistener('install',="" event=""> {
            event.waitUntil(
                caches.open(CACHE_NAME)
                    .then(cache => cache.addAll(essentialAssets))
            );
        });
        
        self.addEventListener('fetch', event => {
            event.respondWith(
                caches.match(event.request)
                    .then(response => {
                        // Return cached version if available
                        if (response) return response;
                        
                        // Try to fetch from network
                        return fetch(event.request).catch(() => {
                            // If network fails, show offline page
                            return caches.match('/offline.html');
                        });
                    })
            );
        });
        JS;
        
        return new Response($serviceWorker, [
            'Content-Type' => 'application/javascript',
            'Cache-Control' => 'max-age=86400' // Cache for 24 hours
        ]);
    }
}</js>

class OfflineKioskController {

public function getServiceWorker() {

$serviceWorker = <<<js const="" cache_name="airport-kiosk-v1" ;="" essentialassets="[" '="" ',="" styles="" app.css',="" js="" app.js',="" flights="" cached-schedule.json',="" maps="" terminal-layout.svg',="" info="" emergency-contacts.json'="" ];="" self.addeventlistener('install',="" event=""> {

event.waitUntil(

caches.open(CACHE_NAME)

.then(cache => cache.addAll(essentialAssets))

);

});

self.addEventListener('fetch', event => {

event.respondWith(

caches.match(event.request)

.then(response => {

// Return cached version if available

if (response) return response;

// Try to fetch from network

return fetch(event.request).catch(() => {

// If network fails, show offline page

return caches.match('/offline.html');

});

})

);

});

JS;

return new Response($serviceWorker, [

'Content-Type' => 'application/javascript',

'Cache-Control' => 'max-age=86400' // Cache for 24 hours

]);

}

}</js>

What This Gets You:

Kiosks that work even when the internet doesn’t
Blazing fast load times thanks to HTTP/3
Automatic updates when connectivity returns
Happy users who can still get information during outages

7. AI-Powered Personal Shopping Assistant

Okay, this one’s pretty futuristic, but totally doable. FrankenPHP’s worker mode can keep machine learning models loaded in memory, making personalized recommendations lightning-fast.


class AIShoppingAssistant {
    private static $recommendationModel = null;
    private static $userProfiles = [];
    
    public static function initializeModel() {
        if (self::$recommendationModel === null) {
            // Load your TensorFlow Lite model or similar
            self::$recommendationModel = loadModel('/models/shopping_recommendations.tflite');
        }
    }
    
    public function getPersonalizedRecommendations($userId, $context) {
        self::initializeModel();
        
        $profile = self::$userProfiles[$userId] ?? $this->createNewProfile($userId);
        
        $features = [
            'time_of_day' => date('H'),
            'day_of_week' => date('w'),
            'weather' => $context['weather'] ?? 'unknown',
            'previous_purchases' => $profile['purchase_history'],
            'current_location' => $context['store_section'] ?? 'entrance'
        ];
        
        $recommendations = self::$recommendationModel->predict($features);
        
        // Update profile with this interaction
        self::$userProfiles[$userId] = $this->updateProfile($profile, $context);
        
        return $this->formatRecommendations($recommendations);
    }
}

class AIShoppingAssistant {

private static $recommendationModel = null;

private static $userProfiles = [];

public static function initializeModel() {

if (self::$recommendationModel === null) {

// Load your TensorFlow Lite model or similar

self::$recommendationModel = loadModel('/models/shopping_recommendations.tflite');

}

public function getPersonalizedRecommendations($userId, $context) {

self::initializeModel();

$profile = self::$userProfiles[$userId] ?? $this->createNewProfile($userId);

$features = [

'time_of_day' => date('H'),

'day_of_week' => date('w'),

'weather' => $context['weather'] ?? 'unknown',

'previous_purchases' => $profile['purchase_history'],

'current_location' => $context['store_section'] ?? 'entrance'

];

$recommendations = self::$recommendationModel->predict($features);

// Update profile with this interaction

self::$userProfiles[$userId] = $this->updateProfile($profile, $context);

return $this->formatRecommendations($recommendations);

}

Why This Is Mind-Blowing:

Instant personalized recommendations (no API delays)
ML models stay loaded and ready
Privacy-focused (all processing happens locally)
Shoppers get suggestions that actually make sense

Making It All Work: Performance Tips

Hardware That Won’t Break the Bank

Budget Option: Raspberry Pi 4 (8GB model recommended)
Better Performance: Any modern x86_64 mini PC with 8GB+ RAM
Pro Tip: Use an SSD instead of SD card for better performance

Tuning FrankenPHP for Kiosks


{
    # Optimize for your hardware
    frankenphp {
        num_threads 4      # Match your CPU cores
        max_threads 8      # Allow for traffic spikes
    }
}

{

# Optimize for your hardware

frankenphp {

num_threads 4 # Match your CPU cores

max_threads 8 # Allow for traffic spikes

}


// Memory management for long-running kiosks
ini_set('memory_limit', '256M');
ini_set('max_execution_time', 0); // No timeouts in worker mode

// Cleanup memory periodically
if (memory_get_usage() > 200 * 1024 * 1024) { // 200MB threshold
    gc_collect_cycles();
    if (function_exists('opcache_reset')) {
        opcache_reset();
    }
}

// Memory management for long-running kiosks

ini_set('memory_limit', '256M');

ini_set('max_execution_time', 0); // No timeouts in worker mode

// Cleanup memory periodically

if (memory_get_usage() > 200 * 1024 * 1024) { // 200MB threshold

gc_collect_cycles();

if (function_exists('opcache_reset')) {

opcache_reset();

}

Security (Because Nobody Wants Their Kiosk Hacked)

Free HTTPS: FrankenPHP automatically handles Let’s Encrypt certificates
JWT Auth: Use JWT tokens for admin access
Worker Isolation: Each application runs in its own worker (no data leaks)
Regular Updates: Keep FrankenPHP updated through your deployment pipeline

Getting Started Resources

Ready to build something awesome? Here are the essential links:

REALFUSION – Smart Modular Kiosk Marketing
FrankenPHP Official Docs – Your starting point
Mercure Protocol Guide – For real-time features
Caddy Documentation – Understanding the underlying web server
FrankenPHP GitHub – Source code and examples
Performance Tuning Guide – Make it fast
Worker Mode Tutorial – The secret sauce

Wrapping Up

FrankenPHP is seriously changing the game for kiosk applications. We’re talking about moving from those sluggish, prehistoric kiosks to lightning-fast, AI-powered, real-time interactive experiences. Whether you’re building a simple digital sign or a complex multi-tenant smart building interface, FrankenPHP gives you the tools to make it happen.

The best part? You’re using PHP—a language that millions of developers already know. No need to learn Go, Rust, or some esoteric systems language. Just good old PHP, but supercharged with modern performance and capabilities.

So what are you waiting for? Go build something cool! And when you do, make sure to share it with the community. The kiosk revolution is just getting started, and we need all the creative minds we can get.

Let’s Talk!

Looking for a reliable partner to bring your project to the next level? Whether it’s development, design, security, or ongoing support—I’d love to chat and see how I can help.

Get in touch,
and let’s create something amazing together!

Semantic Editors in JavaScript – Lets keep that Code Clean!

Development / Content Creation / Content Managment / HTML5 / Javascript

If you’ve ever tried to style text in a WYSIWYG editor and ended up with HTML that looked like a spaghetti disaster, you’ve already met the reason why semantic editors meaning, structure, and sanity. In other words: they keep your content clean, organized, and machine-friendly. This article walks you through the most important semantic and […]

Meet the Isolated Block Editor – Gutenberg, Untethered – Integrated into Elementor

Design / Content Creation / Content Managment / Development / WordPress

If you’ve ever worked with text editors on the web, you know the routine: dependencies everywhere, fragile integrations, and editors that only behave when the stars align. The Isolated Block Editor (IBE) solves this by taking the core of Gutenberg and making it work anywhere — no WordPress environment required. It gives you the power […]

Best WordPress Table Plugins: Global Plugins vs Elementor Tools

Design / Content Creation / CSS / Development / HTML5 / Plugins / SEO / WordPress

Let’s be real—WordPress’s default table block is kind of… meh. It gets the job done for super basic tables, but the moment you need sorting, filtering, or something that doesn’t look like it’s stuck in 2010, you’re out of luck. That’s where table plugins come in, and trust me, there’s a whole world of options […]

Alexander

I am a full-stack developer. My expertise include:

Server, Network and Hosting Environments
Data Modeling / Import / Export
Business Logic
API Layer / Action layer / MVC
User Interfaces
User Experience
Understand what the customer and the business needs

I have a deep passion for programming, design, and server architecture—each of these fuels my creativity, and I wouldn’t feel complete without them.

With a broad range of interests, I’m always exploring new technologies and expanding my knowledge wherever needed. The tech world evolves rapidly, and I love staying ahead by embracing the latest innovations.

Beyond technology, I value peace and surround myself with like-minded individuals.

I firmly believe in the principle: Help others, and help will find its way back to you when you need it.