/

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_rewrite activado (XAMPP lo tiene activado por defecto).
  • AllowOverride All establecido para tu raíz de documentos, para que .htaccess se 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

RutaQué es
src/Config.phpCredenciales de base de datos, lista blanca de tablas, selector de framework de interfaz
src/Xcrud.phpLa clase Xcrud - table()/route()/render()/page() y todas las opciones de campos/formularios
core/ajax_crud.phpLa API REST (GET/POST/PUT/DELETE), PDO con sentencias preparadas
core/xcrud.jsEl widget CRUD - listar, añadir, editar, eliminar, todo vía fetch()
themes/{ui}/Una carpeta por framework de interfaz (none/tailwind/bootstrap)
core/router.phpAsigna /payments a pages/payments.php
pages/Un archivo por ruta
sql/xcrud16.sqlEl volcado de la base de datos de demostración