Brzi početak: migracija, transakcija i čitanje

Najkraći put od „dodatak je instaliran“ do „migracija je prošla, redak je zapisan unutar transakcije i ponovno pročitan“ — bez retka vlastitog koda. Dodatak donosi stranicu za prikaz koja upravo to radi nad bazom za jednokratnu uporabu. Dva koraka, otprilike pet minuta.

Preduvjeti

wkstorage i wkcore su instalirani i uključeni. wkcore je ovdje obvezan, a ne neobvezan: pohrana se prijavljuje preko njegova registra.
PHP 8.2 ili noviji s PDO upravljačkim programom za SQLite.
Direktorij za spremanje wikija je zapisiv.
Smijete uređivati conf/local.php.

Korak 1: otključajte prikaz

Stranica je zaključana iza DokuWiki postavke allowdebug jer pri svakom pozivu piše i prazni. Bez te postavke javlja samo wkstorage demo requires $conf['allowdebug'] = 1.

Postavite u conf/local.php:

$conf['allowdebug'] = 1;

Uklonite redak nakon provjere. Prikaz radi isključivo nad bazom za jednokratnu uporabu demo i ne dira poslovne podatke — no ta postavka otključava dijagnostički ispis u cijelom wikiju.

Korak 2: pozovite prikaz

Otvorite /doku.php?do=wkstorage_diag.

Provjera rezultata

Stranica prikazuje četiri stvari i za svaku ispisuje ishod:

Odjeljak	Što biste trebali vidjeti
Migrations	`dryRun_pending` imenuje još neprimijenjene inačice — probni prolaz ne mijenja ništa. `applied_now` imenuje primijenjene, `backup` sigurnosnu kopiju načinjenu pritom. `second_run` je prazan: drugi prolaz nema više što raditi i ne stvara drugu kopiju.
Prepared statements + transaction	Tablica s dva retka, `Alpha` i `Beta`. `Beta` je zapisana unutar transakcije; to što je ondje dokazuje da je transakcija potvrđena.
Putanja	Razriješena putanja datoteke ispod `data/dwdo`. To je dogovor o pohrani koji instalaciju drži prenosivom kopiranjem.
Pogreška	Namjerno neispravan upit nad nepostojećom tablicom, s porukom `StorageException`. Ona imenuje SQLSTATE i ni SQL ni putanju — poruka o pogrešci koja se smije predati pozivatelju.

Time ste jednom vidjeli cijelu javnu površinu dodatka u pogonu.

Sljedeći korak

wkcore — dohvatite uslugu storage.sqlite iz vlastitog koda umjesto da sami gradite Storage.
wkdostorage — poslovna pohrana DevOps paketa iznad toga.
wkstorage (njemački) — stranica paketa: Storage, Db, Migrator i što StorageException govori, a što ne.