Symfony3数据库模型软删除功能怎么实现-php教程-PHP中文网

symfony3 中实现软删除的核心是通过 deletedat 字段逻辑标记删除，借助 gedmo 扩展自动过滤查询并支持恢复与彻底删除。

symfony3数据库模型软删除功能怎么实现

Symfony3 中实现数据库模型的软删除，核心是不真正删除记录，而是通过标记字段（如 deletedAt）来逻辑隐藏数据，并配合 Doctrine 的生命周期回调与查询扩展完成自动过滤。

添加软删除字段到实体

在实体类中增加一个可为空的 DateTime 字段，用于记录删除时间：

/**
 * @ORM\Column(type="datetime", nullable=true)
 */
private $deletedAt;
<p>public function getDeletedAt(): ?\DateTime
{
return $this->deletedAt;
}</p><p>public function setDeletedAt(?\DateTime $deletedAt): self
{
$this->deletedAt = $deletedAt;
return $this;
}
</p>

使用 Doctrine 扩展（推荐方式）

官方推荐使用 Gedmo Doctrine Extensions，它提供开箱即用的软删除支持：

Symfony Linux版

Symfony Linux版整理 Symfony CLI 5.17.1 官方下载入口和 Symfony 框架安装配置说明。

下载

安装扩展：composer require gedmo/doctrine-extensions
在实体上启用软删除行为：
```
use Gedmo\Mapping\Annotation as Gedmo;
<p>/**</p>
```
- @Gedmo\SoftDeleteable(fieldName="deletedAt", timeAware=false) */ class Article { // ... }

配置 Doctrine（config.yml）启用扩展：

doctrine:
 orm:
     mappings:
         App:
             type: annotation
             dir: '%kernel.project_dir%/src/Entity'
             prefix: 'App\Entity'
             is_bundle: false
             # 启用软删除监听器
             doctrine_extensions:
                 soft_deleteable: true

自动过滤已软删除的数据

启用软删除后，Doctrine 默认会在所有 SELECT 查询中自动排除 deletedAt IS NOT NULL 的记录。但需注意：

原生 SQL 查询、createQuery 或 DQL 中手动写的 WHERE 不受自动过滤影响，需显式加条件
若需临时查出已删除记录，可用 Repository::createQueryBuilder() 并移除默认过滤：
```
$qb = $repo->createQueryBuilder('a');
$qb->where('a.deletedAt IS NULL'); // 显式控制
```
调用 $em->remove($entity) 时，扩展会自动设置 deletedAt 并跳过物理删除