Il Punkode Framework è la base tecnica comune che alimenta progetti come Diventi, D20, plugin WordPress come PK Inexpress, e qualsiasi applicazione web o desktop sviluppata sotto il brand Punkode.
Questo documento ti guida nella configurazione iniziale, così puoi creare un progetto funzionante in pochi minuti.
1. Posiziona la cartella Punkode nel tuo progetto #
Struttura consigliata:
project/
public/
index.php
punkode/
setup.php
anarkore/
nff/
2. Carica il bootstrap #
Nel tuo public/index.php:
require __DIR__ . '/../punkode/setup.php';
Questo è sufficiente per attivare tutto il framework.
Configurazione iniziale #
Apri il file:
punkode/anarkore/anarkore-setup.php
Modifica i parametri principali:
public string $db = "nome_database";
public string $host = "127.0.0.1:3306";
public string $user = "root";
public string $password = "";
Imposta anche la base URL:
public string $url_dir_main = "http://localhost/progetto/";
Da qui in poi:
DB_PKsa come connettersi- le tabelle possono essere generate
- i form iniziano a funzionare
- NFF sa dove salvare i file
Primo esempio funzionante #
Ecco un esempio semplicissimo per verificare che tutto funzioni:leggere dati da una tabella e mostrarli in una tabella HTML generata da Anarkore.
Esempio #
// Connessione tramite DB_PK (eredita i parametri dal setup)
$db = new DB_PK();
// Query
$rows = $db->pk_select("SELECT * FROM utenti");
// Creazione tabella HTML
$table = new TABLE_PK($rows);
echo $table->render();
Se vedi una tabella HTML generata automaticamente, allora Punkode è correttamente attivo.
Prossimi passi #
- Approfondire il modulo Anarkore (form, input, CRUD)
- Usare l’engine NFF per upload e resize immagini
- Integrare Punkode in progetti WordPress tramite gli adapter
- Creare pannelli admin personalizzati con template Bootstrap
Vedi anche: #
- Setup e Bootstrap
- Anarkore – DB e Form
- NFF – Upload e Immagini
- Esempi pratici
Cos’è Punkode Framework #
Punkode è composto da tre blocchi principali:
1. PUNKODE Boot (setup generale) #
Il file setup.php inizializza l’ambiente:
- Carica variabili da
.env - Riconosce se stai avviando una web app o una desktop app
- Definisce percorsi e URL
- Avvia automaticamente Anarkore e NoFutureFrame
È il punto di ingresso dell’intero framework.
2. Anarkore (DB + Form + Tabelle) #
Modulo pensato per creare rapidamente:
- connessioni database (via PDO)
- backend CRUD
- form HTML (anche complessi)
- tabelle amministrative in stile Bootstrap
Include classi come:
DB_PKFORM_PKTABLE_PKINPUT_PK
Perfetto per applicazioni interne, gestionali e pannelli admin.
3. NFF – NoFutureFrame (Upload, File, Resize) #
Motore comune per:
- gestire gli upload
- normalizzare
$_FILES - generare file sicuri (
PUNK_FileAsset) - ridimensionare immagini
- salvare file in ambienti diversi (WordPress, PHP/Laravel)
Gli adapter permettono al tuo codice di funzionare:
- su WordPress
- su PHP standalone
- su Laravel-style
senza cambiarlo.
