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.
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
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.
Umgebungsauswahl › New environment
New environment
- Host
- Mein Webserver
- Folder
- ~/meine-website
Claude arbeitet jetzt direkt auf deinem Server. Beschreibe deine Website und öffne dann deine Domain im Browser, um das Ergebnis anzusehen.
New session
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.
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.
New session
Ergänze eine Seite für meine neuesten Projekte. Sichere die Website vorher und sag mir danach, was du geändert hast.
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-SitzungenMit 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.
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.
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 lesenSchnellstart
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.
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.
public/ als einzigem öffentlichen Stammverzeichnis.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 insite/themes/, und Funktionen insite/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.
Projektstruktur
core/Framework, mitgelieferte Provider, Werkzeuge, Tests und Anleitungensite/Website-Identität, Seitendefinitionen, Routen und Installationsite/content/Bearbeitbare PHP-Inhaltsarrays; diese Website ergänzt englische/deutsche Kataloge über eine eigene Lokalisierungsite/themes/Templates, gemeinsame Layouts, eingegrenztes CSS und Browser-JavaScriptsite/plugins/Provider- und Funktionserweiterungen mit Manifestenconfig/Private Provider-Auswahl und Zugangsdatenstorage/SQLite, Update-Zwischenstände, Sicherungen und Sperrenpublic/Das einzige öffentliche Stammverzeichniscore/bin/Installation, Zustandsprüfungen, Paketerstellung und Updates.dist/Erzeugte Release-ZIPs und Prüfsummencore/tests/Integrationstests ohne zusätzliche Abhängigkeitencore/docs/Architektur, Veröffentlichung und Hinweise für MitwirkendeDer 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 lesenKonfiguration
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.
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-themeDas 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'],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 ansehenPlugin-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 --coreKontaktformulare, 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 KontaktformularsEine 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 30Seit 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.
],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 30Zusammengefasste 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 StatistikCore-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 recoverWebsite-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.
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.
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.phpFramework-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.
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 lesenStand und Ausblick
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.
MariaDB- und PostgreSQL-Adapter sowie Datenübertragung; separate Erweiterungs-Updates; signierte Online-Updates; Admin- und Inhaltsbearbeitung; Authentifizierung; ein allgemeiner Formularbaukasten und Uploads.