Avvio rapido: migrazione, transazione e lettura

Il percorso più breve da «il plugin è installato» a «una migrazione è stata eseguita, una riga è stata scritta dentro una transazione e riletta» — senza una riga di codice proprio. Il plugin porta con sé una pagina dimostrativa che fa esattamente questo su un database usa e getta. Due passi, circa cinque minuti.

Prerequisiti

wkstorage e wkcore sono installati e attivati. wkcore qui è obbligatorio e non facoltativo: lo storage si registra tramite il suo registro.
PHP 8.2 o successivo con il driver PDO per SQLite.
La directory dei dati del wiki è scrivibile.
Potete modificare conf/local.php.

Passo 1: sbloccare la dimostrazione

La pagina è protetta dall'impostazione allowdebug di DokuWiki perché a ogni chiamata scrive e svuota. Senza quell'impostazione segnala soltanto wkstorage demo requires $conf['allowdebug'] = 1.

Impostare in conf/local.php:

$conf['allowdebug'] = 1;

Togliere di nuovo la riga dopo la verifica. La dimostrazione lavora esclusivamente sul database usa e getta demo e non tocca dati di dominio — ma quell'impostazione sblocca l'output diagnostico nell'intero wiki.

Passo 2: richiamare la dimostrazione

Aprire /doku.php?do=wkstorage_diag.

Verifica del risultato

La pagina dimostra quattro cose e ne mostra ogni volta l'esito:

Sezione	Che cosa dovreste vedere
Migrations	`dryRun_pending` nomina le versioni ancora da applicare — il giro di prova non cambia nulla. `applied_now` nomina quelle applicate, `backup` la copia di sicurezza fatta nell'occasione. `second_run` è vuoto: un secondo giro non ha più nulla da fare e non crea una seconda copia.
Prepared statements + transaction	Una tabella con due righe, `Alpha` e `Beta`. `Beta` è stata scritta dentro una transazione; il fatto che ci sia dimostra che la transazione è stata confermata.
Percorso	Il percorso del file risolto sotto `data/dwdo`. È la convenzione di archiviazione che mantiene l'installazione trasportabile per semplice copia.
Errore	Una query volutamente errata su una tabella inesistente, con il messaggio della `StorageException`. Nomina lo SQLSTATE e né l'SQL né un percorso — un messaggio di errore che si può consegnare a chi chiama.

Con ciò avete visto una volta l'intera superficie pubblica del plugin in funzione.

Passo successivo

wkcore — prelevare il servizio storage.sqlite dal proprio codice invece di costruire Storage da sé.
wkdostorage — l'archiviazione di dominio della suite DevOps al di sopra.
wkstorage (in tedesco) — la pagina del pacchetto: Storage, Db, Migrator e che cosa StorageException dice e che cosa no.