Version 0.1.34

Dokumentation zu webspine

Eine Schritt-für-Schritt-Anleitung, um mit einer KI-App eine Website zu bauen, und danach die technische Referenz für KI-Apps und Entwickler.

Baue deine Website mit einer KI-App

webspine funktioniert mit jeder KI-App, die Projektdateien bearbeiten kann. Am besten funktioniert es mit Claude Code in der Claude-Desktop-App, verbunden mit deinem Server, wie unten gezeigt.

Am besten mit Claude Code direkt auf deinem Server

Verbinde die Claude-Desktop-App per SSH mit deinem Server. Claude baut die Website dann dort, wo sie laufen wird. Veröffentlichen ist kein eigener Schritt mehr.

Öffne in Claude den Bereich Code. Öffne unter dem Eingabefeld die Umgebungsauswahl und wähle New environment. Öffne im Tab SSH das Feld Host, wähle Add SSH connection… und trage die Zugangsdaten deines Servers ein.

ClaudeIllustrierte Anleitung
ChatCoworkCode

Umgebungsauswahl › New environment › SSH › Host

Add SSH connection

Name
Mein Webserver
SSH host
deploy@meine-domain.de
SSH port
22
SSH key (optional)
~/.ssh/id_ed25519
CancelAdd SSH connection

Wähle im Tab SSH die neue Verbindung und den Ordner auf dem Server, in dem die Website liegen soll. Klicke dann auf Create environment. Bei der ersten Verbindung installiert Claude Claude Code automatisch auf dem Server.

ClaudeIllustrierte Anleitung
ChatCoworkCode

Umgebungsauswahl › New environment

New environment

LocalSSHCloud
Host
Mein Webserver
Folder
~/meine-website
CancelCreate environment

Claude arbeitet jetzt direkt auf deinem Server. Beschreibe deine Website und öffne dann deine Domain im Browser, um das Ergebnis anzusehen.

ClaudeIllustrierte Anleitung
ChatCoworkCode

New session

SSH · Mein Webserver~/meine-website
Baue mir in diesem Ordner eine Website mit webspine.org.
Lies zuerst https://www.webspine.org/de/docs#technical-reference.

Sie ist für [meine Idee oder mein Unternehmen].
Ich brauche [meine Seiten].
Sie soll [mein gewünschter Stil] wirken.

Die Domain [meine-domain.de] zeigt auf diesen Server. Richte alles so ein, dass der Webserver den Ordner public/ ausliefert, und sag mir, wann ich sie mir ansehen kann.
meine-domain.de

Deine Website, auf deinem Server

Öffne sie im Browser und bitte um Änderungen.

Spätere Änderungen funktionieren genauso. Claude ändert die Dateien auf dem Server, deshalb musst du danach nichts hochladen oder veröffentlichen.

ClaudeIllustrierte Anleitung
ChatCoworkCode

New session

SSH · Mein Webserver~/meine-website
Ergänze eine Seite für meine neuesten Projekte. Sichere die Website vorher und sag mir danach, was du geändert hast.
meine-domain.deOnline. Kein Upload nötig.

Du brauchst die Claude-Desktop-App und einen Server oder ein Hosting-Paket mit SSH-Zugang, PHP 8.3 oder neuer und SQLite. Ohne SSH-Zugang wählst du stattdessen Local und lässt dir von Claude beim Veröffentlichen der fertigen Website helfen.

Claude-Code-Dokumentation zu SSH-Sitzungen

Mit einer anderen KI-App

ChatGPT Desktop, OpenCode und ähnliche Apps funktionieren auch. Sie bauen die Website meist in einem Ordner auf deinem Computer, deshalb ist das Veröffentlichen am Ende ein eigener Schritt.

Sag deiner KI, was sie bauen soll

Ein Portfolio, eine Studio-Website oder ein Ort für dein nächstes Projekt. Beschreibe den Zweck, die benötigten Seiten und deinen gewünschten Stil. Mit dieser Anfrage kannst du starten.

DEINE ERSTE ANFRAGE
Erstelle mir eine Website mit webspine.org.

Meine Website ist für: [deine Idee oder dein Unternehmen]
Sie braucht diese Seiten: [deine Seiten]
So soll sie aussehen und wirken: [dein Stil]

