symandy/mapped-resource

Set of reusable resource interfaces and traits mapped by Doctrine attributes

v1.3.1 2022-11-24 15:12 UTC

This package is auto-updated.

Last update: 2024-11-24 19:27:32 UTC


README

This package is a set of reusable components and contains interfaces and traits that could be used in any PHP project using Doctrine mapping (attributes). It was mainly designed to be used for Symfony entities.

This package design was strongly inspired by Sylius Resource Bundle

Installation

$ composer require symandy/mapped-resource

Components

The components are stored in Symandy\Component\Resource\Model namespace.

Each interface have a corresponding trait and contains one or several attributes :

Each trait contains mapping information with attributes. If you are using XML or YAML driver, you have to redefine the mapping for each property (in each entity).

Usage

Resource creation

The best way to use these components is to create a class and an interface for each resource.

It is also possible to create only the class and add the corresponding traits.

Example

<?php

namespace App;

use Symandy\Component\Resource\Model\ResourceInterface;
use Symandy\Component\Resource\Model\TimestampableInterface;
use Symandy\Component\Resource\Model\ToggleableInterface;

interface PostInterface extends ResourceInterface, ToggleableInterface, TimestampableInterface
{
    # Other methods
}
<?php

namespace App;

use Symandy\Component\Resource\Model\ResourceTrait;
use Symandy\Component\Resource\Model\TimestampableTrait;
use Symandy\Component\Resource\Model\ToggleableTrait;

class Post implements PostInterface
{
    use ResourceTrait, ToggleableTrait, TimestampableTrait;

    # Other attributes with getters / setters
}

Use the resource in your app

<?php
use App\Post;

# ...
$post = new Post();

$id = $post->getId();
$post->enable();
$post->create();
# ...