jooservices/dto

A PHP 8.5+ DTO and Data library with immutable DTOs and mutable Data objects

1.0.4 2026-04-15 10:03 UTC

Requires

• php: >=8.5

Requires (Dev)

• captainhook/captainhook: ^5.23
• captainhook/plugin-composer: ^5.3
• fakerphp/faker: ^1.24
• friendsofphp/php-cs-fixer: ^3.65
• laravel/pint: ^1.18
• phpmd/phpmd: ^2.15
• phpstan/phpstan: ^2.0
• phpstan/phpstan-phpunit: ^2.0
• phpstan/phpstan-strict-rules: ^2.0
• phpunit/phpunit: ^12.0 || ^13.0
• squizlabs/php_codesniffer: ^3.8 || ^4.0

MIT

• JOOservices

• data
• mapping
• dto
• hydration
• normalization
• casting
• data-transfer-object

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

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' => '[e-mail]',
    '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
• typed array hydration from common PHPDoc annotations such as Type[], array<Type>, and list<Type>
• opt-in validation with attributes
• serialization filtering and wrapping
• lazy derived serialization through ComputesLazyProperties
• DataCollection and PaginatedCollection

Important current limitations

• several declared attributes are still only partially wired into runtime behavior; DiscriminatorMap remains non-operational, and Pipeline support is limited to current property-level execution paths rather than a broader end-to-end pipeline system
• StrictType now affects input shape enforcement and implicit casting rules, but related pipeline and schema behavior remains narrower than the declared attribute surface

Documentation

Start with:

• Documentation Hub
• 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:

• AGENTS.md
• CLAUDE.md
• AI Skills Map
• AI Skills Usage Guide

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

Development

composer lint:all
composer test

Contributor workflow details live in:

• Setup
• Contributing
• CI/CD
• AI Skills

GitHub Actions and Services

Current GitHub Actions coverage:

• CI: security checks, linting, tests, 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.