README

The JOOservices DTO Library is a PHP 8.5+ library for constructor-based DTO hydration, mutable data objects, opt-in validation, serialization control, and DTO collection wrappers.

Package name: jooservices/dto

Latest stable release: v1.3.0

Install

composer require jooservices/dto

Quick example

use DateTimeImmutable;
use JOOservices\Dto\Attributes\MapFrom;
use JOOservices\Dto\Core\Dto;

final class UserDto extends Dto
{
    public function __construct(
        public readonly string $id,
        #[MapFrom('email_address')]
        public readonly string $email,
        public readonly DateTimeImmutable $createdAt,
    ) {}
}

$user = UserDto::from([
    'id' => 'u_123',
    'email_address' => 'john@example.com',
    'createdAt' => '2026-01-15T10:30:00+00:00',
]);

$payload = $user->toArray();

What is supported today

Dto and Data
hydration from arrays, JSON strings, and simple public-property objects
scalar, enum, and DateTimeInterface casting
nested single DTO hydration
class-level polymorphic DTO hydration with #[DiscriminatorMap]
typed array hydration from common PHPDoc annotations such as Type[], array<Type>, and list<Type>
fallback property defaults with #[DefaultFrom]
opt-in validation with attributes
serialization filtering and wrapping
lazy derived serialization through ComputesLazyProperties
property-level #[Pipeline] and request-wide Context::$globalPipeline during hydration
DataCollection and PaginatedCollection

Important current limitations

deprecated placeholder attributes Computed, Deprecated, and OptionalProperty are not runtime-active (use ComputesLazyProperties, app-level deprecation, and nullable/defaults instead)
Context::$transformerMode remains reserved and is not behavior-defining
CastWith / TransformWith options are constructor-spread arguments for the configured class, not free-form bags passed into cast() / transform()

Documentation

Start with:

Documentation Hub
Changelog
AI Skills Usage Guide
phpDocumentor config for future API reference generation: phpdoc.dist.xml
Installation
Quick Start
Risks, Legacy, and Gaps

AI Support

This repository includes an AI skill pack for agents working in Cursor, Claude Code, VS Code, JetBrains, and Antigravity.

Start with:

The canonical skill source lives in .github/skills/, with adapter layers for each supported AI environment.

Development

composer lint
composer lint:all
composer test
composer test:coverage
composer check
composer ci

Contributor workflow details live in:

Approved Git flow summary:

normal feature and fix work branches from develop and PRs back into develop
release preparation uses release/<version> from develop, then PRs into master
releases are tagged from master
master merges back into develop after release or hotfix completion

Community

GitHub Actions and Services

Current GitHub Actions coverage:

CI: security checks, linting, tests, 95% minimum statement coverage, coverage upload, and optional SonarQube Cloud analysis when SONAR_TOKEN is configured
Release: validate tags, create GitHub releases, trigger Packagist update
PR Labeler: apply labels to pull requests
Semantic PR Title: enforce pull request title format
OpenSSF Scorecard: publish scorecard results as SARIF
Secret Scanning: workflow file exists, but the gitleaks job is currently disabled

External services currently used by workflows:

Codecov for coverage upload in ci.yml
Packagist update webhook in release.yml
GitHub Releases and GitHub Discussions in release.yml
OpenSSF Scorecard in scorecard.yml
GitHub SARIF upload through CodeQL infrastructure in scorecard.yml

Important notes:

No workflow currently defines Docker-style services: containers such as MySQL, Redis, or PostgreSQL.
SonarQube Cloud analysis is present in ci.yml, but it only runs after tests pass and only when SONAR_TOKEN is available.

License

This project is licensed under the MIT License.

jooservices / dto

Maintainers

Package info

Statistics

Security