Laravel 软删除与文件系统

在开发 Laravel 应用时，我们经常需要处理数据的删除和文件的管理。介绍如何使用 Laravel 的软删除功能以及文件系统来实现这些需求。

解决方案

Laravel 提供了软删除（Soft Deleting）功能，可以将记录标记为已删除而不是从数据库中永久删除。Laravel 的文件系统（Filesystem）提供了多种存储驱动，方便我们在不同环境中管理文件。如何使用这些功能，并提供几种实现思路。

使用软删除

启用软删除

我们需要在模型中启用软删除功能。假设我们有一个 User 模型，可以在模型中使用 SoftDeletes trait：

php
namespace AppModels;</p>

<p>use IlluminateDatabaseEloquentModel;
use IlluminateDatabaseEloquentSoftDeletes;</p>

<p>class User extends Model
{
    use SoftDeletes;</p>

<pre><code>protected $dates = ['deleted_at'];

}

删除和恢复记录

启用软删除后，我们可以使用 delete 方法将记录标记为已删除：

php
$user = User::find(1);
$user->delete();


如果需要恢复记录，可以使用 restore 方法：

php
$user = User::withTrashed()->find(1);
$user->restore();


查询软删除记录

要查询所有被软删除的记录，可以使用 onlyTrashed 方法：

php
$deletedUsers = User::onlyTrashed()->get();


要查询所有未被软删除的记录，可以使用 withTrashed 方法：

php
$allUsers = User::withTrashed()->get();


使用文件系统

配置文件系统

Laravel 的文件系统配置位于 config/filesystems.php 文件中。默认情况下，Laravel 支持本地存储、S3 存储等多种驱动。我们可以通过修改配置文件来选择合适的存储驱动。

例如，配置 S3 存储：

php
'disks' => [
's3' => [
'driver' => 's3',
'key' => env('AWS_ACCESS_KEY_ID'),
'secret' => env('AWS_SECRET_ACCESS_KEY'),
'region' => env('AWS_DEFAULT_REGION'),
'bucket' => env('AWS_BUCKET'),
'url' => env('AWS_URL'),
],
],


上传文件

假设我们需要上传一个文件到 S3 存储，可以使用 Storage facade：

php
use IlluminateSupportFacadesStorage;</p>

<p>public function uploadFile(Request $request)
{
    $path = $request->file('file')->store('uploads', 's3');
    return response()->json(['path' => $path]);
}

下载文件

下载文件同样简单，可以使用 download 方法：

php
use IlluminateSupportFacadesStorage;</p>

<p>public function downloadFile($filename)
{
    return Storage::disk('s3')->download($filename);
}

删除文件

删除文件可以使用 delete 方法：

php
use IlluminateSupportFacadesStorage;</p>

<p>public function deleteFile($filename)
{
    Storage::disk('s3')->delete($filename);
    return response()->json(['message' => 'File deleted successfully']);
}

结合使用软删除和文件系统

在某些场景下，我们可能需要在删除记录时同时删除相关文件。例如，当删除用户时，我们也希望删除该用户的头像文件。

删除用户及其头像

php
use IlluminateSupportFacadesStorage;</p>

<p>public function deleteUser($id)
{
    $user = User::find($id);</p>

<pre><code>if ($user) {
    // 删除头像文件
    if ($user->avatar) {
        Storage::disk('s3')->delete($user->avatar);
    }

    // 删除用户记录
    $user->delete();

    return response()->json(['message' => 'User and avatar deleted successfully']);
}

return response()->json(['message' => 'User not found'], 404);

}

恢复用户及其头像

php
use IlluminateSupportFacadesStorage;</p>

<p>public function restoreUser($id)
{
    $user = User::withTrashed()->find($id);</p>

<pre><code>if ($user) {
    // 恢复用户记录
    $user->restore();

    return response()->json(['message' => 'User restored successfully']);
}

return response()->json(['message' => 'User not found'], 404);

}

通过以上步骤，我们可以有效地使用 Laravel 的软删除和文件系统功能，实现数据和文件的灵活管理。