Как в Laravel 10 реализовать валидацию различных данных вместе с изображением и файлами?…
- User
Как в Laravel 10 реализовать валидацию различных данных вместе с изображением и файлами? Предполагается получить данные в которых помимо других данных может быть изображение или файл или и то и другое, все изображения должны иметь одинаковые правила из предоставляемого набора Laravel, также все файлы должны иметь одинаковые правила из предоставляемого набора Laravel. Файлы и изображения помещаются в общую папку название которое задаётся один раз, далее в зависимости от того файл это или изображение добавляется подпапка название которой также задаётся один раз. Валидацию изображений предполагается использовать при валидации других различных запросов. Например, помимо прочих соответствующих задаче валидаций, валидация изображения может использовать в контроллере при создании чата И в контроллере при создании сообщения. Напиши код реализующий это, при этом абсолютно весь твой код (даже тот что я не просил) должен соответствовать KISS, DRY, YAGNI, BDUF, SOLID, APO.
- Assistant
Для реализации валидации различных данных вместе с изображениями и файлами в Laravel 10, соблюдая принципы KISS, DRY, YAGNI, BDUF, SOLID и APO, можно выполнить следующие шаги:
- Создать конфигурационный файл для хранения путей.
- Создать сервис для обработки загрузки файлов и изображений.
- Создать кастомные правила валидации или использовать Form Request для валидации запросов.
- Использовать созданный сервис и правила в контроллерах.
Ниже представлен полный пример реализации:
1. Конфигурация путей хранения
Создайте файл конфигурации
config/filestorage.php, чтобы централизовать пути хранения:<?php // config/filestorage.php return [ 'base_path' => 'uploads', // Общая папка для файлов и изображений 'image' => [ 'subfolder' => 'images', 'rules' => 'image|mimes:jpeg,png,jpg,gif,svg|max:2048', // Пример правил для изображений ], 'file' => [ 'subfolder' => 'files', 'rules' => 'file|mimes:pdf,doc,docx,zip|max:10240', // Пример правил для файлов ], ];2. Сервис для обработки загрузки файлов и изображений
Создайте сервисный класс для обработки загрузки и сохранения файлов и изображений:
<?php // app/Services/FileService.php namespace App\Services; use Illuminate\Http\UploadedFile; use Illuminate\Support\Facades\Storage; class FileService { protected $config; public function __construct() { $this->config = config('filestorage'); } /** * Сохраняет загруженный файл или изображение. * * @param UploadedFile $file * @param string $type 'image' или 'file' * @return string Путь к сохраненному файлу * @throws \Exception */ public function store(UploadedFile $file, string $type): string { if (!in_array($type, ['image', 'file'])) { throw new \Exception("Invalid file type: {$type}"); } $basePath = $this->config['base_path']; $subfolder = $this->config[$type]['subfolder']; return $file->store("{$basePath}/{$subfolder}"); } }3. Создание Form Request для валидации
Создайте базовый
FormRequest, который можно будет использовать в различных контроллерах:<?php // app/Http/Requests/BaseRequest.php namespace App\Http\Requests; use Illuminate\Foundation\Http\FormRequest; use Illuminate\Validation\Rule; class BaseRequest extends FormRequest { protected $fileRules; protected $imageRules; public function __construct() { parent::__construct(); $this->fileRules = config('filestorage.file.rules'); $this->imageRules = config('filestorage.image.rules'); } /** * Правила для файлов. * * @return array */ protected function fileRules(): array { return ['file' => $this->fileRules]; } /** * Правила для изображений. * * @return array */ protected function imageRules(): array { return ['image' => $this->imageRules]; } }Теперь создайте конкретные
FormRequestдля нужных действий, например, для создания чата и сообщения.Пример для создания чата:
<?php // app/Http/Requests/CreateChatRequest.php namespace App\Http\Requests; class CreateChatRequest extends BaseRequest { public function rules(): array { return [ 'title' => 'required|string|max:255', // Другие правила для создания чата 'image' => 'nullable|' . $this->imageRules()['image'], 'file' => 'nullable|' . $this->fileRules()['file'], ]; } }Пример для создания сообщения:
<?php // app/Http/Requests/CreateMessageRequest.php namespace App\Http\Requests; class CreateMessageRequest extends BaseRequest { public function rules(): array { return [ 'content' => 'required|string', // Другие правила для создания сообщения 'image' => 'nullable|' . $this->imageRules()['image'], 'file' => 'nullable|' . $this->fileRules()['file'], ]; } }4. Использование сервиса и Form Request в контроллерах
Контроллер для создания чата:
<?php // app/Http/Controllers/ChatController.php namespace App\Http\Controllers; use App\Http\Requests\CreateChatRequest; use App\Services\FileService; use Illuminate\Http\JsonResponse; class ChatController extends Controller { protected $fileService; public function __construct(FileService $fileService) { $this->fileService = $fileService; } public function store(CreateChatRequest $request): JsonResponse { $data = $request->validated(); // Обработка загрузки изображения if ($request->hasFile('image')) { $data['image_path'] = $this->fileService->store($request->file('image'), 'image'); } // Обработка загрузки файла if ($request->hasFile('file')) { $data['file_path'] = $this->fileService->store($request->file('file'), 'file'); } // Создание чата (предполагается, что есть модель Chat) $chat = Chat::create($data); return response()->json(['chat' => $chat], 201); } }Контроллер для создания сообщения:
<?php // app/Http/Controllers/MessageController.php namespace App\Http\Controllers; use App\Http\Requests\CreateMessageRequest; use App\Services\FileService; use Illuminate\Http\JsonResponse; class MessageController extends Controller { protected $fileService; public function __construct(FileService $fileService) { $this->fileService = $fileService; } public function store(CreateMessageRequest $request): JsonResponse { $data = $request->validated(); // Обработка загрузки изображения if ($request->hasFile('image')) { $data['image_path'] = $this->fileService->store($request->file('image'), 'image'); } // Обработка загрузки файла if ($request->hasFile('file')) { $data['file_path'] = $this->fileService->store($request->file('file'), 'file'); } // Создание сообщения (предполагается, что есть модель Message) $message = Message::create($data); return response()->json(['message' => $message], 201); } }5. Роутинг
Добавьте маршруты для контроллеров:
// routes/web.php или routes/api.php use App\Http\Controllers\ChatController; use App\Http\Controllers\MessageController; Route::post('/chats', [ChatController::class, 'store']); Route::post('/messages', [MessageController::class, 'store']);Объяснение
-
Конфигурация (
config/filestorage.php):- Центральное место для хранения путей и правил валидации для файлов и изображений.
- Это позволяет легко изменять настройки без необходимости правки кода везде.
-
Сервис (
FileService):- Инкапсулирует логику сохранения файлов.
- Соблюдает принцип единственной ответственности (Single Responsibility Principle - SRP).
- Позволяет повторно использовать код сохранения файлов в разных частях приложения.
-
Базовый
FormRequest(BaseRequest):- Предоставляет общие правила для файлов и изображений.
- Позволяет наследоваться и расширять правила в конкретных запросах.
- Соблюдает принцип DRY, избегая повторения правил валидации.
-
Конкретные
FormRequest(CreateChatRequest,CreateMessageRequest):- Определяют специфичные для действия правила валидации, включая файлы и изображения.
- Упрощают контроллеры, перемещая логику валидации в отдельный класс.
-
Контроллеры:
- Используют внедрение зависимостей (Dependency Injection) для получения экземпляра
FileService. - Обрабатывают запросы, используя валидированные данные.
- Сохраняют файлы и изображения при наличии.
- Используют внедрение зависимостей (Dependency Injection) для получения экземпляра
-
Роутинг:
- Чётко определяет точки входа для создания чатов и сообщений.
Дополнительные рекомендации
- Обработка ошибок: Убедитесь, что обрабатываете возможные исключения при сохранении файлов, чтобы обеспечить надежность приложения.
- Тестирование: Напишите модульные тесты для
FileServiceиFormRequest, чтобы гарантировать корректную работу валидации и сохранения файлов. - Модели: Убедитесь, что ваши модели (
Chat,Message) имеют соответствующие поля (image_path,file_path) и защищены от массового присвоения ($fillableили$guarded).
Этот подход обеспечивает чистую, расширяемую и поддерживаемую архитектуру, соответствующую заявленным принципам разработки.