Валидация в Laravel: пошаговая настройка на Ubuntu 24.04
Валидация в Laravel выполняется методом $request->validate() или классом FormRequest, а ошибки Laravel сам возвращает в сессию или в JSON. Настройка сводится к правилам в запросе, выводу ошибок в шаблоне и проверке ответов для API. Все команды выполняются от владельца проекта в каталоге /var/www/example.com.
01Проверьте окружение Laravel
Зайдите в каталог проекта и убедитесь, что Laravel отвечает и видит базу. Версию показывает php artisan --version, список маршрутов, php artisan route:list. Если проекта ещё нет, его создаёт composer create-project laravel/laravel example.com, а установка описана на отдельной странице.
cd /var/www/example.com
php artisan --version
php artisan route:list
02Создайте FormRequest с правилами
Правила валидации удобно держать в отдельном классе запроса. Команда создаёт app/Http/Requests/StoreCustomerRequest.php, где метод authorize() возвращает true, а rules() перечисляет правила. Для формы заявки хватит имени, email и текста сообщения.
php artisan make:request StoreCustomerRequest
03Опишите правила в методе rules
Верните из rules() массив правил: required и max:255 для имени, email и unique:customers,email для адреса, nullable и max:2000 для сообщения. Правило unique проверяет таблицу customers и сработает только при настроенном подключении к MySQL в .env.
<?php
namespace App\Http\Requests;
use Illuminate\Foundation\Http\FormRequest;
class StoreCustomerRequest extends FormRequest
{
public function authorize(): bool
{
return true;
}
public function rules(): array
{
return [
'name' => ['required', 'string', 'max:255'],
'email' => ['required', 'email', 'unique:customers,email'],
'message' => ['nullable', 'string', 'max:2000'],
];
}
}
04Подключите запрос в контроллере
В методе контроллера замените Request на StoreCustomerRequest: Laravel проверит данные до входа в тело метода. При ошибке браузерный запрос получает редирект назад с ошибками в сессии, а запрос с Accept: application/json получает ответ 422 с массивом errors. Валидные данные забирают через $request->validated().
<?php
namespace App\Http\Controllers;
use App\Http\Requests\StoreCustomerRequest;
use App\Models\Customer;
class CustomerController extends Controller
{
public function store(StoreCustomerRequest $request)
{
$customer = Customer::create($request->validated());
return redirect()->route('customers.show', $customer);
}
}
05Выведите ошибки в Blade-шаблоне
В форме добавьте @csrf и директиву @error рядом с каждым полем. Директива показывает сообщение из $errors, а old() возвращает введённое значение после неудачной проверки. Без вывода ошибок пользователь видит только повторную форму и не понимает, что не так.
<form method="POST" action="{{ route('customers.store') }}">
@csrf
<label for="name">Имя</label>
<input id="name" name="name" value="{{ old('name') }}">
@error('name')
<div class="error">{{ $message }}</div>
@enderror
<label for="email">Email</label>
<input id="email" name="email" value="{{ old('email') }}">
@error('email')
<div class="error">{{ $message }}</div>
@enderror
<button type="submit">Отправить</button>
</form>
06Настройте ответы валидации для API
Для маршрутов API Laravel отвечает JSON, если клиент прислал заголовок Accept: application/json. Ошибка валидации даёт код 422 и объект errors с полями, успешный запрос проходит дальше. Неавторизованный запрос к маршруту за auth:sanctum без этого заголовка даёт Route [login] not defined., потому что Laravel пытается перенаправить на маршрут login.
curl -X POST https://example.com/api/customers \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{"name":"","email":"not-an-email"}'
07Проверьте валидацию запросами
Отправьте заведомо неверные данные и убедитесь, что ответ содержит 422 и список полей. Затем отправьте корректные данные и проверьте запись в базе. Для браузерной формы проверьте, что после ошибки видны сообщения и сохранённые значения полей.
curl -i -X POST https://example.com/api/customers \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{"name":"","email":"not-an-email"}'
curl -i -X POST https://example.com/api/customers \
-H "Accept: application/json" \
-H "Content-Type: application/json" \
-d '{"name":"Иван","email":"ivan@example.com"}'
08Сбросьте кэш после правки правил
Если правила лежат в config/ или зависят от .env, после правки пересоберите кэш конфига. Команда php artisan config:clear только удаляет кэш, новые значения она не применяет. Выполните php artisan optimize или php artisan config:cache, иначе сайт продолжит работать по старым настройкам.
php artisan optimize
php artisan route:list
Частые ошибки
-
После правки
.envили файлов вconfig/валидация работает по старым настройкам: конфиг закэширован командойphp artisan optimize.Выполните
php artisan optimizeилиphp artisan config:cache. Командаphp artisan config:clearтолько удаляет кэш и новые значения не применяет. -
В API вместо ответа 422 с ошибками валидации клиент получает
Route [login] not defined.Такая ошибка возникает при неавторизованном запросе к маршруту за
authилиauth:sanctum, а не при ошибке валидации. Отправляйте заголовокAccept: application/json, тогда Laravel отвечает 401 вместо редиректа наlogin, а ошибки валидации отдаёт как 422. -
Форма отправляется, но сообщения об ошибках не появляются, и пользователь не понимает, что не так.
Добавьте в шаблон директиву
@error('поле')и вывод{{ $message }}рядом с каждым полем. Проверьте, что форма содержит@csrf. -
Правило
uniqueпадает с ошибкой подключения к базе.Проверьте в
.envзначенияDB_CONNECTION=mysql,DB_HOST,DB_DATABASE,DB_USERNAMEиDB_PASSWORD. После правки выполнитеphp artisan optimize.
Deploykin
Как это делается в Deploykin
В Deploykin сайт на Laravel создаётся из панели: стек под приложение, key:generate и storage:link выполняются при создании, а доступы к базе сами попадают в .env. Деплой идёт без простоя, с миграциями и кэшами, а очереди держат демоны Horizon или Queue Worker.
7 дней бесплатно на тарифе Про, без привязки карты.
Вопросы и ответы
Чем $request->validate() отличается от FormRequest?
$request->validate() держит правила прямо в контроллере и подходит для простых случаев. FormRequest выносит правила и авторизацию в отдельный класс app/Http/Requests, его удобнее переиспользовать и тестировать.
Почему API возвращает редирект вместо JSON с ошибками?
Laravel выбирает формат ответа по заголовку Accept. С Accept: application/json ошибка валидации приходит как 422 с массивом errors, без заголовка Laravel отвечает редиректом назад.
Где Laravel хранит сообщения об ошибках валидации?
В сессии для браузерных запросов и в объекте errors ответа для JSON. В Blade сообщения доступны через директиву @error и переменную $errors.
Нужно ли перезапускать PHP-FPM после правки правил валидации?
Нет, PHP-файлы подхватываются при следующем запросе. Перезапуск нужен только при opcache.validate_timestamps=0, тогда выполняют sudo systemctl reload php8.3-fpm.
Ещё по теме
- Руководство · Laravel PHP Laravel: пошаговая настройка проекта на Ubuntu 24.04 Создайте проект Laravel на PHP 8.3 в Ubuntu 24.04: Composer,.env, MySQL, миграции, nginx, кэш и проверка запуска. Команды и типичные ошибки.
- Руководство · Laravel Filament в Laravel: установка и настройка панели Установка Filament 5 в Laravel на Ubuntu 24.04: панель /admin, пользователь, ресурс Customer, доступ на сервере и проверка входа без ошибки 403.
- Руководство · Laravel Laravel Livewire: установка и первый компонент на Ubuntu 24.04 Установка Livewire 4 в Laravel на Ubuntu 24.04: создание компонента, вывод на страницу, настройка nginx для livewire.min.js и проверка работы в браузере.
- Руководство · Laravel Laravel API: пошаговая настройка на Ubuntu 24.04 Как поднять API в Laravel на Ubuntu 24.04: установка Sanctum, маршруты в routes/api.php, проверка через curl, ответы 401 и 404, кэш и деплой.
- Руководство · Laravel Laravel Eloquent: настройка и проверка на Ubuntu 24.04 Пошаговая настройка Eloquent в Laravel на Ubuntu 24.04: подключение MySQL, миграции, модели, связи, проверка через tinker и маршрут.
- Руководство · Laravel Laravel install: установка фреймворка на Ubuntu 24.04 Пошаговая установка Laravel на Ubuntu 24.04: проверка PHP 8.3, composer create-project, ключ приложения,.env, миграции и запуск через php artisan serve.
Laravel: руководство по установке и настройке: все материалы темы