Devcraft Dev Tools

Reusable PHP 8.3 attributes and runtime helpers.

See the documentation for the full guide.

Local installation

Add a Composer path repository in the consuming project and require the package:

{
    "repositories": [
        {
            "type": "path",
            "url": "dev-tools",
            "options": {"symlink": true}
        }
    ],
    "require": {
        "devcraftclub/dev-tools": "@dev"
    }
}

Path repositories must be configured by the consuming root project; Composer does not inherit them transitively. Publish this package later, or replace the path repository with a normal repository and version.

The package depends on marcin-orlowski/lombok-php ^1.2.

Fluent properties

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 = [];
}

AbstractWith extends \Lombok\Helper. Unresolved calls go to WithHandler first (with* / with*Item), then to Lombok getters and setters (get* / set* / is*). One WithItem descriptor appends a value. Two descriptors set a key/value pair. Arrays in a descriptor represent union types.

If a subclass defines __construct(), call parent::__construct() so Lombok can wire accessors. with* methods do not depend on that call.