Erstelle die Website und zeige mir eine Vorschau, damit wir sie gemeinsam verfeinern können.

Prüft die Vorschau gemeinsam

Deine KI baut die erste Version. Sieh dir die Vorschau an und beschreibe, was du ändern möchtest: „Mach die Überschrift klarer.“ „Ergänze meine neuesten Arbeiten.“ „Nutze wärmere Farben.“ Macht weiter, bis sich die Website nach dir anfühlt.

Details prüfen und veröffentlichen

Schau dir die Seiten an, probiere die Navigation aus und prüfe die Website auf Desktop und Smartphone. Bitte deine KI, die Details zu verfeinern, bis Design und Inhalte für dich passen. Deine fertige Website gehört dir und lässt sich weiterentwickeln.

Spätere Änderungen funktionieren genauso

Neue Seiten, frische Texte oder ein anderes Design. Geh zurück zu deiner KI, beschreibe deine nächste Idee und lass sie an derselben Website weiterarbeiten.

Du brauchst die Details? Zur technischen Referenz
Für KI-Apps und Entwickler

So funktioniert webspine

Für dein KI-Tool und alle, die webspine von Hand entwickeln oder pflegen. Folge der Installationsanleitung, lerne die Projektstruktur kennen und nutze die Referenz, um die Website weiterzuentwickeln und zu veröffentlichen.

Versionierte Framework-Referenz auf GitHub lesen
Zurück zum KI-Nutzerleitfaden
01 / LOS GEHT’S

Schnellstart

Lade für eine neue Website eine vollständige Bootstrap-ZIP aus einem offiziellen stabilen GitHub-Release herunter und entpacke sie. Eine Core-ZIP aktualisiert eine bestehende Installation; sie erstellt keine neue Website. Du brauchst PHP 8.3+ mit pdo_sqlite, openssl für SMTP und zip für Pakete und Updates. Kein Composer, npm oder Build-Schritt.

webspine auf GitHub herunterladen
php core/bin/console.php install
php core/bin/console.php health
php -S localhost:8080 -t public public/router.php

Öffne localhost:8080. Die Installation erstellt ausdrücklich SQLite-Tabellen, vermerkt Schema-Version 1 und wählt das Starter-Theme. Eine erneute Installation erhält Einstellungen und Seiten. Normale Anfragen installieren oder migrieren keine Datenbank.

Nutze den PHP-Entwicklungsserver lokal. Konfiguriere für den Produktivbetrieb den Webserver mit public/ als einzigem öffentlichen Stammverzeichnis.
02 / DIE ABSICHT

Prinzipien

Das Hauptziel von webspine ist, dass du deine eigene Website vollständig mit KI erstellen, erweitern und pflegen kannst. Vertrauter Code, eine lesbare Struktur und klare Schnittstellen machen das Projekt für eine KI verständlich.

Nutze eine KI-App mit Zugriff auf die Projektdateien, etwa ChatGPT Desktop, Claude Code oder OpenCode. Das Projekt bleibt unabhängig von KI-Anbietern; du kannst auch jede Datei von Hand bearbeiten.

  • Halte den Core klein und verständlich.
  • Halte Inhalte und Routen in site/, die Darstellung in site/themes/, und Funktionen in site/plugins/.
  • Wähle Provider ausdrücklich aus. Vermeide versteckte Konfiguration in der Datenbank.
  • Erhalte die Identität eines Themes. Jede Website kann anders aussehen.

KI-Mitwirkende sollen bestehende Arbeit prüfen, Änderungen gezielt vornehmen, passende Prüfungen ausführen, Lücken benennen und Zugangsdaten schützen.

03 / EIN PLATZ FÜR ALLES

Projektstruktur

