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.
178 lines
5.1 KiB
PHP
178 lines
5.1 KiB
PHP
<?php
|
|
|
|
declare(strict_types=1);
|
|
|
|
namespace Camelia\Orm\Tests\Unit;
|
|
|
|
use Camelia\Orm\Exception\PartialModelException;
|
|
use Camelia\Orm\Exception\ValidationException;
|
|
use Camelia\Orm\Persistence\AuditListener;
|
|
use Camelia\Orm\Persistence\Persister;
|
|
use Camelia\Orm\Query\MySqlDialect;
|
|
use Camelia\Orm\Query\QueryBuilder;
|
|
use Camelia\Orm\Tests\Fixture\Usuario;
|
|
use Camelia\Orm\Tests\Support\FakeConnection;
|
|
use PHPUnit\Framework\Attributes\Test;
|
|
use PHPUnit\Framework\TestCase;
|
|
|
|
final class PersisterTest extends TestCase
|
|
{
|
|
private FakeConnection $connection;
|
|
|
|
private Persister $persister;
|
|
|
|
protected function setUp(): void
|
|
{
|
|
$this->connection = new FakeConnection();
|
|
$this->persister = new Persister($this->connection, new QueryBuilder(new MySqlDialect()));
|
|
}
|
|
|
|
#[Test]
|
|
public function it_inserts_and_assigns_the_generated_key(): void
|
|
{
|
|
$this->connection->lastInsertId = '42';
|
|
$usuario = (new Usuario())->hydrate(['nombre' => 'Ana', 'clave' => 'abc']);
|
|
|
|
$key = $this->persister->insert($usuario);
|
|
|
|
self::assertSame(42, $key);
|
|
self::assertSame(42, $usuario->codigo);
|
|
self::assertStringStartsWith('INSERT INTO `usuarios`', $this->connection->lastSql());
|
|
}
|
|
|
|
#[Test]
|
|
public function it_only_writes_writable_columns(): void
|
|
{
|
|
$this->connection->lastInsertId = '1';
|
|
$usuario = (new Usuario())->hydrate(['nombre' => 'Ana', 'clave' => 'abc']);
|
|
|
|
$this->persister->insert($usuario);
|
|
|
|
$sql = $this->connection->lastSql();
|
|
|
|
self::assertStringNotContainsString('`codigo`', $sql);
|
|
self::assertStringContainsString('`password_hash`', $sql);
|
|
}
|
|
|
|
#[Test]
|
|
public function it_saves_as_update_when_the_key_is_present(): void
|
|
{
|
|
$usuario = (new Usuario())->hydrate(['nombre' => 'Ana', 'clave' => 'abc']);
|
|
$usuario->codigo = 9;
|
|
|
|
$this->persister->save($usuario);
|
|
|
|
self::assertStringStartsWith('UPDATE `usuarios`', $this->connection->lastSql());
|
|
}
|
|
|
|
#[Test]
|
|
public function it_saves_as_insert_when_the_key_is_absent(): void
|
|
{
|
|
$this->connection->lastInsertId = '3';
|
|
$usuario = (new Usuario())->hydrate(['nombre' => 'Ana', 'clave' => 'abc']);
|
|
|
|
$this->persister->save($usuario);
|
|
|
|
self::assertStringStartsWith('INSERT INTO `usuarios`', $this->connection->lastSql());
|
|
}
|
|
|
|
#[Test]
|
|
public function it_refuses_an_invalid_model(): void
|
|
{
|
|
$this->expectException(ValidationException::class);
|
|
|
|
$this->persister->insert((new Usuario())->hydrate(['nombre' => 'Ana']));
|
|
}
|
|
|
|
#[Test]
|
|
public function it_refuses_to_write_a_partial_model(): void
|
|
{
|
|
$usuario = (new Usuario())->hydrate(['nombre' => 'Ana', 'clave' => 'abc']);
|
|
$usuario->codigo = 1;
|
|
$usuario->markPartial();
|
|
|
|
$this->expectException(PartialModelException::class);
|
|
|
|
$this->persister->update($usuario);
|
|
}
|
|
|
|
#[Test]
|
|
public function it_patches_only_the_given_columns(): void
|
|
{
|
|
$this->persister->patch(new Usuario(), 5, ['nombre' => 'Bea']);
|
|
|
|
self::assertSame(
|
|
'UPDATE `usuarios` SET `nombre` = ? WHERE `codigo` = ?',
|
|
$this->connection->lastSql(),
|
|
);
|
|
}
|
|
|
|
#[Test]
|
|
public function it_removes_by_primary_key(): void
|
|
{
|
|
$removed = $this->persister->remove(new Usuario(), 5);
|
|
|
|
self::assertTrue($removed);
|
|
self::assertSame('DELETE FROM `usuarios` WHERE `codigo` = ?', $this->connection->lastSql());
|
|
}
|
|
|
|
#[Test]
|
|
public function it_returns_false_when_nothing_was_removed(): void
|
|
{
|
|
$this->connection->affected = 0;
|
|
|
|
self::assertFalse($this->persister->remove(new Usuario(), 5));
|
|
}
|
|
|
|
#[Test]
|
|
public function it_notifies_the_audit_listener(): void
|
|
{
|
|
$listener = new class() implements AuditListener {
|
|
/** @var list<array{action: string, pk: int|string}> */
|
|
public array $calls = [];
|
|
|
|
public function onWrite(
|
|
string $table,
|
|
int|string $pk,
|
|
string $action,
|
|
?array $before,
|
|
array $after,
|
|
): void {
|
|
$this->calls[] = ['action' => $action, 'pk' => $pk];
|
|
}
|
|
};
|
|
|
|
$this->connection->lastInsertId = '7';
|
|
$persister = new Persister(
|
|
$this->connection,
|
|
new QueryBuilder(new MySqlDialect()),
|
|
$listener,
|
|
);
|
|
|
|
$persister->insert((new Usuario())->hydrate(['nombre' => 'Ana', 'clave' => 'abc']));
|
|
|
|
self::assertSame([['action' => 'insert', 'pk' => 7]], $listener->calls);
|
|
}
|
|
|
|
#[Test]
|
|
public function it_invokes_the_before_insert_hook(): void
|
|
{
|
|
$model = new \Camelia\Orm\Tests\Fixture\ConHooks();
|
|
|
|
$this->persister->insert($model);
|
|
|
|
self::assertSame('insert', $model->creadoPorHook);
|
|
}
|
|
|
|
#[Test]
|
|
public function it_invokes_the_before_update_hook(): void
|
|
{
|
|
$model = new \Camelia\Orm\Tests\Fixture\ConHooks();
|
|
$model->codigo = 3;
|
|
|
|
$this->persister->update($model);
|
|
|
|
self::assertSame('update', $model->creadoPorHook);
|
|
}
|
|
}
|