К основному содержанию
скилл CX Codex

laravel-validation-patterns — скилл для Claude Code: установка

Скилл laravel-validation-patterns обучает ИИ-агента паттернам валидации в Laravel: от выноса логики в Form Request до фильтрации строк и условий Rule::when. Помогает избежать утечек $request->all().

MIT 105 установок ★ 48 обновлён 2026-04-19

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add iSerter/laravel-claude-agents --skill laravel-validation-patterns -a claude-code
Открыть на GitHub

Что делает laravel-validation-patterns

Скилл содержит свод правил валидации для Laravel-проектов. Он заставляет модель генерировать изолированные классы FormRequest вместо валидации прямо в контроллерах. Внутри описаны хуки prepareForValidation для очистки строк, метод after для бизнес-проверок и правила для вложенных массивов через звёздочку *.

Отдельное внимание уделено работе с базой данных и перечислениями. Скилл показывает, как изолировать уникальность с Rule::unique()->ignore() при апдейтах и как проверять значения через Rule::enum(). Прямая передача $request->all() в создание модели здесь под строгим запретом: код должен опираться только на $request->validated() или цепочку $request->safe().

Какие задачи решает

  • вынести логику валидации из контроллеров в отдельные классы FormRequest
  • настроить проверку вложенных массивов и динамических полей через Rule::when
  • защитить создание моделей от невалидированных данных из $request->all()
  • добавить проверку уникальности записей в базе с учётом текущего пользователя

Примеры запросов агенту

  • Сделай Form Request для оформления заказа с проверкой массива товаров и лимита
  • Напиши кастомное правило валидации пароля через ValidationRule
  • Проверь контроллер и перепиши создание модели на использование safe()

Как установить laravel-validation-patterns

1Через Skills CLI (Vercel)

npx skills add iSerter/laravel-claude-agents --skill laravel-validation-patterns -a claude-code

2Вручную: положить файлы

~/.claude/skills/laravel-validation-patterns/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/laravel-validation-patterns/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о laravel-validation-patterns

Как установить laravel-validation-patterns в Claude Code?

Выполните в терминале команду npx skills add iSerter/laravel-claude-agents --skill laravel-validation-patterns -a claude-code. Также можно вручную сохранить файл скилла по пути ~/.claude/skills/laravel-validation-patterns/SKILL.md.

Зачем нужен скилл laravel-validation-patterns?

Он задаёт агенту готовые примеры Form Request, пользовательских правил и условий. Агент перестаёт писать request->validate() прямо в методах контроллера.

Как скилл обрабатывает очистку данных перед проверкой?

В шаблонах используется метод prepareForValidation, где данные очищаются через $this->merge(). Это позволяет срезать теги или нормализовать регистр строк до запуска правил.

Исходный текст

SKILL.md · MIT
---
name: laravel-validation-patterns
description: Best practices for Laravel validation including Form Requests, custom rules, conditional validation, and input sanitization.
---

# Laravel Validation Patterns

## Form Request Classes (Standard Approach)

```php
<?php

namespace App\Http\Requests;

use Illuminate\Foundation\Http\FormRequest;
use Illuminate\Validation\Rule;

class StoreOrderRequest extends FormRequest
{
    public function authorize(): bool
    {
        return $this->user()->can('create', Order::class);
    }

    public function rules(): array
    {
        return [
            'customer_id' => ['required', 'exists:customers,id'],
            'items' => ['required', 'array', 'min:1'],
            'items.*.product_id' => ['required', 'exists:products,id'],
            'items.*.quantity' => ['required', 'integer', 'min:1'],
            'notes' => ['nullable', 'string', 'max:500'],
        ];
    }

    public function messages(): array
    {
        return [
            'items.required' => 'At least one item is required.',
            'items.*.product_id.exists' => 'Product #:position does not exist.',
        ];
    }

    protected function prepareForValidation(): void
    {
        $this->merge([
            'notes' => strip_tags($this->notes),
            'email' => strtolower($this->email),
        ]);
    }

    public function after(): array
    {
        return [
            function (\Illuminate\Validation\Validator $validator) {
                if ($this->hasExceededOrderLimit()) {
                    $validator->errors()->add('items', 'You have exceeded the daily order limit.');
                }
            },
        ];
    }
}
```

## Custom Rule Objects

```php
<?php

namespace App\Rules;

use Closure;
use Illuminate\Contracts\Validation\ValidationRule;

class StrongPassword implements ValidationRule
{
    public function validate(string $attribute, mixed $value, Closure $fail): void
    {
        if (! preg_match('/[A-Z]/', $value)) {
            $fail('The :attribute must contain at least one uppercase letter.');
        }

        if (! preg_match('/[0-9]/', $value)) {
            $fail('The :attribute must contain at least one number.');
        }
    }
}

// Usage in rules
'password' => ['required', 'string', 'min:8', new StrongPassword],
```

## Conditional Validation

```php
public function rules(): array
{
    return [
        'type' => ['required', Rule::in(['individual', 'company'])],

        // Required only when type is company
        'company_name' => ['required_if:type,company', 'string', 'max:255'],

        // Excluded when type is individual (not present in validated data)
        'tax_id' => ['exclude_if:type,individual', 'required', 'string'],

        // Dynamic conditional rule
        'billing_address' => [
            Rule::when($this->boolean('different_billing'), ['required', 'string']),
        ],

        // Conditional with sometimes (only validates if field is present)
        'coupon_code' => ['sometimes', 'string', 'exists:coupons,code'],
    ];
}
```

