К содержимому

Валидация в Laravel: пошаговая настройка на Ubuntu 24.04

Валидация в Laravel выполняется методом $request->validate() или классом FormRequest, а ошибки Laravel сам возвращает в сессию или в JSON. Настройка сводится к правилам в запросе, выводу ошибок в шаблоне и проверке ответов для API. Все команды выполняются от владельца проекта в каталоге /var/www/example.com.

Руководство Laravel 3 мин чтения

01Проверьте окружение Laravel

Зайдите в каталог проекта и убедитесь, что Laravel отвечает и видит базу. Версию показывает php artisan --version, список маршрутов, php artisan route:list. Если проекта ещё нет, его создаёт composer create-project laravel/laravel example.com, а установка описана на отдельной странице.

bash
cd /var/www/example.com
php artisan --version
php artisan route:list

02Создайте FormRequest с правилами

Правила валидации удобно держать в отдельном классе запроса. Команда создаёт app/Http/Requests/StoreCustomerRequest.php, где метод authorize() возвращает true, а rules() перечисляет правила. Для формы заявки хватит имени, email и текста сообщения.

bash
php artisan make:request StoreCustomerRequest

03Опишите правила в методе rules

Верните из rules() массив правил: required и max:255 для имени, email и unique:customers,email для адреса, nullable и max:2000 для сообщения. Правило unique проверяет таблицу customers и сработает только при настроенном подключении к MySQL в .env.

php
<?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
<?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() возвращает введённое значение после неудачной проверки. Без вывода ошибок пользователь видит только повторную форму и не понимает, что не так.

php
<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.

bash
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 и список полей. Затем отправьте корректные данные и проверьте запись в базе. Для браузерной формы проверьте, что после ошибки видны сообщения и сохранённые значения полей.

bash
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, иначе сайт продолжит работать по старым настройкам.

bash
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: руководство по установке и настройке: все материалы темы

Мы используем cookies и сервис веб-аналитики «Яндекс Метрика» (включая Вебвизор) для улучшения работы сайта. Подробности — в политике конфиденциальности.