Documentos primero
Documentos sin esquema almacenados como archivos legibles, con índices y un formato empaquetado cuando las colecciones crecen.
PHP · embebida · base de datos documental
Una base de datos que
es una carpeta.
AxiDB es una base de datos documental embebida y basada en archivos para PHP. Cópiala en tu proyecto y empieza a guardar documentos. Sin servidor. Sin Composer. Sin dependencias de terceros. Una base de datos que puedes entender.
PHP 8.1+Pensada para PHP moderno.
0 dependenciesNo necesitas carpeta vendor.
Apache 2.0Licencia open source.
v0.8.0La API sigue evolucionando.
01 / Empezar
Una carpeta.
Un require.
AxiDB está pensada para proyectos donde instalar y mantener un servidor de base de datos resulta más pesado que el propio problema. Copia la carpeta en tu proyecto, indica un directorio de datos y utiliza la API.
// copy axidb/ into your project require 'axidb/core/axidb.php'; $db = axidb(__DIR__ . '/datos'); $db->insert('clientes', ['nombre' => 'Ana Ruiz', 'ciudad' => 'Murcia']); foreach ($db->find('clientes')->where('ciudad', '=', 'Murcia')->get() as $cliente) { echo $cliente['nombre']; }
02 / Qué hace
Lo bastante pequeña
para entenderla.
CRUD, consultas, índices, transacciones, copias de seguridad y más, manteniendo los datos cerca de la aplicación.
Consultas
where, orderBy, limit, offset, select y joins, además de AxiSQL para consultas más avanzadas.
Transacciones
Actualizaciones atómicas con recuperación tras interrupciones y bloqueo entre procesos.
Copias de seguridad
Copias completas e incrementales, restauración, JSON y CSV.
Búsqueda semántica
Búsqueda vectorial para recuperar información por significado, con un resultado medido de 45 ms sobre 10.000 documentos en el benchmark del proyecto.
Preparada para IA
Los agentes disponen de una vista controlada de la base de datos con permisos, trazabilidad y control de parada.
Tus datos siguen siendo visibles.
Una colección puede ser un directorio de documentos JSON que puedes abrir, inspeccionar y reparar manualmente. Las colecciones grandes pueden usar almacenamiento empaquetado.
Base de datos sin servidor.
No hay un servicio independiente que instalar o mantener activo. La autenticación, los roles, el acceso de red y TLS siguen siendo responsabilidad de la aplicación anfitriona.
03 / Seguridad
La seguridad forma parte
del motor.
El repositorio incluye pruebas de seguridad y documenta los límites del modelo embebido.
01
AES-256-GCM
Las colecciones pueden cifrarse en reposo, con protección HMAC para los nombres de los buckets de índices.
02
Escrituras atómicas
Las escrituras están diseñadas para sobrevivir a interrupciones, con recuperación y bloqueo entre procesos.
03
Controles contra inyección y traversal
AxiSQL mantiene los literales separados de la sintaxis y las rutas de datos están restringidas.
04
Límites conocidos
AxiDB es embebida, no un servidor. La autenticación, los roles, los controles de red y TLS corresponden a la aplicación anfitriona.
// project status version 0.8.0 php 8.1 · 8.2 · 8.3 · 8.4 platforms Linux · Windows tests > 3,000 checks security 560+ ataques rechazados license Apache 2.0
04 / Rendimiento
Rendimiento,
sin maquillaje.
El repositorio compara AxiDB con SQLite sobre 10.000 documentos. AxiDB no pretende superar a SQLite en velocidad bruta de escritura; su ventaja es la simplicidad y la instalación cero.
1.000 LECTURAS
44 ms · AxiDB fs
21 ms packed · 3 ms SQLiteINSERCIÓN MASIVA
375 ms · AxiDB packed
14,938 ms fs · 22 ms SQLiteMedido en un portátil Windows con SSD. Reproducible con php bench/comparativa.php.
05 / Inicio rápido
De una carpeta vacía
a un CRUD funcionando.
PHP 8.1+ con la extensión JSON incluida. No se necesitan dependencias de terceros.
INSTALACIÓN
Copia. Require. Usa.
Pensada para funcionar incluso en hosting compartido donde puede no haber línea de comandos ni servidor de base de datos.
Leer la guía de 5 minutos ↗01
Copy axidb/ into your project02
require 'axidb/core/axidb.php';03
$db = axidb(__DIR__ . '/datos');04
$db->insert('clientes', [...]);06 / Encaje
Sabe cuándo
usarla.
AxiDB deja claro dónde encaja y dónde otro motor es una mejor elección.
Websites · pequeñas tiendas · paneles internos · blogs · estado de agentes de IA
Útil cuando buscas almacenamiento documental, despliegue sencillo y una infraestructura operativa pequeña.
Datasets muy grandes · máximo rendimiento bruto · concurrencia de nivel servidor
AxiDB es embebida, no ofrece aislamiento MVCC, no está diseñada para decenas de millones de documentos y no afirma superar a SQLite.
07 / Más allá del CRUD
Un motor.
Más que almacenamiento.
Cuando un proyecto necesita más, AxiDB añade capacidades sin convertirse en una plataforma independiente.
SQL cuando lo necesitas.
JOIN, agregados, GROUP BY, funciones de fecha y texto, subconsultas, vistas y EXPLAIN.
Úsala desde el navegador.
Un puente HTTP con tokens y CORS permite acceder a la base de datos desde clientes web.
axi.js
Un cliente ES module sin dependencias ni empaquetador.
Busca por significado.
Búsqueda vectorial para aplicaciones que necesitan recuperación semántica.
Declara el propósito.
Perfiles como core, docs y ai permiten al motor hacer cumplir el modo de base de datos previsto.
Ve qué está ocurriendo.
Describe, consulta estadísticas y ejecuta revisiones de salud con avisos accionables.
08 / Preguntas
Antes de
instalarla.
Respuestas breves a las preguntas que los desarrolladores suelen hacer primero.
¿Qué es AxiDB?
AxiDB es una base de datos documental embebida y basada en archivos para PHP. Mantiene los datos cerca de la aplicación sin necesitar un servidor de base de datos independiente.
¿AxiDB necesita MySQL o PostgreSQL?
No. AxiDB está diseñada para ejecutarse dentro de la aplicación PHP, por lo que no se necesita un servidor de base de datos independiente.
¿AxiDB necesita Composer?
No. AxiDB está diseñada para funcionar sin Composer y sin dependencias de terceros.
¿AxiDB permite búsqueda vectorial?
Sí. AxiDB incluye capacidades de búsqueda vectorial para aplicaciones que necesitan recuperación semántica.
¿AxiDB es open source?
Sí. El código fuente está disponible en GitHub y el proyecto se publica bajo la licencia Apache 2.0.
¿Cuándo debería usar AxiDB?
Úsala cuando el almacenamiento documental embebido, el despliegue sencillo y una infraestructura operativa pequeña importen más que el máximo rendimiento de un servidor de base de datos o el almacenamiento a gran escala.
OPEN SOURCE · PHP · APACHE 2.0
Una base de datos que puedes copiar, inspeccionar y controlar.
AxiDB está construida por GestasAI para desarrolladores que quieren la base de datos cerca de su aplicación, sin infraestructura innecesaria.