Schnelleinstieg: Migration, Transaktion und Lesevorgang ausführen

Der kürzeste Weg von „Plugin ist installiert“ zu „eine Migration ist gelaufen, eine Zeile ist in einer Transaktion geschrieben und wieder gelesen“ — ohne eine Zeile eigenen Code. Das Plugin bringt eine Vorführseite mit, die genau das gegen eine Wegwerf-Datenbank tut. Zwei Schritte, etwa fünf Minuten.

Voraussetzungen

wkstorage und wkcore sind installiert und aktiviert. wkcore ist hier erforderlich, nicht optional: Der Speicher meldet sich über dessen Registry an.
PHP 8.2 oder neuer mit dem PDO-Treiber für SQLite.
Der Datenordner des Wikis ist beschreibbar.
Sie dürfen conf/local.php ändern.

Schritt 1: Die Vorführung freischalten

Die Seite ist hinter DokuWikis Einstellung allowdebug verriegelt, weil sie bei jedem Aufruf schreibt und leert. Ohne die Einstellung meldet sie nur wkstorage demo requires $conf['allowdebug'] = 1.

Setzen Sie in conf/local.php:

$conf['allowdebug'] = 1;

Nehmen Sie die Zeile nach der Prüfung wieder heraus. Die Vorführung arbeitet zwar ausschließlich gegen die Wegwerf-Datenbank demo und fasst keine Fachdaten an — die Einstellung schaltet aber im ganzen Wiki Diagnoseausgaben frei.

Schritt 2: Die Vorführung aufrufen

Öffnen Sie /doku.php?do=wkstorage_diag.

Ergebnis prüfen

Die Seite führt vier Dinge vor und zeigt jeweils das Ergebnis:

Abschnitt	Was Sie sehen sollten
Migrations	`dryRun_pending` nennt die noch offenen Fassungen — der Probelauf ändert nichts. `applied_now` nennt die angewandten, `backup` die dabei angelegte Sicherung. `second_run` ist leer: Ein zweiter Lauf hat nichts mehr zu tun und legt auch keine zweite Sicherung an.
Prepared statements + transaction	Eine Tabelle mit zwei Zeilen, `Alpha` und `Beta`. `Beta` wurde innerhalb einer Transaktion geschrieben; dass sie dasteht, belegt den Abschluss der Transaktion.
Pfad	Der aufgelöste Dateipfad unterhalb von `data/dwdo`. Das ist die Ablagekonvention, die die Installation kopierbar hält.
Fehler	Eine absichtlich fehlerhafte Abfrage gegen eine nicht vorhandene Tabelle, samt der Meldung der `StorageException`. Sie nennt den SQLSTATE und weder das SQL noch einen Pfad — eine Fehlermeldung, die man einer aufrufenden Stelle zumuten kann.

Damit haben Sie die vollständige öffentliche Oberfläche des Plugins einmal in Betrieb gesehen.

Nächster Schritt

wkstorage — Referenz: Storage, Db, Migrator und was StorageException sagt und was nicht.
wkcore — den Dienst storage.sqlite aus eigenem Code holen, statt Storage selbst zu bauen.
wkdostorage — die fachliche Ablage der DevOps-Suite darüber.