core/Framework, mitgelieferte Provider, Werkzeuge, Tests und Anleitungen
site/Website-Identität, Seitendefinitionen, Routen und Installation
site/content/Bearbeitbare PHP-Inhaltsarrays; diese Website ergänzt englische/deutsche Kataloge über eine eigene Lokalisierung
site/themes/Templates, gemeinsame Layouts, eingegrenztes CSS und Browser-JavaScript
site/plugins/Provider- und Funktionserweiterungen mit Manifesten
config/Private Provider-Auswahl und Zugangsdaten
storage/SQLite, Update-Zwischenstände, Sicherungen und Sperren
public/Das einzige öffentliche Stammverzeichnis
core/bin/Installation, Zustandsprüfungen, Paketerstellung und Updates
.dist/Erzeugte Release-ZIPs und Prüfsummen
core/tests/Integrationstests ohne zusätzliche Abhängigkeiten
core/docs/Architektur, Veröffentlichung und Hinweise für Mitwirkende

Der SQLite-Provider implementiert Speicher, Einstellungen, Seiten und optional Entities-CRUD. Plugins deklarieren typisierte Entitäten und nutzen gemeinsame create/read/list/update/delete-Operationen nach php core/bin/console.php entities:install. Beispiele stehen in core/docs/entities.md und site/plugins/catalog/. Funktions-Plugins nutzen Schnittstellen, nie Provider-spezifisches SQL. MariaDB- und PostgreSQL-Adapter benötigen eigene Abfragen, Migrationen und Werkzeuge zur Datenübertragung.

SQLite unterstützt außerdem die optionalen Fähigkeiten EntityQueries und EntityIndexes am Entities-Service. Verwende EntityFilter und EntityQuery für typisierte Filter, Sortierung, search() und count(); prüfe die Fähigkeiten des Providers ausdrücklich. Deklariere Indizes mit defineIndex() und führe entities:install aus, um sie anzulegen. Abfragen, Health-Checks und Core-Updates legen keine Indizes an und schreiben keine Datensätze um.

Referenz für Entity-Abfragen und Indizes lesen
04 / BEWUSST AUSWÄHLEN

Konfiguration

Kopiere config/example.php nach config/local.php. Halte die lokale Datei privat. Wähle hier Provider und aktivierte Funktions-Plugins aus, bevor auf die Datenbank zugegriffen wird.

'providers' => ['storage' => 'sqlite', 'mail' => null],
'plugins' => [],
'sqlite' => ['path' => 'storage/site.sqlite'],

Wähle 'mail' => 'smtp' und ergänze die SMTP-Konfiguration, um das mitgelieferte PHPMailer zu aktivieren. Der Provider benötigt TLS und versendet reine Textnachrichten. Mail und Funktions-Plugins sind im Starter standardmäßig deaktiviert. Das optionale Kontaktformular mit Versandwarteschlange wird ausdrücklich übernommen; siehe die Abschnitte unten.

SQLite gehört auf einen lokalen Datenträger mit begrenzten gleichzeitigen Schreibzugriffen. Halte Datenbank und Update-Sicherungen außerhalb des öffentlichen Stammverzeichnisses.

05 / DEIN AUSDRUCK

Themes

Dupliziere site/themes/starter/, wähle eine Verzeichnis-ID in Kleinbuchstaben und aktualisiere theme.json. Behalte API-Version 1 bei und stelle layout.php sowie die Templates bereit, die in site/pages.phpreferenziert werden. Das gemeinsame Layout umschließt jede Seite. Bearbeite Texte in site/content/, Seitentitel in site/pages.phpund die Identität in site/meta.php; Markup und Styles gehören in die Theme-Dateien.

php core/bin/console.php theme your-theme

Das aktive Theme wird vom Einstellungs-Service gespeichert. Assets werden ausschließlich aus dem assets/ Ordner des ausgewählten Themes über eine eingeschränkte Route ausgeliefert. Begrenze CSS auf eine Theme-Klasse, maskiere Texte mit e()und setze JavaScript als progressive Erweiterung ein.

PHP-Themes und Plugins führen vertrauenswürdigen Code aus. Prüfe sie vor der Installation; sie sind nicht in einer Sandbox isoliert.

