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:
commit
66e93e3070
97 files changed
+12188
No files matched your search
@@ -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 = [];
|
||||
}
|
||||
@@ -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';
|
||||
}
|
||||
}
|
||||
@@ -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 = '';
|
||||
}
|
||||
@@ -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 = [];
|
||||
}
|
||||
@@ -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 = '';
|
||||
}
|
||||
@@ -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;
|
||||
}
|
||||
@@ -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 = '';
|
||||
}
|
||||
@@ -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;
|
||||
}
|
||||
@@ -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;
|
||||
}
|
||||
@@ -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 = '';
|
||||
}
|
||||
Reference in new issue
Block a user