symandy / mapped-resource
Set of reusable resource interfaces and traits mapped by Doctrine attributes
Requires
- php: ^8.0
- doctrine/orm: ^2.10
Requires (Dev)
- phpunit/phpunit: ^9.5
Replaces
- symandy/resource: v1.3.1
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(); # ...