Wiederverwendbare PHP-Komponenten liegen in site/themes/<id>/components/. Übergib ausdrücklich Props mit $app->theme->component(); Komponenten erhalten $props und $ui, ohne Seitenvariablen oder Services. Seiten und Layouts erhalten ebenfalls $ui für verschachtelte component()-, id()- und assetUrl()-Aufrufe. Nutze e($ui->assetUrl('style.css')) für eine Theme-Asset-URL mit einer Version aus dem Inhaltshash. Seiten und Layouts haben getrennte Variablenbereiche: Übergib gemeinsame Werte über Render-Daten und greife bei reservierten Namen über $data darauf zu. Beispiele und Regeln zum Render-Lebenszyklus stehen in core/docs/site.md, einschließlich refresh() nach manuellen Einstellungs- oder Dateiänderungen bei wiederverwendeten App-Instanzen.

Seitenpfade und ausdrückliche Weiterleitungen.

Ein optionaler path in site/pages.php registriert eine GET-/HEAD-Seitenroute. slash akzeptiert preserve (Standard), strip oder append; strip/append ergänzen eine 308-Weiterleitung für die alternative Schreibweise mit oder ohne abschließenden Schrägstrich und erhalten den unveränderten Query-String. Entferne vor der Übernahme die entsprechende manuelle GET-Route: doppelte exakte oder passende Pattern-Routen führen zu einem Fehler. Core-Updates erhalten bestehende Website-Routen. Verwende Response::redirect() für validierte lokale Weiterleitungen; Seitenpfade erzeugen keine SEO-Canonical-Tags oder mehrsprachigen Routen.

// site/pages.php
'about' => ['path' => '/about', 'slash' => 'strip',
    'template' => 'page', 'title' => 'About'],
Anleitung für Seitenrouten und Weiterleitungen lesen
06 / KLARE VERBINDUNGEN

Plugins und Services

Eigene Plugins liegen in site/plugins/, mitgelieferte Provider in core/plugins/. IDs müssen über beide Verzeichnisse hinweg eindeutig sein. Jedes Plugin deklariert seine ID, semantische Version, API und Abhängigkeiten in plugin.json. Die Einstiegsdatei liefert ein Objekt zurück, das folgende Schnittstelle implementiert: Webspine\Contracts\Plugin.

{
  "id": "my-feature", "version": "0.1.0", "api": 1,
  "dependencies": {"field-notes": "0.1.0"}
}
public function register(App $app): void {
    $pages = $app->services->get(Pages::class);
    $app->router->get('/hello', function () use ($pages, $app) {
        $page = $pages->find('hello');
        return $app->theme->render('page', [
            'title' => $page['title'], 'body' => $page['body'],
        ]);
    });
}

Die Registry akzeptiert Implementierungen deklarierter Schnittstellen und lehnt doppelte Registrierungen ab. Provider registrieren Services; Funktions-Plugins nutzen sie. Provider müssen in der privaten Konfiguration ausgewählt werden, statt implizit über Abhängigkeiten geladen zu werden.

GET-/POST-Handler können Webspine\Request erhalten; Pattern-Handler erhalten ($matches, $request). Nutze query(), header(), form() oder json() und prüfe die Datentypen. Request-Bodys sind auf 64 KiB, Query-Strings auf 8 KiB begrenzt; form() unterstützt URL-kodierte Daten, keine Multipart-Uploads. POST-Routen ergänzen Authentifizierung, CSRF-Schutz, Validierung oder Missbrauchsschutz nicht automatisch. Das kopierte Kontaktformular-Beispiel übernimmt Sitzung, Validierung und Missbrauchsschutz selbst und speichert Versandaufträge in der mitgelieferten job-queue.

Das funktionierende Beispiel-Plugin ansehen

Plugin-Befehle entdecken.

Aktivierte vertrauenswürdige Plugins können über cli.register und ConsoleCommands lokale Betreiberbefehle registrieren. help listet diese Befehle auf; help <Befehl> zeigt ihre Verwendung. help --core lädt zur Diagnose keine Website-Konfiguration. Handler verantworten Argumentprüfung und Speichereinrichtung; die Befehlserkennung installiert oder migriert nichts. Bestehende Befehle über core/plugins/job-queue/cli.php bleiben unterstützt.

php core/bin/console.php help
php core/bin/console.php help job-queue:work
php core/bin/console.php help --core
Anleitung für Plugin-Befehle und Cron lesen
OPTIONALE FUNKTIONEN

Kontaktformulare, die zuerst speichern.

