Лаб. работа 6 “Работа с файлами (эмуляция S3-хранилища)”

Разработка web-приложений с использованием программных платформ
Практика
Автор

Бизюк Андрей

Дата публикации

27 февраля 2025 г.

Тема: Реализация загрузки, хранения и управления файлами с использованием локального хранилища в качестве эмуляции S3.
Цель: Научиться работать с файловой системой Laravel, имитируя облачное хранилище, и реализовать CRUD для мультимедийных данных.

Задачи

  1. Настроить фейковый S3-диск для локальной разработки.
  2. Реализовать загрузку файлов к постам.
  3. Добавить валидацию и оптимизацию файлов.
  4. Организовать просмотр и удаление файлов.

Методическая часть

1. Настройка файлового хранилища

  1. Добавьте новый диск в config/filesystems.php:

    'disks' => [
    // ... другие диски
    's3-fake' => [
        'driver' => 'local',
        'root' => storage_path('app/s3-fake'),
        'url' => env('APP_URL') . '/storage/s3-fake',
        'visibility' => 'public',
    ],
],

  2. Обновите .env:

    FILESYSTEM_DISK=s3-fake

  3. Создайте директорию и симлинк:

    mkdir -p storage/app/s3-fake
php artisan storage:link

2. Модификация модели и миграции

  1. Создайте модель Media:

    php artisan make:model Media -m

  2. Добавьте поля в миграцию:

    Schema::create('media', function (Blueprint $table) {
    $table->id();
    $table->string('path');
    $table->foreignId('post_id')->constrained()->cascadeOnDelete();
    $table->string('type'); // image, video, document
    $table->timestamps();
});

  3. Добавьте связь в модели:

    • В Post.php:

      public function media() {
    return $this->hasMany(Media::class);
}

3. Обновление контроллера PostController

  1. Метод store для загрузки файлов:

    use Illuminate\Support\Facades\Storage;

public function store(Request $request) {
    $validated = $request->validate([
        'title' => 'required|max:255',
        'files.*' => 'file|mimes:jpg,png,pdf,mp4|max:5120',
    ]);

    $post = Post::create($validated);

    if ($request->hasFile('files')) {
        foreach ($request->file('files') as $file) {
            $path = $file->store("posts/{$post->id}", 's3-fake');
            Media::create([
                'post_id' => $post->id,
                'path' => $path,
                'type' => $file->getMimeType(),
            ]);
        }
    }

    return redirect()->route('posts.index');
}

  2. Метод destroyFile для удаления:

    public function destroyFile(Media $media) {
    Storage::disk('s3-fake')->delete($media->path);
    $media->delete();
    return back()->with('success', 'Файл удалён!');
}

4. Blade-шаблоны

  1. Форма загрузки файлов (posts/create.blade.php):

    <form method="POST" action="{{ route('posts.store') }}" enctype="multipart/form-data">
    @csrf
    <div class="mb-4">
        <label>Прикрепить файлы:</label>
        <input type="file" name="files[]" multiple class="border p-2 w-full">
        @error('files.*') <div class="text-red-500">{{ $message }}</div> @enderror
    </div>
    <!-- Остальные поля формы -->
</form>

  2. Галерея файлов (posts/show.blade.php):

    <div class="grid grid-cols-3 gap-4">
    @foreach ($post->media as $media)
        <div class="relative">
            @if (Str::startsWith($media->type, 'image'))
                <img src="{{ Storage::disk('s3-fake')->url($media->path) }}" 
                     class="w-full h-48 object-cover">
            @else
                <div class="bg-gray-100 p-4">
                    <p>{{ basename($media->path) }}</p>
                </div>
            @endif
            <form method="POST" action="{{ route('posts.deleteFile', $media) }}" 
                  class="absolute top-2 right-2">
                @csrf @method('DELETE')
                <button type="submit" class="bg-red-500 text-white p-1 rounded">×</button>
            </form>
        </div>
    @endforeach
</div>

Индивидуальные задания

1. Валидация имен файлов

  • Запретите загрузку файлов с пробелами в имени:

    Validator::extend('no_spaces', function ($attr, $value, $params) {
    return !preg_match('/\s/', $value->getClientOriginalName());
});
// Использование:
'files.*' => 'no_spaces',

2. Логирование операций

  • Создайте middleware LogFileOperations:

    public function handle($request, Closure $next) {
    if ($request->hasFile('files')) {
        \Log::info("Uploaded files: " . json_encode($request->file('files')));
    }
    return $next($request);
}

  • Зарегистрируйте его в bootstrap/app.php:

    ->withMiddleware(function (Middleware $middleware) {
    $middleware->append(\App\Http\Middleware\LogFileOperations::class);
})

3. Оптимизация изображений (опционально)

  • Установите пакет:

    composer require spatie/image-optimizer

  • Оптимизируйте изображения перед сохранением:

    use Spatie\ImageOptimizer\OptimizerChainFactory;
// ...
foreach ($request->file('files') as $file) {
    if (Str::startsWith($file->getMimeType(), 'image')) {
        $optimizer = OptimizerChainFactory::create();
        $optimizer->optimize($file->getRealPath());
    }
    // Сохранение файла...
}

Проверка работы

  1. Загрузка файлов:
    • Откройте форму создания поста.
    • Загрузите несколько файлов (изображения, PDF).
    • Убедитесь, что файлы сохранились в storage/app/s3-fake/posts/{post_id}.
  2. Просмотр файлов:
    • Откройте страницу поста.
    • Проверьте, что изображения отображаются, а PDF показывается как ссылка.
  3. Удаление файлов:
    • Нажмите кнопку удаления файла.
    • Убедитесь, что файл удалён из хранилища и БД.

Примечания

  • Преимущества подхода:
    • Эмуляция облачного хранилища экономит ресурсы.
    • Легко переключиться на реальный S3 через .env.
  • Важно:
    • Для продакшена замените s3-fake на s3 в .env.
    • Для тестирования используйте Storage::fake('s3-fake').
Наверх