Cómo instalar xCRUD Nova Pro
Todo lo que necesita una instalación recién descargada antes de que cargue tu primera página: una base de datos, un archivo de configuración y mod_rewrite.
Requisitos
xCRUD Nova Pro funciona con PHP 8.0+ y MySQL/MariaDB, detrás de Apache con mod_rewrite activado (o una configuración de reescritura equivalente en nginx/IIS). No requiere paquetes de Composer ni un paso de compilación con Node: el PHP es plano y el widget del lado del cliente es un único archivo JavaScript vanilla.
1. Importar la base de datos
El catálogo de demostración se distribuye como un único volcado SQL. Crea una base de datos nueva e impórtalo:
mysql -u root -e "CREATE DATABASE xcrud16 CHARACTER SET utf8mb4"
mysql -u root xcrud16 < sql/xcrud16.sql
Si estás usando el nivel Pro (inicio de sesión, roles, administración), importa también sql/xcrud_pro.sql en la misma base de datos - añade las tablas sys_*/user/logs que necesitan la pantalla de inicio de sesión y las páginas de administración.
2. Configurar src/Config.php
Apunta XcrudConfig a tu nueva base de datos:
public static string $dbHost = 'localhost';
public static string $dbName = 'xcrud16';
public static string $dbUser = 'root';
public static string $dbPass = '';
Ya que estás ahí, configura $appSecret con una cadena aleatoria larga y única para tu instalación - es la clave HMAC que firma cada condición where()/subselect()/pass_var(), así que importa incluso en desarrollo local. Consulta la Referencia de XcrudConfig para conocer el resto de ajustes.
3. Activar mod_rewrite
El propio archivo .htaccess del proyecto convierte una URL limpia como /payments en una llamada a core/router.php, que la resuelve a pages/payments.php. Eso requiere dos cosas en la configuración de Apache:
mod_rewriteactivado (XAMPP lo tiene activado por defecto).AllowOverride Allestablecido para tu raíz de documentos, para que.htaccessse lea realmente.
4. Cargar tu primera página
Visita tu instalación en un navegador - si estás usando el catálogo de demostración incluido, empieza por el panel principal:
http://localhost/xcrud_8/app
¿Listo para construir tu propia página en lugar de explorar las demos? Continúa con la guía de Inicio rápido - una pantalla CRUD funcional en tres líneas de PHP.
Estructura del proyecto
| Ruta | Qué es |
|---|---|
src/Config.php | Credenciales de base de datos, lista blanca de tablas, selector de framework de interfaz |
src/Xcrud.php | La clase Xcrud - table()/route()/render()/page() y todas las opciones de campos/formularios |
core/ajax_crud.php | La API REST (GET/POST/PUT/DELETE), PDO con sentencias preparadas |
core/xcrud.js | El widget CRUD - listar, añadir, editar, eliminar, todo vía fetch() |
themes/{ui}/ | Una carpeta por framework de interfaz (none/tailwind/bootstrap) |
core/router.php | Asigna /payments a pages/payments.php |
pages/ | Un archivo por ruta |
sql/xcrud16.sql | El volcado de la base de datos de demostración |