Gib Besuchern eine Möglichkeit, dich zu erreichen. Das kopierbare Kontaktformular-Beispiel speichert gültige Nachrichten dauerhaft in einer Warteschlange, bevor ein Hintergrundprozess sie über deinen Mail-Provider versendet. Die Bestätigung bedeutet für den Versand gespeichert. Der Starter aktiviert kein Formular automatisch.

Kopiere plugin.php, plugin.json, FormText.php, ContactForm.php und MailDelivery.php aus core/docs/examples/contact-form/ nach site/plugins/contact-form/. Übernimm Template, Styles und Texte in dein ausgewähltes Theme und die Website-Inhalte oder passe deine vorhandene Darstellung an. Ergänze die private Konfiguration unten, füge das Plugin deiner bestehenden Liste hinzu, konfiguriere SMTP und installiere den Warteschlangenspeicher. Die mitgelieferte job-queue-Abhängigkeit wird automatisch geladen.

// Merge into private config/local.php; preserve other settings.
'plugins' => ['contact-form'],
'contact_form' => [
    'recipient' => 'you@example.com',
    'path' => '/contact-example',
    'retry' => ['max_attempts' => 30],
],

Seit 0.1.12 bleiben bei einem passenden, abgelaufenen Formular-Token sichere Eingaben erhalten. Ein neues Token ermöglicht Prüfen und erneutes Absenden. Fehlende oder fremde Tokens verwerfen die Eingaben. Identische Wiederholungen einer erfolgreichen Anfrage in derselben Sitzung führen erneut zur Bestätigung, ohne einen weiteren Auftrag anzulegen. Feldgrenzen entsprechen den UTF-16-Codeeinheiten des Browsers; neue Aufträge verwenden Payload-Version 2, der Versand unterstützt weiterhin Version 1.

Neue Kontaktaufträge verwenden standardmäßig insgesamt 30 Zustellversuche. retry.max_attempts akzeptiert eine Ganzzahl von 1–100. Exponentielle Wartezeiten wachsen von einer Minute bis zu einer Stunde; bei 30 Versuchen ist der letzte etwa 24 Stunden und 3 Minuten nach dem ersten geplant, ohne Transportdauer und Cron-Verzögerungen. Bestehende Aufträge behalten ihr gespeichertes Versuchslimit. SMTP arbeitet nach dem At-least-once-Prinzip; ein Absturz kann deshalb zu doppelter Zustellung führen.

Das aktuelle kopierbare Beispiel speichert das validierte email-Feld als Reply-To-Snapshot. Mitgeliefertes SMTP unterstützt MailWithReplyTo und erhält den festen Empfänger sowie die konfigurierte From-Identität. Setze contact_form.reply_to_field auf ein anderes E-Mail-Feld oder auf null, um Reply-To für neue Aufträge zu deaktivieren. Provider ohne diese Fähigkeit verwenden gewöhnliches Mail; die Besucheradresse bleibt im Nachrichtentext. Ältere Aufträge ohne Reply-To-Snapshot behalten ihr Verhalten. Reply-To authentifiziert Besucher nicht und garantiert keine Zustellung.

Core-Updates erhalten kopierte Website-Plugins. Prüfe und übernimm für neuere Kontaktfunktionen die aktuellen Beispieldateien einschließlich FormText.php, kompatibler Inhaltsfelder und deklarierter job-queue-Abhängigkeit. Erhalte private Einstellungen, Templates und bestehende Aufträge; eine Queue-Schemamigration ist nicht nötig. Diese Website verwendet ein eigenes angepasstes Plugin unter /feedback und /de/feedback; ein Core-Update allein ergänzt dessen Kopie nicht um das neue Reply-To-Verhalten.

Anleitung zur Übernahme des Kontaktformulars
OPTIONALE FUNKTIONEN

Eine Warteschlange für Hintergrundaufgaben.

Das optionale mitgelieferte Plugin job-queue trennt dauerhaftes Speichern von der Verarbeitung im Hintergrund. Verbraucher registrieren Handler für benannte, versionierte Auftragstypen. Payloads sind erweiterbare JSON-Objekte mit höchstens 64 KiB und begrenzter Tiefe. Deduplizierungsschlüssel verhindern widersprüchliche Daten; zeitlich begrenzte Claims und Tokens schützen parallele Worker. Allgemeine Aufträge haben standardmäßig fünf Versuche, unabhängig vom Kontaktformular.

