CoolCMS API

CalendarMapper extends Mapper
in package

Application

FinalYes

Base Api mapper over a Doctrine repository.

Every concrete mapper declares protected readonly XRepository $repository (a concrete subclass of OrmRepository); the base cannot declare it because PHP property types are invariant and a child could not narrow the type.

The repository returns the generic BaseEntity; narrowing to the service entity is done by the service.

Properties

$em : EntityManagerInterface
$repository : CalendarRepository

Methods

__construct() : mixed
beginTransaction() : void
commit() : void
delete() : Result
find() : BaseEntity|null
findAll() : array<string|int, mixed>
findBy() : BaseEntity|null
findRelatedIds() : array<int, int>|null: Returns ids of target entities linked to the parent through the relation collection `$property`.
getTransactionLevel() : int
isInTransaction() : bool
rollback() : void
save() : Result
setupEntityManager() : void
updateAllRelations() : Result: Updates all relations of parent entity with given scalar values.
updateColumns() : Result: Updates columns of the given rows and fully replaces to-many relations, all in one transaction.
updateRelations() : Result: Updates existing relation entities in a join/relation table.
resolveRelations() : void
bridgeScalarFkToAssociation() : void: Fills a ManyToOne association from the value of the scalar foreign key that shares the same join column (typically `$menuId` and `menu`, `$pageId` and `page`). Does nothing when the association is not mapped in this entity variant or the scalar is missing or empty (null/0).
doUpdateRelations() : Result
insertRelations() : Result: Inserts relation entities into a join/relation table.
linkOwnedCollections() : void: Links the owning side of owned collections (cascade persist OneToMany, for example translations): sets the back-reference to the parent (`mappedBy`) on every child so that Doctrine writes the FK on flush. Without it newly hydrated children would be saved with a null foreign key (or the insert would fail).
resolveFkIdentifierField() : string|null: Finds the name of the identifier field of the target entity whose database column equals the join column of the back association (`mappedBy`), that is an identifier which is also a foreign key to the parent. Returns null when there is none.
rollBackOwnedLevel() : Throwable|null: Rolls back the transaction levels opened by this mapper (level above the entry level), never foreign ones.
updateColumnsUnguarded() : Result

$em


        protected
            EntityManagerInterface
    $em

$repository read-only


        protected
            CalendarRepository
    $repository

__construct()


    public
                    __construct(CalendarRepository $repository) : mixed

Parameters

$repository : CalendarRepository

beginTransaction()


    public
                    beginTransaction() : void

commit()


    public
                    commit() : void

delete()


    public
                    delete(BaseEntity $entity) : Result

Parameters

$entity : BaseEntity

Return values

Result

find()


    public
                    find(int $id[, string|array<string|int, mixed> $includes = [] ]) : BaseEntity|null

Parameters

$id : int
$includes : string|array<string|int, mixed> = []

Return values

BaseEntity|null

findAll()


    public
                    findAll([array<string|int, mixed>|null $filters = [] ][, array<string|int, mixed>|null $orderBys = null ][, int|null $offset = null ][, int|null $limit = null ][, array<string|int, mixed>|null $columns = null ][, bool $computeTotalCount = false ][, string|array<string|int, mixed>|null $includes = [] ]) : array<string|int, mixed>

Parameters

$filters : array<string|int, mixed>|null = []
$orderBys : array<string|int, mixed>|null = null
$offset : int|null = null
$limit : int|null = null
$columns : array<string|int, mixed>|null = null
$computeTotalCount : bool = false
$includes : string|array<string|int, mixed>|null = []

Return values

array<string|int, mixed>

findBy()


    public
                    findBy([array<string|int, mixed>|null $filters = [] ][, string|array<string|int, mixed> $includes = [] ]) : BaseEntity|null

Parameters

$filters : array<string|int, mixed>|null = []
$includes : string|array<string|int, mixed> = []

Return values

BaseEntity|null

findRelatedIds()

Returns ids of target entities linked to the parent through the relation collection `$property`.


    public
                    findRelatedIds(int $parentId, string $property, string $targetAssociation) : array<int, int>|null

For example ('assetRels', 'asset') returns the asset ids of a record gallery. Table and columns come from Doctrine metadata (same as self::updateAllRelations()).

Parameters

$parentId : int
$property : string
$targetAssociation : string

Return values

array<int, int>|null —

null when metadata or the database failed

getTransactionLevel()


    public
                    getTransactionLevel() : int

Return values

int

isInTransaction()


    public
                    isInTransaction() : bool

Return values

bool

rollback()


    public
                    rollback() : void

save()


    public
                    save(TEntity $entity[, array<int, string> $skipFields = [] ]) : Result

Parameters

$entity : TEntity
$skipFields : array<int, string> = []

Return values

Result

setupEntityManager()


    public
                    setupEntityManager(EntityManagerInterface $entityManager) : void

Parameters

$entityManager : EntityManagerInterface

updateAllRelations()

Updates all relations of parent entity with given scalar values.


    public
                    updateAllRelations(array<string|int, mixed> $parentEntityIds, string $property, array<string, mixed> $values) : Result

Sets values on every row matching the parent FK.

Parameters

$parentEntityIds : array<string|int, mixed>: Parent entity IDs (scalar or composite-id arrays)
$property : string
$values : array<string, mixed>: relation property name => value

Return values

Result

updateColumns()

Updates columns of the given rows and fully replaces to-many relations, all in one transaction.


    public
                    updateColumns(array<string|int, mixed> $entityIds, array<string, mixed> $values) : Result

