/

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_rewrite activé (XAMPP l'active par défaut).
  • AllowOverride All défini pour votre racine de documents, afin que .htaccess soit 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

CheminCe que c'est
src/Config.phpIdentifiants de base de données, liste blanche des tables, sélecteur de framework UI
src/Xcrud.phpLa classe Xcrud - table()/route()/render()/page() et toutes les options de champs/formulaire
core/ajax_crud.phpL'API REST (GET/POST/PUT/DELETE), PDO et requêtes préparées
core/xcrud.jsLe widget CRUD - liste, ajout, édition, suppression, tout via fetch()
themes/{ui}/Un dossier par framework UI (none/tailwind/bootstrap)
core/router.phpFait correspondre /payments à pages/payments.php
pages/Un fichier par route
sql/xcrud16.sqlLe dump de la base de données de démonstration