## Array and Nested Validation

```php
public function rules(): array
{
    return [
        'tags' => ['required', 'array', 'min:1', 'max:10'],
        'tags.*' => ['string', 'max:50'],

        'items' => ['required', 'array'],
        'items.*.name' => ['required', 'string'],
        'items.*.options' => ['sometimes', 'array'],
        'items.*.options.*.key' => ['required_with:items.*.options', 'string'],
    ];
}
```

## Database Rules

```php
public function rules(): array
{
    return [
        // Unique with ignore (for updates)
        'email' => [
            'required',
            'email',
            Rule::unique('users')->ignore($this->user()),
        ],

        // Unique with scoping
        'slug' => [
            'required',
            Rule::unique('posts')->where('tenant_id', $this->user()->tenant_id),
        ],

        // Exists with additional constraints
        'category_id' => [
            'required',
            Rule::exists('categories', 'id')->where('active', true),
        ],
    ];
}
```

## Enum Validation

```php
use App\Enums\OrderStatus;

public function rules(): array
{
    return [
        'status' => ['required', Rule::enum(OrderStatus::class)],

        // Only allow specific enum values
        'priority' => [
            'required',
            Rule::enum(Priority::class)->only([Priority::High, Priority::Critical]),
        ],
    ];
}
```

## Working with Validated Data

```php
// In controller
public function store(StoreOrderRequest $request)
{
    // ✅ Use validated data only
    $validated = $request->validated();

    // ✅ Use safe() for partial access
    $orderData = $request->safe()->only(['customer_id', 'notes']);
    $items = $request->safe()->except(['notes']);

    // ✅ Merge additional trusted data
    $order = Order::create(
        $request->safe()->merge(['user_id' => $request->user()->id])->all()
    );

    // ❌ Never use unvalidated input
    $order = Order::create($request->all());

    // ❌ Never bypass validation
    $order = Order::create($request->input());
}
```

## Common Pitfalls

```php
// ❌ Validating inline in controllers
public function store(Request $request)
{
    $request->validate(['title' => 'required']);
    // Hard to test, not reusable
}

// ✅ Use Form Request classes
public function store(StorePostRequest $request)
{
    Post::create($request->validated());
}

// ❌ Missing bail - continues validating after first failure
'email' => ['email', 'unique:users', 'dns_check'],

// ✅ Use bail to stop on first failure
'email' => ['bail', 'email', 'unique:users'],

// ❌ Using $request->all() instead of validated data
Order::create($request->all());

// ✅ Only validated and safe data
Order::create($request->validated());
```

## Checklist

- [ ] Validation logic lives in Form Request classes, not controllers
- [ ] authorize() method properly checks permissions
- [ ] Custom Rule objects used for reusable complex validation
- [ ] prepareForValidation() sanitizes input before validation
- [ ] after() used for cross-field or business logic validation
- [ ] Array and nested fields validated with wildcard notation
- [ ] Database rules use proper scoping and ignore patterns
- [ ] Only validated/safe data used when creating or updating models
- [ ] bail used where early termination is desired
- [ ] Custom error messages provided for user-facing fields

© iSerter · MIT · iSerter/laravel-claude-agents

Похожие скиллы

Все скиллы по теме «Бэкенд и API» →
laravel-patterns affaan-m Скилл laravel-patterns с паттернами архитектуры Laravel для Claude Code. Содержит примеры структуры проекта, контроллеров, сервисов, моделей Eloquent, роутинга, кэширования и API-ресурсов. CX Codex +1 6 900установок laravel-specialist VoltAgent Субагент laravel-specialist для задач по маршрутизации, Eloquent, очередям, валидации и архитектуре Laravel. Ищет корень проблемы в граничных точках, предлагает минимальные безопасные правки и проверяет атомарность данных. CX Codex ★ 6 505звёзд репо laravel-owasp-security AsyrafHussin Скилл laravel-owasp-security проверяет код Laravel 13 и React/Inertia.js на уязвимости OWASP Top 10 или служит инструкцией при разработке авторизации, платежей и API. CX Codex +1 1 100установок laravel-expert davila7 Скилл laravel-expert для Claude Code, который настраивает агента как Laravel-инженера: чистая архитектура, безопасность, производительность. Включается на задачах проектирования API, рефакторинга legacy-кода, оптимизации запросов и ревью. CX Codex +1 449установок hunt-laravel Sachin Sharma Скилл hunt-laravel проверяет Laravel-приложения на уязвимости: от открытых панелей Telescope и Horizon до ошибок в подписанных URL. Запускайте его при аудите проекта на Laravel. CX Codex +1 ★ 16 193звёзд репо laravel sanjeed5 Правило направляет Cursor при работе с PHP-кодом Laravel: помогает выносить логику из контроллеров и избегать типичных ошибок с запросами и безопасностью. CX Codex +1 ★ 3 589звёзд репо

Из того же набора5

Спонсоры проекта

Компании, которые помогают держать аналитику открытой