README

ORM puro en PHP para Sybase ASE, independiente de framework. Soporta mapeo de entidades con atributos PHP 8.1, consultas OQL, QueryBuilder, relaciones, herencia, caché de dos niveles, migraciones y más.

Requisitos del sistema

• PHP 8.1 o superior
• Extensión ext-pdo_dblib
• Servidor Sybase ASE

Instalación

composer require shedeza/sybase-orm

Configuración rápida

Configuración por array

use SybaseORM\ORM\OrmFactory;

$em = OrmFactory::create([
    'connection' => [
        'host'     => '192.168.1.100',
        'port'     => 5000,
        'dbname'   => 'mi_base',
        'username' => 'sa',
        'password' => 'secret',
        'charset'  => 'UTF-8',
    ],
    'entity_directories' => [__DIR__ . '/src/Entity'],
]);

Configuración por URL DSN

use SybaseORM\ORM\OrmFactory;

$em = OrmFactory::createFromUrl(
    'sybase://sa:secret@192.168.1.100:5000/mi_base?charset=UTF-8',
    entityDirectories: [__DIR__ . '/src/Entity'],
);

Los caracteres especiales en la contraseña deben codificarse con URL encoding (por ejemplo, p@ss → p%40ss).

Uso básico

Persistir una entidad

$usuario = new Usuario();
$usuario->nombre = 'Juan';
$usuario->email = 'juan@example.com';

$em->persist($usuario);
$em->flush();

Buscar por ID

$usuario = $em->find(Usuario::class, 1);

Consultar con OQL

$usuarios = $em->query(
    'SELECT u FROM Usuario u WHERE u.activo = :activo',
    ['activo' => true]
);

Eliminar una entidad

$em->remove($usuario);
$em->flush();

Mapeo de entidades

use SybaseORM\Attribute\Entity;
use SybaseORM\Attribute\Id;
use SybaseORM\Attribute\Column;
use SybaseORM\Attribute\GeneratedValue;

#[Entity(table: 'usuarios')]
class Usuario
{
    #[Id]
    #[GeneratedValue]
    #[Column(type: 'integer')]
    public ?int $id = null;

    #[Column(type: 'string', length: 100)]
    public string $nombre = '';

    #[Column(type: 'string', length: 255, nullable: true)]
    public ?string $email = null;

    #[Column(type: 'datetime')]
    public ?\DateTimeInterface $creadoEn = null;
}

Atributos PHP disponibles

Relaciones

El ORM soporta relaciones #[ManyToOne], #[OneToMany], #[OneToOne] y #[ManyToMany] con lazy loading automático mediante proxies y eager loading vía QueryBuilder::with().

Para documentación detallada de relaciones, consulte el manual de relaciones.

Conexiones múltiples

Use EntityManagerRegistry para gestionar conexiones a múltiples bases de datos:

use SybaseORM\ORM\OrmFactory;
use SybaseORM\ORM\EntityManagerRegistry;

$emDefault = OrmFactory::create(['connection' => $configDefault, 'entity_directories' => $dirs]);
$emReportes = OrmFactory::create(['connection' => $configReportes, 'entity_directories' => $dirs]);

$registry = new EntityManagerRegistry([
    'default'  => $emDefault,
    'reportes' => $emReportes,
], defaultConnection: 'default');

// Obtener un manager específico
$em = $registry->getManager('reportes');

// Obtener el manager por defecto
$em = $registry->getDefaultManager();

// Obtener el manager que gestiona una entidad (por su atributo connection)
$em = $registry->getManagerForEntity(Reporte::class);

Opciones de configuración

Documentación completa

• Documentación completa — Punto de entrada central a toda la documentación
• Manual de usuario — Guía detallada de cada módulo del ORM
• Manual de operación — Despliegue, optimización y troubleshooting
• Manual técnico — Arquitectura interna, patrones y extensibilidad

Licencia

Este proyecto está licenciado bajo la Licencia MIT.