Начало работы

Обзор DevCraft Dev Tools, архитектура, требования и первые шаги

Пакет devcraftclub/dev-tools — библиотека PHP 8.3 с двумя взаимодополняющими возможностями:

Fluent mutation и accessors — #[With] / #[WithItem], #[Getter] / #[Setter] (lombok-php), AbstractWith.
DTO mapping — AbstractReflection, гидратация из массива, валидация атрибутами, toArray() / toJson().

Эти базовые классы рассчитаны на разные модели свойств и не предназначены для объединения через наследование.

Архитектура

Fluent API                              DTO Mapping
───────────                             ───────────
#[With] / #[WithItem]                   public typed properties
#[Getter] / #[Setter] (lombok-php)               │
        │                                        ▼
        ▼                                 AbstractReflection
 AbstractWith ──__call──► WithHandler            │
        │            (with* first)               ▼
        └──parent──► Lombok\Helper        ReflectionMapper
                     (get* / set* / is*)         │
                                                 ▼
                                          PropertyValidator
                                                 │
                            Filter / Range / Regex / ArrayOf

Разделы документации

Установка

Packagist и path repository

Атрибуты With

Fluent-билдеры и WithHandler

Getter и Setter

Accessors lombok-php на AbstractWith

Reflection mapper

Гидратация и сериализация DTO

Валидация

Filter, Range, Regex, ArrayOf

Справочник

Все классы и атрибуты пакета

История изменений

Changelog пакета

English

Full English documentation

Быстрый старт

use Lombok\Getter;
use Devcraft\Abstracts\AbstractWith;
use Devcraft\Attributes\With;
use Devcraft\Attributes\WithItem;

#[Getter]
final class Query extends AbstractWith
{
    #[With]
    private ?int $page = null;

    #[With, WithItem('string')]
    private array $tags = [];

    #[WithItem('string', ['string', 'null'])]
    private array $labels = [];
}

$query = (new Query())
    ->withPage(1)
    ->withTagsItem('proxy')
    ->withLabelsItem('status', 'ready');

$query->getPage();  // 1
$query->getTags();  // ['proxy']
$query->getLabels(); // ['status' => 'ready']

DTO mapping:

use Devcraft\Abstracts\AbstractReflection;
use Devcraft\Attributes\ArrayOf;
use Devcraft\Attributes\Range;
use Devcraft\Attributes\Regex;

final class Address extends AbstractReflection
{
    public string $city;
}

final class Proxy extends AbstractReflection
{
    #[Regex('/^[0-9a-f-]{36}$/i')]
    public string $id;

    #[Range(min: 1, max: 65535)]
    public int $port;

    public Address $address;

    #[ArrayOf(Address::class)]
    public array $locations = [];
}

$proxy = Proxy::fromArray([
    'id' => '550e8400-e29b-41d4-a716-446655440000',
    'port' => '8080',
    'address' => ['city' => 'Berlin'],
    'locations' => [
        ['city' => 'Berlin'],
        ['city' => 'Paris'],
    ],
]);

$proxy->port;              // int 8080 (string coerced)
$proxy->address->city;     // 'Berlin'
$proxy->toArray();         // nested arrays
echo $proxy->toJson();     // pretty-printed JSON

Выбор базового класса

Нужно	Наследовать	Стиль свойств
Fluent `with` / query objects, плюс `get` / `set*`	`AbstractWith`	Private (или protected), non-static, non-readonly
API response / request DTO	`AbstractReflection`	Public, typed, hydratable

Не комбинируйте их через inheritance. Если нужны оба формы — composition или два отдельных класса.

Требования

PHP 8.3 или новее
Composer
Транзитивная зависимость: marcin-orlowski/lombok-php ^1.2 (ставится вместе с пакетом)

Начало работы v1.0.1