A collection (one-to-many) is written as a full replace: delete of all parent rows plus per-row inserts. A failure halfway would leave the parent with part of its history or none (price snapshots of product sets), so a failed Result or an exception rolls everything back. A nested call inside a foreign transaction is handled by DBAL with a savepoint.

IMPORTANT: the mapper owns only the transaction level it opened itself. DBAL lowers the level in finally even after a failed commit or savepoint release, so a blind rollback in catch would throw NoActiveTransaction and hide the original error, or inside a foreign transaction it would roll back the caller's level. Rollback therefore runs only while the level is above the entry level; its own failure is logged and never replaces the primary error or Result (a failed Result with a failed rollback becomes DB_ERROR). An ambiguous commit is not retried.

Parameters

$entityIds : array<string|int, mixed>: ids or composite-id arrays ([prop => value])
$values : array<string, mixed>: property name => new value

Return values

Result

updateRelations()

Updates existing relation entities in a join/relation table.


    public
                    updateRelations(array<string|int, mixed> $parentEntityIds, string $property, array<string|int, object> $relationEntities) : Result

Parameters

$parentEntityIds : array<string|int, mixed>: Parent entity IDs (scalar or composite-id arrays)
$property : string: Association property name on parent entity
$relationEntities : array<string|int, object>: Relation entities with updated values

Return values

Result

resolveRelations()


    protected
                    resolveRelations(object $entity) : void

Parameters

$entity : object

bridgeScalarFkToAssociation()

Fills a ManyToOne association from the value of the scalar foreign key that shares the same join column (typically `$menuId` and `menu`, `$pageId` and `page`). Does nothing when the association is not mapped in this entity variant or the scalar is missing or empty (null/0).


    private
                    bridgeScalarFkToAssociation(object $entity, string $associationName) : void

Parameters

$entity : object
$associationName : string

doUpdateRelations()


    private
                    doUpdateRelations(array<string|int, mixed> $parentEntityIds, AssociationMapping $mapping, array<string|int, object> $relationEntities) : Result

Parameters

$parentEntityIds : array<string|int, mixed>: Parent entity IDs (scalar or composite-id arrays)
$mapping : AssociationMapping: OneToMany/ManyToMany association mapping
$relationEntities : array<string|int, object>: Relation entities with updated values

Return values

Result

insertRelations()

Inserts relation entities into a join/relation table.


    private
                    insertRelations(array<string|int, mixed> $parentEntityIds, AssociationMapping $mapping, array<int, object> $relationEntities) : Result

Parameters

$parentEntityIds : array<string|int, mixed>: Parent entity IDs (scalar or composite-id arrays)
$mapping : AssociationMapping: OneToMany/ManyToMany association mapping
$relationEntities : array<int, object>: relation entities (validated in updateColumnsUnguarded())

Return values

Result

linkOwnedCollections()

Links the owning side of owned collections (cascade persist OneToMany, for example translations): sets the back-reference to the parent (`mappedBy`) on every child so that Doctrine writes the FK on flush. Without it newly hydrated children would be saved with a null foreign key (or the insert would fail).


    private
                    linkOwnedCollections(object $entity) : void

For children whose identifier is itself a foreign key to the parent (typically translations: PK = page_id + language_id, where page_id is also the FK), the scalar identifier is filled from the parent id. Doctrine does not derive it from the association (it is not a derived identity through #[Id] on the association), so it would fail with EntityMissingAssignedId. Works for an existing parent (the id is known); a brand-new parent (the id appears only on flush) needs a two-phase write.

Parameters

$entity : object

resolveFkIdentifierField()

Finds the name of the identifier field of the target entity whose database column equals the join column of the back association (`mappedBy`), that is an identifier which is also a foreign key to the parent. Returns null when there is none.


    private
                    resolveFkIdentifierField(class-string $targetEntity, string $mappedBy) : string|null

Parameters

$targetEntity : class-string
$mappedBy : string

Return values

string|null

rollBackOwnedLevel()

Rolls back the transaction levels opened by this mapper (level above the entry level), never foreign ones.


    private
                    rollBackOwnedLevel(Connection $connection, int $entryLevel, Throwable|null $primary) : Throwable|null

Returns the rollback exception (logged together with $primary), or null on success.

Parameters

$connection : Connection
$entryLevel : int
$primary : Throwable|null

Return values

Throwable|null

updateColumnsUnguarded()


    private
                    updateColumnsUnguarded(array<string|int, mixed> $entityIds, array<string, mixed> $values) : Result

Parameters

$entityIds : array<string|int, mixed>: ids or composite-id arrays ([prop => value])
$values : array<string, mixed>: property name => new value

Return values

Result

CalendarMapper extends Mapper in package Application

Table of Contents

Properties

Methods

Properties

$em

$repository read-only

Methods

__construct()

Parameters

beginTransaction()

commit()

delete()

Parameters

Return values

find()

Parameters

Return values

findAll()

Parameters

Return values

findBy()

Parameters

Return values

findRelatedIds()

Parameters

Return values

getTransactionLevel()

Return values

isInTransaction()

Return values

rollback()

save()

Parameters

Return values

setupEntityManager()

Parameters

updateAllRelations()

Parameters

Return values

updateColumns()

Parameters

Return values

updateRelations()

Parameters

Return values

resolveRelations()

Parameters

bridgeScalarFkToAssociation()

Parameters

doUpdateRelations()

Parameters

Return values

insertRelations()

Parameters

Return values

linkOwnedCollections()

Parameters

resolveFkIdentifierField()

Parameters

Return values

rollBackOwnedLevel()

Parameters

Return values

updateColumnsUnguarded()

Parameters

Return values

CalendarMapper extends Mapper
in package

Application