Phase 1 sub-commit 4: Qt foundation types

BackendConnection (QML singleton via create() factory) reads BRIDGE_URL and BRIDGE_TOKEN from env, periodically probes <url>/healthz with a 2s transfer timeout, and exposes a Connecting/Online/Error state machine plus error/token properties to QML. Bundled-mode startup (spawning the embedded FrankenPHP child) is a Phase 4 deliverable; restart() is a no-op for now. tokenRotated signal is reserved for the per-session secret rotation described in PLAN.md §3. SingleInstance is C++-only — main() must call acquireOrForward() before the QML engine boots, so it's exposed via context property rather than QML_SINGLETON. QLocalServer-based lock with stale-socket detection, launch-arg forwarding via QDataStream, and the deadlock-avoiding race fallback specified in §3 *Edge cases*. CMakeLists.txt declares the PhpQml.Bridge static QML module with both sources and is dual-mode: stands alone for sanity builds, integrates via add_subdirectory from the skeleton's top-level CMake (Phase 1 sub-commit 6). Standalone build verified clean. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
2026-05-02 01:18:43 +02:00
parent b3932674dd
commit 87b5b2283c
5 changed files with 358 additions and 9 deletions
--- a/framework/qml/src/BackendConnection.cpp
+++ b/framework/qml/src/BackendConnection.cpp
@@ -0,0 +1,104 @@
+#include "BackendConnection.h"
+
+#include <QNetworkAccessManager>
+#include <QNetworkReply>
+#include <QNetworkRequest>
+#include <QQmlEngine>
+#include <QTimer>
+#include <QUrl>
+
+namespace PhpQml::Bridge {
+
+namespace {
+constexpr int kInitialProbeMs = 0;
+constexpr int kProbeIntervalMs = 5000;
+constexpr int kProbeTimeoutMs = 2000;
+} // namespace
+
+BackendConnection::BackendConnection(QObject* parent)
+    : QObject(parent)
+    , m_nam(new QNetworkAccessManager(this))
+    , m_retryTimer(new QTimer(this))
+{
+    m_url = QString::fromUtf8(qgetenv("BRIDGE_URL"));
+    m_token = QString::fromUtf8(qgetenv("BRIDGE_TOKEN"));
+
+    if (m_url.isEmpty()) {
+        // Dev-mode fallback: matches the spike's hardcoded port and
+        // documents the convention. See PLAN.md §11 *Open Questions*
+        // (system FrankenPHP collision on :8080).
+        m_url = QStringLiteral("http://127.0.0.1:8765");
+    }
+
+    m_retryTimer->setSingleShot(false);
+    m_retryTimer->setInterval(kProbeIntervalMs);
+    connect(m_retryTimer, &QTimer::timeout, this, &BackendConnection::probe);
+
+    QTimer::singleShot(kInitialProbeMs, this, &BackendConnection::probe);
+    m_retryTimer->start();
+}
+
+BackendConnection::~BackendConnection() = default;
+
+BackendConnection* BackendConnection::create(QQmlEngine* engine, QJSEngine*)
+{
+    return new BackendConnection(engine);
+}
+
+void BackendConnection::restart()
+{
+    // No-op in dev mode (Phase 1). Phase 4 re-spawns the bundled child.
+    probe();
+}
+
+void BackendConnection::probe()
+{
+    if (m_pendingReply) return;
+
+    QNetworkRequest req;
+    req.setUrl(QUrl(m_url + QStringLiteral("/healthz")));
+    req.setTransferTimeout(kProbeTimeoutMs);
+    if (!m_token.isEmpty()) {
+        req.setRawHeader("Authorization", "Bearer " + m_token.toUtf8());
+    }
+
+    m_pendingReply = m_nam->get(req);
+    connect(m_pendingReply, &QNetworkReply::finished, this, &BackendConnection::onProbeFinished);
+}
+
+void BackendConnection::onProbeFinished()
+{
+    QNetworkReply* reply = m_pendingReply;
+    m_pendingReply = nullptr;
+    if (!reply) return;
+    reply->deleteLater();
+
+    if (reply->error() == QNetworkReply::NoError) {
+        const int status = reply->attribute(QNetworkRequest::HttpStatusCodeAttribute).toInt();
+        if (status == 200) {
+            setError(QString());
+            setState(ConnectionState::Online);
+            return;
+        }
+        setError(QStringLiteral("/healthz returned HTTP %1").arg(status));
+    } else {
+        setError(reply->errorString());
+    }
+    setState(ConnectionState::Error);
+}
+
+void BackendConnection::setState(ConnectionState s)
+{
+    if (m_state == s) return;
+    m_state = s;
+    emit connectionStateChanged();
+}
+
+void BackendConnection::setError(const QString& msg)
+{
+    if (m_error == msg) return;
+    m_error = msg;
+    emit errorChanged();
+}
+
+} // namespace PhpQml::Bridge