Come installare xCRUD Nova Pro
Tutto ciò di cui un checkout appena scaricato ha bisogno prima che la prima pagina si carichi: un database, un file di configurazione e mod_rewrite.
Requisiti
xCRUD Nova Pro funziona su PHP 8.0+ e MySQL/MariaDB, dietro Apache con mod_rewrite abilitato (o un equivalente setup di riscrittura su nginx/IIS). Nessun pacchetto Composer, nessun passaggio di build Node - il PHP è semplice, e il widget lato client è un unico file JavaScript vanilla.
1. Importa il database
Il catalogo demo viene fornito come un unico dump SQL. Crea un nuovo database e importalo:
mysql -u root -e "CREATE DATABASE xcrud16 CHARACTER SET utf8mb4"
mysql -u root xcrud16 < sql/xcrud16.sql
Se stai usando il livello Pro (login, ruoli, admin), importa anche sql/xcrud_pro.sql nello stesso database - aggiunge le tabelle sys_*/user/logs necessarie alla schermata di login e alle pagine di amministrazione.
2. Configura src/Config.php
Punta XcrudConfig verso il tuo nuovo database:
public static string $dbHost = 'localhost';
public static string $dbName = 'xcrud16';
public static string $dbUser = 'root';
public static string $dbPass = '';
Già che ci sei, imposta $appSecret con una stringa lunga e casuale, univoca per la tua installazione - è la chiave HMAC che firma ogni condizione where()/subselect()/pass_var(), quindi conta anche in sviluppo locale. Consulta la Guida di riferimento a XcrudConfig per tutte le altre impostazioni.
3. Abilita mod_rewrite
Il file .htaccess del progetto trasforma un URL pulito come /payments in una chiamata a core/router.php, che lo risolve in pages/payments.php. Servono due cose nella configurazione di Apache:
mod_rewriteabilitato (in XAMPP è attivo per impostazione predefinita).AllowOverride Allimpostato per la tua document root, così.htaccessviene effettivamente letto.
4. Carica la tua prima pagina
Visita la tua installazione in un browser - se stai usando il catalogo demo incluso, parti dalla dashboard:
http://localhost/xcrud_8/app
Pronto a costruire la tua pagina invece di navigare tra le demo? Continua con la guida Avvio rapido - una schermata CRUD funzionante in tre righe di PHP.
Struttura del progetto
| Percorso | Cosa rappresenta |
|---|---|
src/Config.php | Credenziali del database, whitelist delle tabelle, selettore del framework UI |
src/Xcrud.php | La classe Xcrud - table()/route()/render()/page() e ogni opzione di campo/modulo |
core/ajax_crud.php | La REST API (GET/POST/PUT/DELETE), PDO con prepared statement |
core/xcrud.js | Il widget CRUD - elenco, aggiunta, modifica, eliminazione, tutto tramite fetch() |
themes/{ui}/ | Una cartella per ogni framework UI (none/tailwind/bootstrap) |
core/router.php | Mappa /payments su pages/payments.php |
pages/ | Un file per ogni rotta |
sql/xcrud16.sql | Il dump del database demo |