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

+176
View File
@@ -0,0 +1,176 @@
<?php
declare(strict_types=1);
namespace Camelia\Orm\Tests\Unit;
use Camelia\Orm\Query\Cond;
use Camelia\Orm\Query\GroupCond;
use Camelia\Orm\Repository;
use Camelia\Orm\Tests\Fixture\Usuario;
use Camelia\Orm\Tests\Support\FakeConnection;
use PHPUnit\Framework\Attributes\Test;
use PHPUnit\Framework\TestCase;
final class QueryTest extends TestCase
{
private FakeConnection $connection;
protected function setUp(): void
{
$this->connection = new FakeConnection();
}
#[Test]
public function it_builds_a_select_with_where(): void
{
$sql = $this->repository(Usuario::class)->query()->where('activo', true)->toSql();
self::assertStringContainsString('WHERE (`activo` = ?)', $sql['sql']);
self::assertSame([true], $sql['params']);
}
#[Test]
public function it_is_immutable(): void
{
$base = $this->repository(Usuario::class)->query()->where('activo', true);
$derived = $base->where('nombre', 'Ana');
self::assertCount(1, $base->toSql()['params']);
self::assertCount(2, $derived->toSql()['params']);
}
#[Test]
public function it_places_where_before_order_and_limit(): void
{
$sql = $this->repository(Usuario::class)
->query()
->where('activo', true)
->orderByDesc('nombre')
->limit(5)
->toSql()['sql'];
self::assertStringContainsString('WHERE (`activo` = ?) ORDER BY', $sql);
self::assertStringContainsString('LIMIT 5', $sql);
}
#[Test]
public function it_builds_or_groups(): void
{
$sql = $this->repository(Usuario::class)
->query()
->whereGroup(static function (GroupCond $group): void {
$group->or('nombre', 'Ana');
$group->or('nombre', 'Bea');
})
->toSql();
self::assertStringContainsString('WHERE (`nombre` = ? OR `nombre` = ?)', $sql['sql']);
self::assertCount(2, $sql['params']);
}
#[Test]
public function it_combines_groups_with_and(): void
{
$sql = $this->repository(Usuario::class)
->query()
->where('activo', true)
->whereGroup(static function (GroupCond $group): void {
$group->or('nombre', 'Ana');
})
->toSql()['sql'];
self::assertStringContainsString('(`activo` = ?) AND', $sql);
}
#[Test]
public function it_supports_where_in_and_null_helpers(): void
{
$sql = $this->repository(Usuario::class)
->query()
->whereIn('codigo', [1, 2])
->whereNull('apodo')
->toSql();
self::assertStringContainsString('`codigo` IN (?, ?)', $sql['sql']);
self::assertStringContainsString('`apodo` IS NULL', $sql['sql']);
self::assertSame([1, 2], $sql['params']);
}
#[Test]
public function it_plucks_a_single_column(): void
{
$this->connection->rows = [['nombre' => 'Ana'], ['nombre' => 'Bea']];
$values = $this->repository(Usuario::class)->query()->pluck('nombre');
self::assertSame(['Ana', 'Bea'], $values);
self::assertStringContainsString(
'SELECT `nombre` FROM',
$this->connection->selected[0]['sql'],
);
}
#[Test]
public function it_counts(): void
{
$this->connection->scalars = [4];
self::assertSame(
4,
$this->repository(Usuario::class)->query()->where('activo', true)->count(),
);
}
#[Test]
public function it_returns_the_first_row_or_null(): void
{
$this->connection->rows = [];
self::assertNull($this->repository(Usuario::class)->query()->first());
}
#[Test]
public function it_fails_first_or_fail_when_empty(): void
{
$this->connection->rows = [];
$this->expectException(\Camelia\Orm\Exception\RecordNotFoundException::class);
$this->repository(Usuario::class)->query()->firstOrFail();
}
#[Test]
public function it_pages(): void
{
$this->connection->scalars = [0];
$this->connection->rows = [];
$page = $this->repository(Usuario::class)->query()->page(2, 5);
self::assertSame(2, $page->page);
self::assertSame(0, $page->total);
self::assertStringContainsString('LIMIT 5 OFFSET 5', $this->connection->selected[1]['sql']);
}
#[Test]
public function it_accepts_a_cond_in_where(): void
{
$sql = $this->repository(Usuario::class)
->query()
->where('codigo', Cond::between(1, 9))
->toSql();
self::assertStringContainsString('BETWEEN ? AND ?', $sql['sql']);
self::assertSame([1, 9], $sql['params']);
}
/**
* @param class-string<\Camelia\Orm\Model> $class
* @return Repository<\Camelia\Orm\Model>
*/
private function repository(string $class): Repository
{
return new Repository($this->connection, $class);
}
}