Slidy k přednášce Nikol Ježkové z konference PHP<live> winter 2016.

1. Doctrine2 Behaviour Extensions
zaostřeno na stromy
Nikol Ježková

3. Doctrine2 Behaviour Extensions
● Tree
● Translatable
● Sluggable
● Uploadable
● Loggable
● Sortable
● Timestampable
● IpTraceable
● Blameable
● SoftDeletable
● References
● ReferenceIntegrity

4. gedmo/doctrine-extensions
● $ composer require gedmo/doctrine-extensions
●
ORM, ODM
Doctrine 2.2.x – 2.5.x
PHP ≥ 5.4
Kompatibilita
https://github.com/Atlantic18/DoctrineExtensions

5. Listeners
Translation
Tree
Sluggable
Timestampable
...
onFlush
EntityManager
Entita
Annotace
XML
YAML
EventManager
Doctrine Event System
mapování

6. Hierarchická data
Nested-Set chování
@GedmoTree
GedmoTreeTreeListener
type [Nested-set, Closure-table, Materialized-path]

7. level1
2
3
parent
parent
child child
child child
parent
child
Nested-Set behaviour

8. @GedmoTreeLevel 1 12
5 63 4 9 10
2 7 8 11
@GedmoTree(type="nested")
1
2
3
@GedmoTreeLeft @GedmoTreeRight
@GedmoTreeParent
1
2 3
use GedmoMappingAnnotation as Gedmo;
trait NestedSetEntity

9. getRootNodes
getPath
getChildren
getLeafs
getNextSiblings
getPrevSiblings
getNodesHierarchy
moveUp
moveDown
NestedTreeRepository
persistAsFirstChild
persistAsFirstChildOf
persistAsLastChild
persistAsLastChildOf
persistAsNextSibling
persistAsNextSiblingOf
persistAsPrevSibling
persistAsPrevSiblingOf
removeFromTree

10. @GedmoTreeLevel
@GedmoTreeParent
@GedmoTreePath
@GedmoTreePathSource
@GedmoTree(type="materializedPath")
MaterializedPathRepository, trait MaterializedPath
id title parent_id path lvl
1 PC null pc-1 1
2 Notebook 1 pc-1,Notebook-2 2
3 MacBook 2 pc-1,Notebook-2, MacBook-3 3
4 MacBook Air 3 pc-1,Notebook-2, MacBook-3, MacBook Air-4 4

11. MaterializedPathRepository
getRootNodes [Query / QueryBuilder]
getPath [Query / QueryBuilder]
getNodesHierarchy [Query / QueryBuilder]
getTree [Query / QueryBuilder]
getChildren [Query / QueryBuilder]
childrenHierarchy

12. @GedmoTreeLevel
@GedmoTreeParent
addClosure
@GedmoTree(type="closure")
@GedmoTreeClosure(class="ClosureEntity")
ClosureTreeRepository
ancestor descendant depth
ClosureEntity extends AbstractClosureEntity

13. ClosureTreeRepository
getRootNodes [Query / QueryBuilder]
getPath [Query / QueryBuilder]
getNodesHierarchy [Query / QueryBuilder]
getTree [Query / QueryBuilder]
getChildren [Query / QueryBuilder]
childrenHierarchy
removeFromTree

15. @GedmoUploadable
UploadableListener, interface Uploadable

16. @GedmoUploadableFilePath
@GedmoUploadableFileName
@GedmoUploadableFileMimeType
@GedmoUploadableFileSize
@GedmoUploadable
path filenameGenerator allowOverwrite appendNumber callback
$fileinfo = $_FILES['foo'];
x
$fileinfo instanceOf UploadableFileInfoFileInfoArray;
// UploadableListener
$listener->addEntityFileInfo($file, $fileinfo);

17. Translatable
TranslatableListener
@GedmoTranslatable
@GedmoLocale
TranslationRepository

18. Entita Listener
@GedmoLocale
@GedmoTranslatable
setLocale
$defaultLocale
$locale

19. class Article implements GedmoTranslatableTranslatable
{ ...
$article = new EntityArticle;
$article->setTitle('Konference');
$article->setContent(Začátek');
// TranslationRepository
$repo->translate($article, 'title', 'de_de', 'Konferenz')
->translate($article, 'content', 'de_de', 'Beginn');
$em->persist($article);
$em->flush();
$article->setLocale('de_de');
$em->refresh($article);
$article->setLocale('cs_cz');
$em->refresh($article);
$article = $repo->findObjectByTranslatedField('title',
'Konferenz', 'EntityArticle');
GedmoTranslatableEntityRepositoryTranslationRepository

20. @GedmoSlug(
fields={"title", "content"}
separator="="
prefix="begin-"
suffix="-end"
style="lower"
updatable
unique
handlers
)
Sluggable
SluggableListener
begin-konference=phplive=brno=zilina-end
$entity->title = 'Konference PHPLive';
$entity->content = 'Brno Žilina'

21. @GedmoSlugHandler
● class: RelativeSlugHandler
● options
– relationField
– relationSlugField
● class: TreeSlugHandler
● options
– parentRelationField
– relationSlugField

22. @GedmoSlug(
handlers={
@GedmoSlugHandler(
class="RelativeSlugHandler",
options={
@GedmoSlugHandlerOption(
name="relationField",
value="entity"
),
@GedmoSlugHandlerOption(
name="relationSlugField",
value="slug"
),
@GedmoSlugHandlerOption(
name="separator",
Value="/"
)
}
)
},
fields={"title"}
)

23. @GedmoSortablePosition
@GedmoSortableGroup
setPosition(-1)
SortableRepository
getBySortableGroups(['title' => 'PHP live'])
id: 2 – 4 – 5 – 3 – 1
Sortable
SortableRepository
id SortableGroup
$title
SortablePosition
$position
1 PHP live 5
2 PHP live 1
3 PHP live 4
4 PHP live 2
5 PHP live 3

24. @GedmoTimestampable
● trait TimestampableEntity
@GedmoIpTraceable
● trait IpTraceableEntity
on creatte/update/change
field
value
Timestampable, IpTraceable
TimestampableListener, IpTraceableListener

25. @GedmoMappingAnnotationBlameable(
on creatte/update/change
field
value
)
Blameable
BlameableListener, trait BlameableEntity

26. @GedmoVersioned
LogEntryRepository
->revert($entity, 1)
@GedmoLoggable
LoggableListener
id
action
logged_at
object_id
object_class
version
data

27. trait SoftDeleteableEntity
SoftDeleteable(fieldName="deletedAt")
SoftDeleteableFilter
SoftDeleteableFilter
enable null
disable
find
disableForEntity
enableForEntity
enable
null in DBdisable
delete
disableForEntity
enableForEntity
mark in DB

28. References, ReferenceIntegrity
entity
entity
ReferencesListener
ReferenceIntegrityListener

29. ● StofDoctrineExtensionsBundle
● gedmo/doctrine-extensions
Uploadable
StofDoctrineExtensionsBundleUploadableUploadableManager
SymfonyComponentHttpFoundationFileUploadedFile
$manager->markEntityToUpload($file, $uploadedFile);

30. ● Kdyby/Doctrine
● rixxi/gedmo
laravel-doctrine/extensions

31. ● Propel
nested_set, sluggable, timestampable, sortable,
versionable
● Eloquent ORM [laravel]
Soft Deleting, Timestamps
● RedBeanPHP
tree
Behaviours v jiných ORM

32. Děkuji za pozornost :-)