Hitri začetek: migracija, transakcija in branje

Najkrajša pot od »vtičnik je nameščen« do »migracija je stekla, vrstica je zapisana znotraj transakcije in znova prebrana« – brez vrstice lastne kode. Vtičnik prinaša prikazno stran, ki prav to počne nad podatkovno zbirko za enkratno rabo. Dva koraka, približno pet minut.

Predpogoji

wkstorage in wkcore sta nameščena in vklopljena. wkcore je tu obvezen in ne izbiren: shramba se prijavi prek njegovega registra.
PHP 8.2 ali novejši z gonilnikom PDO za SQLite.
Podatkovni imenik wikija je zapisljiv.
Smete urejati conf/local.php.

Korak 1: odklenite prikaz

Stran je zaklenjena z DokuWikijevo nastavitvijo allowdebug, ker ob vsaki zahtevi piše in briše. Brez te nastavitve pokaže samo wkstorage demo requires $conf['allowdebug'] = 1.

Nastavite v conf/local.php:

$conf['allowdebug'] = 1;

Vrstico po preverbi spet odstranite. Prikaz dela izključno nad podatkovno zbirko za enkratno rabo demo in se poslovnih podatkov ne dotakne – ta nastavitev pa odklene diagnostični izpis v celotnem wikiju.

Korak 2: pokličite prikaz

Odprite /doku.php?do=wkstorage_diag.

Preverjanje rezultata

Stran prikaže štiri stvari in za vsako izpiše izid:

Razdelek	Kaj bi morali videti
Migrations	`dryRun_pending` poimenuje še neuveljavljene različice – poskusni tek ne spremeni ničesar. `applied_now` poimenuje uveljavljene, `backup` varnostno kopijo, narejeno ob tem. `second_run` je prazen: drugi tek nima več česa početi in ne ustvari druge kopije.
Prepared statements + transaction	Razpredelnica z dvema vrsticama, `Alpha` in `Beta`. `Beta` je bila zapisana znotraj transakcije; to, da je tam, dokazuje, da je bila transakcija potrjena.
Pot	Razrešena pot datoteke pod `data/dwdo`. To je dogovor o shranjevanju, ki namestitev ohranja prenosljivo s preprostim kopiranjem.
Napaka	Namerno napačna poizvedba nad neobstoječo razpredelnico, s sporočilom `StorageException`. Poimenuje SQLSTATE in niti SQL niti poti – sporočilo o napaki, ki se sme predati klicatelju.

S tem ste enkrat videli celotno javno površino vtičnika v obratovanju.

Naslednji korak

wkcore – prevzemite storitev storage.sqlite iz lastne kode, namesto da Storage gradite sami.
wkdostorage – poslovna shramba paketa DevOps nad tem.
wkstorage – stran paketa: Storage, Db, Migrator in kaj StorageException pove ter česa ne.