Phase 1 sub-commit 6: skeleton wiring — make dev runs end-to-end
Symfony app under framework/skeleton/symfony/: minimal bin/console,
public/index.php, MicroKernel-based src/Kernel.php, services.yaml,
framework/security/mercure config, and a demo App\Controller\PingController
that GETs /api/ping (returning JSON pong) and republishes the same
payload to the Mercure topic app://ping. composer.json uses a path
repository to symlink the bundle from ../../php so local edits are
picked up live.
QML app under framework/skeleton/qml/: top-level CMake that
add_subdirectory's framework/qml, a main.cpp that creates the Qt
process, runs SingleInstance.acquireOrForward before any QML loads,
exposes SingleInstance via context property, and loadFromModule's
Skeleton.Main. Main.qml uses BackendConnection / RestClient /
MercureClient from PhpQml.Bridge and renders status dots, a Ping
button, and an event log.
Caddyfile binds 127.0.0.1:8765, enables in-memory Mercure with a
256-bit dev JWT (matches symfony/.env, lcobucci/jwt requires this).
Makefile wraps build / dev / doctor / clean; scripts/dev.sh starts
FrankenPHP --watch and the Qt host together with explicit PID-based
teardown (process-group `kill 0` proved unreliable when frankenphp's
watch fork reparented).
Bug fixes uncovered in this sub-commit:
- SingleInstance.acquireOrForward: probe-first, then removeServer +
retry-listen. The original loop-with-removeServer-after-failed-bind
silently exited on stale sockets from prior runs.
- Main.qml: MercureClient does NOT inherit BackendConnection.token —
Mercure subscribes anonymously in dev (Caddyfile), and forwarding
the bridge bearer made it 401-loop.
- /api/ping was 500ing because the dev MERCURE_JWT_SECRET was 144 bits;
bumped to 64-char (>=256 bit) to satisfy lcobucci/jwt.
- Linked the framework lib (php_qml_bridge) explicitly in addition to
the QML plugin so SingleInstance.h resolves.
- Auto-generated config/reference.php gitignored.
Smoke verified offscreen: /healthz 200, /api/ping 200, 1 publish, 1
subscriber, zero 401s, clean shutdown with no zombies.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-02 01:50:16 +02:00
|
|
|
# php-qml framework skeleton — FrankenPHP / Caddy / Mercure config (dev mode).
|
|
|
|
|
#
|
|
|
|
|
# Run from the skeleton/symfony/ directory so relative `php_server` paths
|
|
|
|
|
# resolve correctly: cd framework/skeleton/symfony && frankenphp run --watch
|
|
|
|
|
# --config ../Caddyfile.
|
|
|
|
|
|
|
|
|
|
{
|
|
|
|
|
auto_https off
|
|
|
|
|
admin off
|
|
|
|
|
frankenphp
|
|
|
|
|
order php_server before respond
|
|
|
|
|
order mercure after encode
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
http://127.0.0.1:8765 {
|
|
|
|
|
root * public/
|
|
|
|
|
encode gzip
|
|
|
|
|
|
|
|
|
|
mercure {
|
|
|
|
|
transport local
|
|
|
|
|
# Must match MERCURE_JWT_SECRET in symfony/.env. lcobucci/jwt
|
|
|
|
|
# requires >= 256 bits, hence the long dev value.
|
|
|
|
|
publisher_jwt dev_php_qml_bridge_jwt_secret_at_least_256_bits_long_for_lcobucci
|
|
|
|
|
subscriber_jwt dev_php_qml_bridge_jwt_secret_at_least_256_bits_long_for_lcobucci
|
|
|
|
|
anonymous
|
|
|
|
|
publish_origins *
|
|
|
|
|
cors_origins *
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
php_server
|
|
|
|
|
|
|
|
|
|
log {
|
|
|
|
|
output stderr
|
|
|
|
|
format console
|
|
|
|
|
}
|
|
|
|
|
}
|