Comment installer xCRUD Nova Pro
Tout ce dont une nouvelle installation a besoin avant le chargement de votre première page : une base de données, un fichier de configuration et mod_rewrite.
Prérequis
xCRUD Nova Pro fonctionne avec PHP 8.0+ et MySQL/MariaDB, derrière Apache avec mod_rewrite activé (ou une configuration de réécriture équivalente sur nginx/IIS). Aucun paquet Composer, aucune étape de build Node - le PHP est simple, et le widget côté client est un unique fichier JavaScript vanilla.
1. Importer la base de données
Le catalogue de démonstration est fourni sous la forme d'un unique dump SQL. Créez une nouvelle base de données et importez-le :
mysql -u root -e "CREATE DATABASE xcrud16 CHARACTER SET utf8mb4"
mysql -u root xcrud16 < sql/xcrud16.sql
Si vous utilisez le palier Pro (connexion, rôles, administration), importez également sql/xcrud_pro.sql dans la même base de données - il ajoute les tables sys_*/user/logs dont l'écran de connexion et les pages d'administration ont besoin.
2. Configurer src/Config.php
Faites pointer XcrudConfig vers votre nouvelle base de données :
public static string $dbHost = 'localhost';
public static string $dbName = 'xcrud16';
public static string $dbUser = 'root';
public static string $dbPass = '';
Pendant que vous y êtes, définissez $appSecret avec une longue chaîne aléatoire propre à votre installation - c'est la clé HMAC qui signe chaque condition where()/subselect()/pass_var(), ce qui compte même en développement local. Consultez la Référence XcrudConfig pour tous les autres réglages.
3. Activer mod_rewrite
Le fichier .htaccess propre au projet transforme une URL propre comme /payments en un appel à core/router.php, qui la résout en pages/payments.php. Cela nécessite deux choses dans la configuration d'Apache :
mod_rewriteactivé (XAMPP l'active par défaut).AllowOverride Alldéfini pour votre racine de documents, afin que.htaccesssoit effectivement lu.
4. Charger votre première page
Visitez votre installation dans un navigateur - si vous utilisez le catalogue de démonstration fourni, commencez par le tableau de bord :
http://localhost/xcrud_8/app
Prêt à créer votre propre page plutôt que de parcourir les démos ? Passez au guide Démarrage rapide - un écran CRUD fonctionnel en trois lignes de PHP.
Structure du projet
| Chemin | Ce que c'est |
|---|---|
src/Config.php | Identifiants de base de données, liste blanche des tables, sélecteur de framework UI |
src/Xcrud.php | La classe Xcrud - table()/route()/render()/page() et toutes les options de champs/formulaire |
core/ajax_crud.php | L'API REST (GET/POST/PUT/DELETE), PDO et requêtes préparées |
core/xcrud.js | Le widget CRUD - liste, ajout, édition, suppression, tout via fetch() |
themes/{ui}/ | Un dossier par framework UI (none/tailwind/bootstrap) |
core/router.php | Fait correspondre /payments à pages/payments.php |
pages/ | Un fichier par route |
sql/xcrud16.sql | Le dump de la base de données de démonstration |