laravel-validation-patterns — скилл для Claude Code: установка
Скилл laravel-validation-patterns обучает ИИ-агента паттернам валидации в Laravel: от выноса логики в Form Request до фильтрации строк и условий Rule::when. Помогает избежать утечек $request->all().
MIT 105 установок ★ 48 обновлён 2026-04-19
npx skills add iSerter/laravel-claude-agents --skill laravel-validation-patterns -a claude-codeЧто делает 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-code2Вручную: положить файлы
~/.claude/skills/laravel-validation-patterns/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/laravel-validation-patterns/
1Через Skills CLI (Vercel)
npx skills add iSerter/laravel-claude-agents --skill laravel-validation-patterns -a codex2Вручную: положить файлы
.agents/skills/laravel-validation-patterns/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add iSerter/laravel-claude-agents --skill laravel-validation-patterns -a cursor2Вручную: положить файлы
.cursor/skills/laravel-validation-patterns/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install iSerter/laravel-claude-agents skills/laravel-validation-patterns2Вручную: положить файлы
.github/skills/laravel-validation-patterns/SKILL.md1Через Skills CLI (Vercel)
npx skills add iSerter/laravel-claude-agents --skill laravel-validation-patterns -a gemini-cli2Командой платформы
gemini skills install https://github.com/iSerter/laravel-claude-agents --path skills/laravel-validation-patternsВручную: положить файлы
.devin/skills/laravel-validation-patterns/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add iSerter/laravel-claude-agents --skill laravel-validation-patterns -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в 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