PHPackages                             dr2gsistemas/xpress-orm - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Database & ORM](/categories/database)
4. /
5. dr2gsistemas/xpress-orm

ActiveLibrary[Database & ORM](/categories/database)

dr2gsistemas/xpress-orm
=======================

ORM ligero para PHP 8.4 con atributos, relaciones y auto-migrate para MariaDB

v1.0.0(today)01↑2900%MITPHPPHP ^8.4

Since Apr 3Pushed todayCompare

[ Source](https://github.com/DR2GSistemas/xpress-orm)[ Packagist](https://packagist.org/packages/dr2gsistemas/xpress-orm)[ RSS](/packages/dr2gsistemas-xpress-orm/feed)WikiDiscussions master Synced today

READMEChangelogDependencies (2)Versions (4)Used By (0)

Xpress ORM - ORM Ligero para PHP 8.4
====================================

[](#xpress-orm---orm-ligero-para-php-84)

Xpress ORM es un mapper objeto-relacional ligero y rápido para PHP 8.4, diseñado con una sintaxis limpia usando atributos. Soporta MariaDB/MySQL con auto-migrate, relaciones completas y query builder integrado.

Características
---------------

[](#características)

- **Atributos PHP 8.4** - Definiciones de entidades declarativas y limpìas
- **Relaciones completas** - One-to-One, One-to-Many, Many-to-One, Many-to-Many
- **Auto-migrate** - Sincronización automática de schema de base de datos
- **Query Builder** - Constructor de queries encadenable con escape automático (OWASP)
- **Soft Deletes** - Soporte nativo para eliminación suave
- **Timestamps automáticos** - created\_at y updated\_at automáticos
- **Repositorios** - Patrón Repository con métodos personalizados
- **Transacciones** - Soporte completo para transacciones
- **Hydrator** - Conversión bidireccional entre entidades y arrays
- **Seguridad** - Prepared statements obligatorios contra SQL Injection

Requisitos
----------

[](#requisitos)

- PHP 8.4 o superior
- Extensión PDO instalada
- MariaDB 10.5+ o MySQL 8.0+ (compatible con PostgreSQL con driver pdo\_pgsql)

Instalación
-----------

[](#instalación)

```
composer require azul/xpress-orm
```

Configuración Rápida
--------------------

[](#configuración-rápida)

### 1. Conexión a la Base de Datos

[](#1-conexión-a-la-base-de-datos)

```
use Xpress\Orm\Connection\XConnection;

$connection = new XConnection([
    'driver' => 'pdo_mysql',
    'host' => 'localhost',
    'database' => 'mi_app',
    'username' => 'root',
    'password' => 'secret',
    'charset' => 'utf8mb4'
]);
```

### 2. Entity Manager

[](#2-entity-manager)

```
use Xpress\Orm\Entity\XEntityManager;

$em = new XEntityManager($connection);
```

### 3. Auto-migrate (crear/actualizar tablas)

[](#3-auto-migrate-crearactualizar-tablas)

```
use Xpress\Orm\Schema\XAutoMigrate;

$migrate = new XAutoMigrate($connection);
$migrate->updateSchema([User::class, Post::class, Category::class]);
```

Definición de Entidades
-----------------------

[](#definición-de-entidades)

### Entidad Básica con Atributos

[](#entidad-básica-con-atributos)

```