feat: initial commit of camelia/orm

Attribute-mapped Active Record ORM for MariaDB/MySQL over PDO.

- Attribute-driven metadata: TableName, PrimaryKey, AutoIncrement, Column,
  Guarded, Ignore, Required, Enum, Nullable, Length, Precision, Unique,
  UniqueGroup, Index, MaxLength.
- Relationship mapping: BelongsTo, HasOne, HasMany, BelongsToMany with
  batched eager loading and a 3-level depth limit.
- Orm entry point with fromArray, fromPdo, fromEnv and nested transactions.
- Immutable Query with Cond operators and GroupCond grouping.
- Repository read and write API, pagination, and typed exception hierarchy.
- Declares PHP >=8.3; Mago and PHPStan pin the parser to 8.3.
- MIT license.
This commit is contained in:
dgarcia committed 2026-11-15 10:14:22 -03:00
commit 66e93e3070
97 files changed
+12188

No files matched your search

+29
View File
@@ -0,0 +1,29 @@
<?php
declare(strict_types=1);
namespace Camelia\Orm\Tests\Fixture;
use Camelia\Orm\Attribute\AutoIncrement;
use Camelia\Orm\Attribute\BelongsToMany;
use Camelia\Orm\Attribute\PrimaryKey;
use Camelia\Orm\Attribute\TableName;
use Camelia\Orm\Model;
#[TableName('articulos')]
final class Articulo extends Model
{
#[PrimaryKey, AutoIncrement]
public ?int $codigo = null;
public string $nombre = '';
/** @var array<int, Etiqueta> */
#[BelongsToMany(
related: Etiqueta::class,
through: 'articulo_etiqueta',
foreignPivotKey: 'articulo_codigo',
relatedPivotKey: 'etiqueta_codigo',
)]
public array $etiquetas = [];
}
+31
View File
@@ -0,0 +1,31 @@
<?php
declare(strict_types=1);
namespace Camelia\Orm\Tests\Fixture;
use Camelia\Orm\Attribute\AutoIncrement;
use Camelia\Orm\Attribute\PrimaryKey;
use Camelia\Orm\Attribute\TableName;
use Camelia\Orm\Model;
#[TableName('con_hooks')]
final class ConHooks extends Model
{
#[PrimaryKey, AutoIncrement]
public ?int $codigo = null;
public string $nombre = '';
public string $creadoPorHook = '';
protected function beforeInsert(): void
{
$this->creadoPorHook = 'insert';
}
protected function beforeUpdate(): void
{
$this->creadoPorHook = 'update';
}
}
+21
View File
@@ -0,0 +1,21 @@
<?php
declare(strict_types=1);
namespace Camelia\Orm\Tests\Fixture;
use Camelia\Orm\Attribute\AutoIncrement;
use Camelia\Orm\Attribute\PrimaryKey;
use Camelia\Orm\Attribute\TableName;
use Camelia\Orm\Model;
#[TableName('detalles')]
final class Detalle extends Model
{
#[PrimaryKey, AutoIncrement]
public ?int $codigo = null;
public int $facturaCodigo = 0;
public string $concepto = '';
}
+34
View File
@@ -0,0 +1,34 @@
<?php
declare(strict_types=1);
namespace Camelia\Orm\Tests\Fixture;
use Camelia\Orm\Attribute\AutoIncrement;
use Camelia\Orm\Attribute\BelongsToMany;
use Camelia\Orm\Attribute\PrimaryKey;
use Camelia\Orm\Attribute\TableName;
use Camelia\Orm\Model;
/**
* Chain fixture used to prove nested eager loading:
* Articulo -> Etiqueta -> Factura -> Usuario.
*/
#[TableName('etiquetas')]
final class Etiqueta extends Model
{
#[PrimaryKey]
#[AutoIncrement]
public ?int $codigo = null;
public string $nombre = '';
/** @var array<int, Factura> */
#[BelongsToMany(
related: Factura::class,
through: 'etiqueta_factura',
foreignPivotKey: 'etiqueta_codigo',
relatedPivotKey: 'factura_codigo',
)]
public array $facturas = [];
}
+32
View File
@@ -0,0 +1,32 @@
<?php
declare(strict_types=1);
namespace Camelia\Orm\Tests\Fixture;
use Camelia\Orm\Attribute\AutoIncrement;
use Camelia\Orm\Attribute\BelongsTo;
use Camelia\Orm\Attribute\Column;
use Camelia\Orm\Attribute\HasMany;
use Camelia\Orm\Attribute\PrimaryKey;
use Camelia\Orm\Attribute\TableName;
use Camelia\Orm\Model;
#[TableName('facturas')]
final class Factura extends Model
{
#[PrimaryKey, AutoIncrement]
public ?int $codigo = null;
public int $usuarioCodigo = 0;
#[Column('importe_total')]
public float $total = 0.0;
#[BelongsTo(Usuario::class, foreignKey: 'usuarioCodigo')]
public ?Usuario $usuario = null;
/** @var array<int, Detalle> */
#[HasMany(Detalle::class, foreignKey: 'facturaCodigo')]
public array $detalles = [];
}
@@ -0,0 +1,22 @@
<?php
declare(strict_types=1);
namespace Camelia\Orm\Tests\Fixture\Invalid;
use Camelia\Orm\Attribute\Column;
use Camelia\Orm\Attribute\PrimaryKey;
use Camelia\Orm\Attribute\TableName;
use Camelia\Orm\Model;
#[TableName('columna_duplicada')]
final class ColumnaDuplicada extends Model
{
#[PrimaryKey]
public ?int $codigo = null;
public string $nombre = '';
#[Column('nombre')]
public string $nombreAlternativo = '';
}
+19
View File
@@ -0,0 +1,19 @@
<?php
declare(strict_types=1);
namespace Camelia\Orm\Tests\Fixture\Invalid;
use Camelia\Orm\Attribute\PrimaryKey;
use Camelia\Orm\Attribute\TableName;
use Camelia\Orm\Model;
#[TableName('dos_pk')]
final class DosPrimaryKeys extends Model
{
#[PrimaryKey]
public ?int $codigo = null;
#[PrimaryKey]
public ?int $otro = null;
}
@@ -0,0 +1,21 @@
<?php
declare(strict_types=1);
namespace Camelia\Orm\Tests\Fixture\Invalid;
use Camelia\Orm\Attribute\BelongsTo;
use Camelia\Orm\Attribute\PrimaryKey;
use Camelia\Orm\Attribute\TableName;
use Camelia\Orm\Model;
use Camelia\Orm\Tests\Fixture\Usuario;
#[TableName('relacion_no_nulable')]
final class RelacionNoNulable extends Model
{
#[PrimaryKey]
public ?int $codigo = null;
#[BelongsTo(Usuario::class, foreignKey: 'codigo')]
public Usuario $usuario;
}
+14
View File
@@ -0,0 +1,14 @@
<?php
declare(strict_types=1);
namespace Camelia\Orm\Tests\Fixture\Invalid;
use Camelia\Orm\Attribute\TableName;
use Camelia\Orm\Model;
#[TableName('sin_pk')]
final class SinPrimaryKey extends Model
{
public string $nombre = '';
}
+14
View File
@@ -0,0 +1,14 @@
<?php
declare(strict_types=1);
namespace Camelia\Orm\Tests\Fixture\Invalid;
use Camelia\Orm\Attribute\PrimaryKey;
use Camelia\Orm\Model;
final class SinTableName extends Model
{
#[PrimaryKey]
public ?int $codigo = null;
}
+18
View File
@@ -0,0 +1,18 @@
<?php
declare(strict_types=1);
namespace Camelia\Orm\Tests\Fixture\Invalid;
use Camelia\Orm\Attribute\PrimaryKey;
use Camelia\Orm\Attribute\TableName;
use Camelia\Orm\Model;
#[TableName('sin_tipo')]
final class SinTipo extends Model
{
#[PrimaryKey]
public ?int $codigo = null;
public $nombre;
}
+35
View File
@@ -0,0 +1,35 @@
<?php
declare(strict_types=1);
namespace Camelia\Orm\Tests\Fixture;
use Camelia\Orm\Attribute\AutoIncrement;
use Camelia\Orm\Attribute\Guarded;
use Camelia\Orm\Attribute\MaxLength;
use Camelia\Orm\Attribute\PrimaryKey;
use Camelia\Orm\Attribute\Required;
use Camelia\Orm\Attribute\TableName;
use Camelia\Orm\Model;
#[TableName('usuarios')]
final class Usuario extends Model
{
#[PrimaryKey, AutoIncrement]
public ?int $codigo = null;
public string $nombre = '';
public string $correo = '';
#[Guarded]
public string $passwordHash = '';
public bool $activo = true;
public ?string $apodo = null;
#[Required]
#[MaxLength(10)]
public string $clave = '';
}