/

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_rewrite abilitato (in XAMPP è attivo per impostazione predefinita).
  • AllowOverride All impostato per la tua document root, così .htaccess viene 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

PercorsoCosa rappresenta
src/Config.phpCredenziali del database, whitelist delle tabelle, selettore del framework UI
src/Xcrud.phpLa classe Xcrud - table()/route()/render()/page() e ogni opzione di campo/modulo
core/ajax_crud.phpLa REST API (GET/POST/PUT/DELETE), PDO con prepared statement
core/xcrud.jsIl widget CRUD - elenco, aggiunta, modifica, eliminazione, tutto tramite fetch()
themes/{ui}/Una cartella per ogni framework UI (none/tailwind/bootstrap)
core/router.phpMappa /payments su pages/payments.php
pages/Un file per ogni rotta
sql/xcrud16.sqlIl dump del database demo