Installiere den Speicher ausdrücklich und plane work mit einem absoluten Skriptpfad und deiner PHP-Version ein, zum Beispiel jede Minute. Jeder Aufruf verarbeitet höchstens zehn Aufträge. Fehlende oder pausierte Handler verbrauchen keine Versuche. Es gibt keinen Web-Worker-Endpunkt und keinen Versand während der Formularanfrage. Halte storage/job-queue privat und für die vertrauenswürdige Web-/CLI-Gruppe beschreibbar.

php core/bin/console.php job-queue:install
php core/bin/console.php job-queue:status
php core/bin/console.php job-queue:work
php core/bin/console.php job-queue:health
php core/bin/console.php job-queue:retry <job-id>
php core/bin/console.php job-queue:prune 30

Seit 0.1.13 zeigt status das Alter wartender und fälliger Aufträge, abgelaufene Claims sowie Worker-Start und -Ende. Der private Befehl health liefert JSON-Warnungen und einen Fehler-Exitcode, wenn Aufmerksamkeit nötig ist. job_queue.stale_after_seconds ist standardmäßig 900; erlaubt sind ganze Zahlen von 60 bis 604800. Zukünftig eingeplante Versuche gelten nicht als überfällig. Überwache den Befehl extern; ein Heartbeat beweist keine E-Mail-Zustellung. Das öffentliche /health bleibt unabhängig vom Versandrückstand.

CLI work entfernt pro regulärem Aufruf automatisch bis zu 1.000 abgeschlossene Aufträge, sobald sie mindestens 30 Tage alt sind, auch ohne fällige Zustellungen. job_queue.retention_days akzeptiert 1–3650 oder null zum Deaktivieren. Ausstehende, laufende und fehlgeschlagene Aufträge werden nie automatisch gelöscht. Prüfe fehlgeschlagene Aufträge vor Wiederholung oder Bereinigung; ausdrückliches prune 30 entfernt auch endgültig fehlgeschlagene Aufträge nach der Aufbewahrungsfrist. Die Bereinigung entfernt Nutzdaten und Deduplizierungsverlauf; verwalte Backup-Aufbewahrung separat. Plane den Worker weiter ein und verwende konsistente SQLite-Backups für WAL-Datenbanken.

'job_queue' => [
    'stale_after_seconds' => 900,
    'retention_days' => 30, // 1–3650; null deaktiviert automatische Bereinigung.
],
Anleitung zu Warteschlange und Überwachung
OPTIONALE FUNKTIONEN

Einfache Statistik, ohne Besuchertracking.

spine-analytics ist ein optionales Plugin unter core/plugins/spine-analytics. Es zählt zusammengefasste Anfragen und Seitenaufrufe ohne Browser-Skripte, Cookies, Besucher-IDs oder gespeicherte IP-Adressen. Die Zahlen stehen für Anfragen, nicht für eindeutige Besucher. Erfassung und Browser-Bericht sind standardmäßig deaktiviert.

Füge spine-analytics deiner bestehenden Plugin-Liste hinzu und ergänze die Einstellungen unten. Erlaube nur feste öffentliche Pfade, aktiviere die Erfassung bewusst und führe den Installer ausdrücklich aus. Das Plugin verwendet eine eigene SQLite-Datenbank unter storage/spine-analytics/counts.sqlite; normale Installation und Core-Updates legen die Statistik-Tabellen nicht an. Installiere nicht gleichzeitig ein Website-Plugin mit derselben ID.

// Append spine-analytics to the existing plugins list.
'spine_analytics' => [
    'enabled' => true,
    'preview' => false,
    'report_enabled' => false,
    'pages' => ['/', '/docs'],
],
php core/plugins/spine-analytics/cli.php install
php core/plugins/spine-analytics/cli.php report 30

