elavora / api-datatype-core

v1.0.0 2026-08-16 02:48 UTC

Requires

• php: >=8.3
• elavora/api-framework: ^1.0

Requires (Dev)

• phpstan/phpstan: ^2.2
• phpunit/phpunit: ^10.5 || ^11.0 || ^12.0

MIT

Published on Packagist.org on 2026-08-16 02:51 UTC

README

Base abstrata para criar DataTypes imutaveis com validacao, normalizacao e integracao aos contratos do framework Elavora.

Requisitos

• PHP 8.3 ou superior.
• Demais requisitos declarados em composer.json.

Instalacao

composer require elavora/api-datatype-core

Inicio rapido

use Elavora\Api\DataTypes\AbstractDataType;

final readonly class Codigo extends AbstractDataType
{
    public static function isValid(mixed $value): bool
    {
        return is_string($value) && trim($value) !== '';
    }

    protected static function normalize(mixed $value): string
    {
        return trim((string) $value);
    }
}

$valor = Codigo::from(' ABC ');
$normalizado = $valor->value();

$normalizado contem ABC. O resultado de normalize() deve ser string, int, bool, float ou null.

Documentacao

Consulte o guia de uso para detalhes do contrato e validacao local.