PHP框架软删除实现教程与技巧

本文深入解析PHP框架中软删除的实现方法与技巧，旨在帮助开发者高效管理数据，提升应用安全性。软删除通过为数据表添加`deleted_at`字段，实现逻辑删除而非物理删除，避免数据永久丢失。文章详细阐述了如何在PHP框架中，通过重写模型`newQuery`方法并结合Global Scope自动过滤已删除数据，以及利用trait实现`delete`、`restore`、`trashed`等核心软删除逻辑。此外，还探讨了软删除对性能的影响，并提供了包括为`deleted_at`字段建立索引、定期清理数据等优化策略。文章还强调了数据安全的重要性，提出了结合权限控制、操作日志和审计工具防止误删或恶意删除的方案，确保数据安全可靠。该方案在Laravel等框架中具备良好的可扩展性，是PHP开发者不可或缺的技能。

软删除通过添加deleted_at字段标记删除时间而非物理删除数据。1. 在PHP中可通过重写模型newQuery方法并结合Global Scope自动过滤未删除数据；2. 使用trait实现delete、restore、trashed等软删除逻辑；3. 为deleted_at字段建立索引以提升查询性能；4. 定期清理已软删除数据并做好备份；5. 通过withTrashed方法查询包含已删除数据，并调用restore恢复；6. 结合权限控制、操作日志和审计工具防止误删或恶意删除，确保数据安全。该方案在Laravel等框架中可高效实现且具备良好扩展性。

软删除，简单来说，就是给数据表加一个字段，比如deleted_at，记录删除的时间。真要删数据的时候，不是直接DELETE，而是更新这个字段。这样，数据还在数据库里，只是逻辑上“删除”了。

解决方案

PHP框架实现软删除，一般有两种方式：一是通过修改模型的查询构造器，二是使用事件监听。我个人更倾向于前者，因为它更简洁，侵入性更小。

修改查询构造器

在你的模型基类中，重写newQuery方法。这个方法负责创建查询构造器实例。我们可以在这里加上一个全局的作用域（Global Scope），自动给所有查询加上where deleted_at is null的条件。

<?php

namespace App\Models;

use Illuminate\Database\Eloquent\Model;
use Illuminate\Database\Eloquent\Builder;

class BaseModel extends Model
{
    /**
     * 覆盖 newQuery 方法
     *
     * @param  bool  $excludeDeleted  是否排除软删除的数据
     * @return \Illuminate\Database\Eloquent\Builder
     */
    public function newQuery($excludeDeleted = true)
    {
        $query = parent::newQuery();

        if ($excludeDeleted && $this->isSoftDeletable()) {
            $query->whereNull('deleted_at');
        }

        return $query;
    }

    /**
     * 判断模型是否使用了软删除
     *
     * @return bool
     */
    protected function isSoftDeletable(): bool
    {
        return method_exists($this, 'bootSoftDeletes');
    }
}

这里加了一个isSoftDeletable方法，用来判断模型是否使用了软删除特性。如果使用了，才加上whereNull('deleted_at')的条件。 这样，所有继承自BaseModel的模型，都会自动过滤掉软删除的数据。

然后，你需要一个trait来处理实际的软删除逻辑：

<?php

namespace App\Traits;

use Illuminate\Support\Carbon;

trait SoftDeletes
{
    /**
     * 执行软删除.
     *
     * @return bool|null
     *
     * @throws \Exception
     */
    public function delete()
    {
        if ($this->fireModelEvent('deleting') === false) {
            return false;
        }

        $this->{$this->getDeletedAtColumn()} = $this->freshTimestampString();

        $this->save();

        $this->fireModelEvent('deleted', false);

        return true;
    }

    /**
     * 获取 "deleted at" 字段的名称.
     *
     * @return string
     */
    public function getDeletedAtColumn()
    {
        return defined('static::DELETED_AT') ? static::DELETED_AT : 'deleted_at';
    }

    /**
     * 恢复被软删除的模型.
     *
     * @return bool|null
     *
     * @throws \Exception
     */
    public function restore()
    {
        // If the restoring event does not return false, we will proceed with this
        // restore operation. Once we have run the restoring event, we will set
        // the "deleted_at" attribute to null and save the model.
        if ($this->fireModelEvent('restoring') === false) {
            return false;
        }

        $this->{$this->getDeletedAtColumn()} = null;
        $this->exists = true;

        // Once we have saved the model, we will fire the restored event so that
        // any listeners can take the appropriate actions.
        $this->save();

        $this->fireModelEvent('restored', false);

        return true;
    }

    /**
     * 确定模型是否被软删除了.
     *
     * @return bool
     */
    public function trashed()
    {
        return ! is_null($this->{$this->getDeletedAtColumn()});
    }
}

最后，在你的模型中使用这个trait：

<?php

namespace App\Models;

use App\Traits\SoftDeletes;

class User extends BaseModel
{
    use SoftDeletes;

    const DELETED_AT = 'is_deleted'; // 可以自定义 deleted_at 字段名

    protected $table = 'users';
}

软删除对性能的影响以及优化策略

软删除虽然方便，但如果数据量很大，deleted_at is null这个条件会增加查询负担。一个简单的优化方法是在deleted_at字段上建立索引。 另外，定期清理软删除的数据，可以减少数据库的压力。 当然，清理之前要做好备份，万一以后需要恢复呢。

如何恢复软删除的数据

有了restore方法，恢复数据就很简单了。 不过，在恢复数据之前，最好先判断一下这条数据是否真的被软删除了，避免误操作。 可以增加一个withTrashed()方法来查询包括软删除的数据。

$user = User::withTrashed()->find($id);

if ($user && $user->trashed()) {
    $user->restore();
}

软删除与数据安全：如何防止误删或恶意删除

软删除虽然避免了物理删除，但仍然存在误删或恶意删除的风险。 权限控制是关键。 只有拥有特定权限的用户才能执行删除操作。 另外，可以考虑增加操作日志，记录每次删除操作的执行者和时间。 这样，即使发生了误删，也能快速定位问题，及时恢复数据。 再进一步，可以考虑使用数据审计工具，对数据库操作进行实时监控和分析，及时发现异常行为。

本篇关于《PHP框架软删除实现教程与技巧》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！