The document discusses various behavior extensions for Doctrine 2 that are provided by the gedmo/doctrine-extensions library. It describes extensions for tree data, translations, slugs, uploads, timestamps, sorting, soft deletes, and more. Each extension includes annotations and listeners that add behaviors like hierarchical data handling, translation management, file uploads, logging, etc to entities managed by Doctrine.

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 :-)