Zusammengefasste Werte umfassen 90 UTC-Kalendertage und verfallen bei der nächsten gezählten Anfrage. Query-Strings und Fragmente werden verworfen; nicht freigegebene Pfade erscheinen gemeinsam als [other]. Optionale grobe Geräteinformationen stammen aus Anfrage-Headern, ohne Fingerprinting. Nur Anfragen an PHP zählen; Assets, /health und /_insights sind ausgeschlossen. Schütze Exporte und Backups separat.

Lass preview=false im Produktivbetrieb. Ein Browser-Bericht unter /_insights benötigt report_enabled=true, HTTPS und einen konfigurierten Passwort-Hash; folge der mitgelieferten Anleitung. CLI-Berichte und exportierte HTML-Dateien bleiben privat. Fehler bei der Erfassung ersetzen keine Website-Antwort.

Anleitung zu Installation und Datenschutz der Statistik
07 / ERHALTE DEINE ARBEIT

Core-Updates

Core-Releases enthalten ein genaues Dateiverzeichnis mit SHA-256-Prüfsummen, Version, PHP-Mindestversion und API-Kompatibilität. Updates prüfen das Archiv, bereiten es vor, prüfen Kompatibilität und Zustand und aktivieren es unter einer exklusiven Sperre. Fehlgeschlagene Zustandsprüfungen setzen geänderte Dateien zurück. Ein dauerhaftes Wiederherstellungsjournal blockiert Anfragen nach einer unterbrochenen Aktivierung bis zur Wiederherstellung.

php core/bin/console.php package
php core/bin/console.php update /path/to/core-release.zip
php core/bin/console.php rollback
php core/bin/console.php recover

Website-Dateien, Themes, eigene Plugins, Konfiguration und Daten bleiben erhalten. Mitgelieferte Provider in core/plugins/ werden mit dem Framework aktualisiert. Erstelle die Website einmal aus einem Bootstrap und verwende danach Core-Release-Archive für Framework-Updates. Das Überschreiben einer angepassten Website mit dem ursprünglichen Repository bietet diese Erhaltungsgarantie nicht. Core-Updates migrieren keine Datenbanken. Sichere die Website vor Updates separat. Beende laufende Produktionsanfragen und setze OPcache nach der Aktivierung zurück.

Prüfsummen erkennen beschädigte Dateien; sie bestätigen nicht die Herkunft eines Releases. Nutze nur lokale Archive aus vertrauenswürdigen Quellen. Signierte Online-Updates und separate Erweiterungs-Updates sind geplant.
08 / INS WEB

Veröffentlichung

Setze das öffentliche Stammverzeichnis von Apache oder nginx auf public/. Leite Anfragen an index.phpweiter; die enthaltene Apache-Konfiguration benötigt mod_rewrite und Override-Berechtigungen. Deaktiviere Verzeichnisauflistungen und sperre beliebige PHP-Dateien. In core/docs/deployment.md findest du kopierbare Apache-, nginx- und CloudPanel-Beispiele sowie Anleitungen für Tests mit echten Webservern.

Der PHP-Prozess braucht Lesezugriff auf Framework und Erweiterungen sowie Schreibzugriff auf storage/. Nur der Betreiber, der ein Update ausführt, braucht Schreibzugriff auf Framework-Dateien. Nutze HTTPS, sichere Daten und halte config/local.php außerhalb der Versionsverwaltung.

Für eine Bootstrap-ZIP-Datei mit Starttheme und Providern führe folgenden Befehl aus: php core/bin/console.php package --full. Ein normales Core-Release enthält nur verwaltete Framework-Dateien.

Veröffentliche unter der Domainwurzel und verwende PHP 8.3+ sowohl für CLI als auch für Webprozesse. Schließe in CloudPanel /assets/ mit ^(?!/assets/) aus der allgemeinen Static-Datei-Regel aus, damit Theme-Assets PHP erreichen; sie liegen außerhalb von public/. CORS- und HTTP/3-Header sind separate Hosting-Einstellungen. Prüfe Frontend- und Backend-Routing. Starte PHP-FPM oder die Apache-PHP-Prozesse nach einem Update neu, um deren OPcache zu leeren; ein opcache_reset() in der CLI leert den Cache der Webprozesse nicht.

