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

+161
View File
@@ -0,0 +1,161 @@
<?php
declare(strict_types=1);
namespace Camelia\Orm\Tests\Unit\Query;
use Camelia\Orm\Exception\CriteriaException;
use Camelia\Orm\Metadata\ClassMetadata;
use Camelia\Orm\Metadata\MetadataFactory;
use Camelia\Orm\Query\MySqlDialect;
use Camelia\Orm\Query\QueryBuilder;
use Camelia\Orm\Tests\Fixture\Factura;
use Camelia\Orm\Tests\Fixture\Usuario;
use PHPUnit\Framework\Attributes\Test;
use PHPUnit\Framework\TestCase;
final class QueryBuilderTest extends TestCase
{
private QueryBuilder $builder;
private ClassMetadata $usuarios;
protected function setUp(): void
{
$this->builder = new QueryBuilder(new MySqlDialect());
$this->usuarios = (new MetadataFactory())->forClass(Usuario::class);
}
#[Test]
public function it_selects_every_non_relation_column(): void
{
$compiled = $this->builder->select($this->usuarios, []);
self::assertSame(
'SELECT `codigo`, `nombre`, `correo`, `password_hash`, `activo`, `apodo`, `clave`'
. ' FROM `usuarios`',
$compiled['sql'],
);
self::assertSame([], $compiled['params']);
}
#[Test]
public function it_excludes_relations_from_the_select_list(): void
{
$metadata = (new MetadataFactory())->forClass(Factura::class);
$compiled = $this->builder->select($metadata, []);
self::assertStringNotContainsString('`usuario`', $compiled['sql']);
self::assertStringNotContainsString('`detalles`', $compiled['sql']);
}
#[Test]
public function it_adds_where_order_and_limit(): void
{
$compiled = $this->builder->select(
$this->usuarios,
['activo' => true],
[['nombre', 'ASC']],
10,
20,
);
self::assertSame(
'SELECT `codigo`, `nombre`, `correo`, `password_hash`, `activo`, `apodo`, `clave`'
. ' FROM `usuarios` WHERE `activo` = ?'
. ' ORDER BY `usuarios`.`nombre` ASC LIMIT 10 OFFSET 20',
$compiled['sql'],
);
self::assertSame([true], $compiled['params']);
}
#[Test]
public function it_rejects_an_invalid_order_direction(): void
{
$this->expectException(CriteriaException::class);
/** @phpstan-ignore-next-line intentionally invalid direction to prove runtime validation */
$this->builder->select($this->usuarios, [], [['nombre', 'SIDEWAYS']]);
}
#[Test]
public function it_restricts_selected_columns_when_asked(): void
{
$compiled = $this->builder->select(
$this->usuarios,
[],
[],
null,
null,
['codigo', 'nombre'],
);
self::assertStringContainsString('SELECT `codigo`, `nombre` FROM', $compiled['sql']);
}
#[Test]
public function it_compiles_count(): void
{
$compiled = $this->builder->count($this->usuarios, ['activo' => 1]);
self::assertSame(
'SELECT COUNT(*) AS aggregate FROM `usuarios` WHERE `activo` = ?',
$compiled['sql'],
);
self::assertSame([1], $compiled['params']);
}
#[Test]
public function it_compiles_aggregates(): void
{
$compiled = $this->builder->aggregate($this->usuarios, 'codigo', 'MAX', []);
self::assertSame('SELECT MAX(`codigo`) AS aggregate FROM `usuarios`', $compiled['sql']);
}
#[Test]
public function it_compiles_insert(): void
{
$compiled = $this->builder->insert($this->usuarios, ['nombre' => 'Ana', 'activo' => true]);
self::assertSame(
'INSERT INTO `usuarios` (`nombre`, `activo`) VALUES (?, ?)',
$compiled['sql'],
);
self::assertSame(['Ana', true], $compiled['params']);
}
#[Test]
public function it_compiles_update(): void
{
$compiled = $this->builder->update($this->usuarios, ['nombre' => 'Ana'], 7);
self::assertSame('UPDATE `usuarios` SET `nombre` = ? WHERE `codigo` = ?', $compiled['sql']);
self::assertSame(['Ana', 7], $compiled['params']);
}
#[Test]
public function it_compiles_delete(): void
{
$compiled = $this->builder->delete($this->usuarios, 7);
self::assertSame('DELETE FROM `usuarios` WHERE `codigo` = ?', $compiled['sql']);
self::assertSame([7], $compiled['params']);
}
#[Test]
public function it_refuses_an_empty_insert(): void
{
$this->expectException(CriteriaException::class);
$this->builder->insert($this->usuarios, []);
}
#[Test]
public function it_refuses_an_empty_update(): void
{
$this->expectException(CriteriaException::class);
$this->builder->update($this->usuarios, [], 1);
}
}