evence/soft-deleteable-extension-bundle

Provides exta functions to the soft deleteable listener of gedmo

SoftDeleteableListenerExtensionBundle

Extensions to Gedmo's softDeleteable listener which has had this issue reported since 2012 : https://github.com/Atlantic18/DoctrineExtensions/issues/505., _(*1)

Provides the onSoftDelete functionality to an association of a doctrine entity. This functionality behaves like the SQL onDelete function (when the owner side is deleted). It will prevent Doctrine errors when a reference is soft-deleted., _(*2)

Cascade delete the entity, _(*3)

To (soft-)delete an entity when its parent record is soft-deleted :, _(*4)

 @Evence\onSoftDelete(type="CASCADE")

Set reference to null (instead of deleting the entity), _(*5)

 @Evence\onSoftDelete(type="SET NULL")

Replace reference by some property marked as successor (must be of same entity class), _(*6)

 @Evence\onSoftDelete(type="SUCCESSOR")

Entity example

``` php <?php, <sub>(*7)</sub>

namespace AppBundle\Entity;, <sub>(*8)</sub>

use Doctrine\ORM\Mapping as ORM; use Gedmo\Mapping\Annotation as Gedmo; use Evence\Bundle\SoftDeleteableExtensionBundle\Mapping\Annotation as Evence;, <sub>(*9)</sub>

/* * @ORM\Entity(repositoryClass="AppBundle\Entity\AdvertisementRepository") * @Gedmo\SoftDeleteable(fieldName="deletedAt") */ class Advertisement {, <sub>(*10)</sub>

...

/**
 * @ORM\ManyToOne(targetEntity="AppBundle\Entity\Shop")
 * @ORM\JoinColumn(name="shop_id", referencedColumnName="id")
 * @Evence\onSoftDelete(type="CASCADE")
 */
private $shop;

...

}, <sub>(*11)</sub>

## Install

**Install with composer:**

composer require evence/soft-deleteable-extension-bundle, <sub>(*12)</sub>

Add the bundle to `app/AppKernel.php`:

``` php
# app/AppKernel.php

$bundles = array(
    ...
    new Evence\Bundle\SoftDeleteableExtensionBundle\EvenceSoftDeleteableExtensionBundle(),
);