Neue Starter-Websites beginnen mit indexable auf false in site/meta.php. Setze den Wert vor dem öffentlichen Start auf true und prüfe die ausgelieferten Robots-Anweisungen. Eigene Themes steuern ihr Indexierungsverhalten selbst. Der Core erzeugt robots.txt, Sitemap oder kanonische URLs nicht automatisch.

09 / DIE BASICS RICHTIG MACHEN

Qualität und Sicherheit

Templates müssen nicht vertrauenswürdige Ausgaben maskieren; SQLite-Abfragen sind parametrisiert. Asset-Routen sind auf das ausgewählte Theme und erlaubte Dateitypen begrenzt. Der minimale Starter nutzt Systemschriften, ein gemeinsames Layout, wiederverwendbare Komponenten, sichtbaren Tastaturfokus, einen Sprunglink und responsive Layouts; er funktioniert ohne JavaScript. Barrierefreiheit und Interaktion eines eigenen Themes liegen in der Verantwortung der Website.

php core/tests/run.php
php site/tests/run.php

Framework-Tests verwenden unabhängige Fixtures; halte Website-Tests in site/tests/run.php und passe sie an deine Website an. Führe sitzungsbasierte Kontakttests in einem Unterprozess oder HTTP-Fixture aus, bevor ausgegebener Fortschritt Header stören kann. Geprüft werden typisierte Entity-Abfragen, Seitenrouten, Response-Header, Templates, Assets, Queue-Aufbewahrung, Archivintegrität und Rollback. Die optionale Docker-Hosting-Suite prüft Apache und nginx/PHP-FPM; siehe core/docs/deployment.md. WCAG 2.2 AA ist das Ziel; eine vollständige Prüfung mit assistiven Technologien steht noch aus.

Schreibende Endpunkte müssen Validierung, CSRF- und Missbrauchsschutz selbst umsetzen. Privilegierte Aktionen benötigen zusätzlich Authentifizierung und Berechtigungsprüfungen. Der Starter enthält keinen Admin-Editor und keine Uploads; das optionale Kontaktformular-Beispiel erlaubt anonyme Anfragen ohne Bearbeitungsrechte.

Sicherheitsheader und externe Einbettungen.

Responses verwenden standardmäßig nosniff, strict-origin-when-cross-origin und eine Content Security Policy für Ressourcen derselben Herkunft; data:-Bilder sind erlaubt, Einbettung dieser Website durch andere Websites ist gesperrt. Eigene Response-Header überschreiben Standards unabhängig von Groß- und Kleinschreibung. Kopiere für eine externe Einbettung die vollständige Standard-CSP und erweitere nur die nötige Direktive dieser einen Response, etwa frame-src für eine vertrauenswürdige Herkunft. Eine eigene CSP ersetzt die gesamte Standardrichtlinie. Vermeide Wildcards, unsafe-inline und unsafe-eval; berücksichtige externe Besucheranfragen bei Datenschutz und Einwilligung. Response::DEFAULT_HEADERS und emittedHeaders() stellen Standardwerte und ausgelieferte Header für Tests bereit.

Beispiele für Sicherheitsheader und CSP lesen
10 / DER STAND VON WEBSPINE

Stand und Ausblick

Verfügbar

Routing und Responses mit ausdrücklichen Seitenpfaden und Slash-Weiterleitungen; Request-Kontext und ausdrücklich aktivierte POST-Routen; Plugin-Schnittstellen, Hooks und CLI-Befehle; SQLite-Einstellungen, Seiten, Entities-CRUD, typisierte Abfragen und ausdrückliche Indizes; Themes und verschachtelte Komponenten; versionierte Assets; SMTP mit optionalem Reply-To, aggregierte Analytics und eine dauerhafte Queue; ein kopierbares Kontaktformular mit Token-Wiederherstellung und konfigurierbaren Wiederholungen; private Queue-Überwachung und Aufbewahrung abgeschlossener Aufträge; rückgängig machbare Core-Updates und unabhängige Framework-Tests.

Geplant

MariaDB- und PostgreSQL-Adapter sowie Datenübertragung; separate Erweiterungs-Updates; signierte Online-Updates; Admin- und Inhaltsbearbeitung; Authentifizierung; ein allgemeiner Formularbaukasten und Uploads.