xCRUD Nova Pro installieren

Alles, was ein frischer Checkout vor dem ersten Seitenaufruf braucht: eine Datenbank, eine Konfigurationsdatei und mod_rewrite.

Voraussetzungen

xCRUD Nova Pro läuft auf PHP 8.0+ und MySQL/MariaDB, hinter Apache mit aktiviertem mod_rewrite (oder einem gleichwertigen Rewrite-Setup unter nginx/IIS). Keine Composer-Pakete, kein Node-Build-Schritt - das PHP ist pures PHP, und das clientseitige Widget ist eine einzige, reine JavaScript-Datei.

1. Datenbank importieren

Der Demo-Katalog wird als einzelner SQL-Dump ausgeliefert. Erstellen Sie eine neue Datenbank und importieren Sie ihn:

mysql -u root -e "CREATE DATABASE xcrud16 CHARACTER SET utf8mb4"
mysql -u root xcrud16 < sql/xcrud16.sql

Wenn Sie die Pro-Stufe nutzen (Login, Rollen, Admin), importieren Sie zusätzlich sql/xcrud_pro.sql in dieselbe Datenbank - es fügt die sys_*-/user-/logs-Tabellen hinzu, die der Login-Bildschirm und die Admin-Seiten benötigen.

2. src/Config.php konfigurieren

Verweisen Sie XcrudConfig auf Ihre neue Datenbank:

public static string $dbHost = 'localhost';
public static string $dbName = 'xcrud16';
public static string $dbUser = 'root';
public static string $dbPass = '';

Setzen Sie dabei gleich $appSecret auf eine lange, zufällige, für Ihre Installation einzigartige Zeichenfolge - sie ist der HMAC-Schlüssel, der jede where()-/subselect()-/pass_var()-Bedingung signiert, und ist deshalb auch in der lokalen Entwicklung schon wichtig. Alle weiteren Einstellungen finden Sie in der Konfigurationsreferenz.

3. mod_rewrite aktivieren

Die projekteigene .htaccess verwandelt eine saubere URL wie /payments in einen Aufruf von core/router.php, das sie zu pages/payments.php auflöst. Dafür sind zwei Dinge in der Apache-Konfiguration nötig:

mod_rewrite aktiviert (bei XAMPP standardmäßig eingeschaltet).
AllowOverride All für Ihr Document Root gesetzt, damit .htaccess überhaupt gelesen wird.

4. Erste Seite aufrufen

Öffnen Sie Ihre Installation im Browser - wenn Sie den mitgelieferten Demo-Katalog verwenden, starten Sie am Dashboard:

http://localhost/xcrud_8/app

Möchten Sie stattdessen direkt eine eigene Seite bauen, statt die Demos zu durchstöbern? Weiter geht's mit der Anleitung Schnellstart - ein funktionierender CRUD-Bildschirm in drei Zeilen PHP.

Projektstruktur

Pfad	Was es ist
`src/Config.php`	Datenbank-Zugangsdaten, Tabellen-Whitelist, UI-Framework-Umschalter
`src/Xcrud.php`	Die Klasse `Xcrud` - `table()`/`route()`/`render()`/`page()` sowie jede Feld-/Formular-Option
`core/ajax_crud.php`	Die REST-API (GET/POST/PUT/DELETE), PDO mit Prepared Statements
`core/xcrud.js`	Das CRUD-Widget - Liste, Hinzufügen, Bearbeiten, Löschen, alles über `fetch()`
`themes/{ui}/`	Ein Ordner pro UI-Framework (`none`/`tailwind`/`bootstrap`)
`core/router.php`	Bildet `/payments` auf `pages/payments.php` ab
`pages/`	Eine Datei pro Route
`sql/xcrud16.sql`	Der Demo-Datenbank-Dump