Laravel Soft Cascade 使用教程

Laravel Soft Cascade 使用教程

laravel-soft-cascadeCascade Delete & Restore when using Laravel SoftDeletes项目地址:https://gitcode.com/gh_mirrors/la/laravel-soft-cascade

项目介绍

Laravel Soft Cascade 是一个用于 Laravel 和 Lumen 框架的包，它允许在启用 Laravel 的软删除功能时，实现级联删除和恢复。这个包旨在简化软删除和恢复关联关系的过程，类似于 MySQL 的级联删除功能，但适用于 Laravel 的软删除特性。

项目快速启动

安装

使用 Composer 安装 Laravel Soft Cascade 包：

composer require askedio/laravel-soft-cascade

配置

对于 Laravel 5.5 及以上版本，包会自动发现服务提供者。对于之前的版本，需要在 config/app.php 中注册服务提供者：

'providers' => [
    // 其他服务提供者
    Askedio\SoftCascade\Providers\GenericServiceProvider::class,
],

对于 Lumen，需要手动添加服务提供者：

$app->register(Askedio\SoftCascade\Providers\LumenServiceProvider::class);

使用

在模型中启用软级联删除特性，并定义需要级联删除的关联关系：

use Askedio\SoftCascade\Traits\SoftCascadeTrait;

class User extends Model
{
    use SoftCascadeTrait;

    protected $softCascade = ['profiles'];

    // 其他模型代码
}

应用案例和最佳实践

应用案例

假设有一个 User 模型和一个关联的 Profile 模型，当删除一个 User 时，希望其关联的 Profile 也被软删除。通过 Laravel Soft Cascade，可以轻松实现这一点：

class User extends Model
{
    use SoftCascadeTrait;

    protected $softCascade = ['profiles'];

    public function profiles()
    {
        return $this->hasMany(Profile::class);
    }
}

最佳实践

1. 定义清晰的关联关系：确保在模型中清晰地定义所有需要级联删除的关联关系。
2. 测试覆盖：编写单元测试，确保级联删除和恢复功能按预期工作。
3. 文档记录：在项目文档中记录使用了软级联删除的模型和关联关系，以便其他开发者理解和维护。

典型生态项目

Laravel Soft Cascade 可以与其他 Laravel 生态项目结合使用，例如：

1. Laravel Auditing：记录模型操作的审计日志，包括软删除和恢复操作。
2. Laravel Permissions：在删除用户时，级联删除用户的权限和角色。
3. Laravel Notifications：在删除用户时，级联删除用户的通知记录。

通过结合这些生态项目，可以构建更强大和健壮的应用程序。

laravel-soft-cascadeCascade Delete & Restore when using Laravel SoftDeletes项目地址:https://gitcode.com/gh_mirrors/la/laravel-soft-cascade