Avvio rapido: prima connessione, prima query

Il percorso più breve da «il plugin è installato» a «una connessione nominata regge e una query su di essa restituisce righe». Quattro passi, circa dieci minuti.

• wksqliteds e wkcore sono installati e attivati.
• Siete autenticati come superuser.
• Il driver PDO per il database desiderato è presente in PHP. Per SQLite basta pdo_sqlite.
• Un database. Per SQLite basta un percorso di file; il file non deve ancora esistere.

Amministrazione → Configurazione, sezione wksqliteds:

enable_dbadmin = 1

Dal 2026-08-25 il valore predefinito è 1 — l'area di norma è già presente, quindi questo passaggio è una verifica e non una configurazione. Se manca comunque, l'istanza l'ha disattivata: guardare in conf/local.protected.php, che viene caricato dopo conf/local.php e quindi vince. Una 1 nel solo local.php non dice nulla.

Già che ci siete, considerate dbadmin_readonly. Attivo, l'assistente sfoglia e interroga ma non scrive — uno stato stabile ragionevole per un'installazione in cui lo studio serve a guardare e non a cambiare.

Amministrazione → SQLite Data Studio, direttamente /doku.php?do=admin&page=wksqliteds. Area Connessioni.

Aggiungere una connessione. Riceve un nome — a esso si riferisce tutto da qui in poi; dopo questo passo nulla si rivolge a un database per percorso o host.

• SQLite: basta il percorso del file.
• Database su server (MSSQL, MySQL, PostgreSQL, ODBC): host, database, utente e password.

Inserire poi il nome in default_connection, perché chi chiama senza indicarne uno abbia una destinazione.

Scegliere Prova la connessione.

La prova distingue tre cause che altrimenti arrivano più tardi come un unico messaggio inutile: driver mancante, credenziali respinte, database irraggiungibile.

Proseguire solo quando la prova riesce.

Passare all'area Assistente query, scegliere in alto sotto Connessione la propria connessione e inserire una query — per un file SQLite nuovo, per esempio:

SELECT name, TYPE FROM sqlite_master ORDER BY name

Scegliere Esegui.

• La griglia dei risultati mostra le righe — per un file nuovo e vuoto quindi nessuna, ma le intestazioni di colonna name e type ci sono. È esattamente ciò che dimostra che la query è passata e che la connessione regge.
• Esplora oggetti, a sinistra, elenca gli oggetti della connessione.
• Sotto Cronologia delle query, nella barra di destra, l'esecuzione compare con ora e durata.
• Controprova del limite: eseguire un SELECT senza WHERE su una tabella grande. Ottenete le prime dbadmin_max_result_rows righe e l'avviso che il risultato è stato troncato. Per il lavoro reale con risultati grandi, sfogliare invece di alzare il limite.

• wkblog — il motore del blog gira sulle routine nominate di questo pacchetto.
• Routine (in tedesco) — conservare la query come coppia di file nominata (.sql più manifesto), con parametri nominati invece di valori inseriti. L'assistente offre a questo scopo Salva come routine.
• Permessi (in tedesco) — chi può interrogare, scrivere, progettare ed esportare.