Built-in validation rules such as required, email, or max are not enough for most real-word applications. Your requirements might need custom business logic such as checking if a username contains a certain word, or if a user has a specific role.<\/p>\n\n\n\n
Laravel gives you three main ways to define custom validation:<\/p>\n\n\n\n
This is the simplest way to define a custom rule using a closure (anonymous function) directly in your validation array.<\/p>\n\n\n\n
Example: Disallow usernames containing \u201cadmin\u201d When to use: Small, one-time rules specific to a form.<\/p>\n\n\n\n Use Laravel\u2019s artisan command to create a custom rule class.<\/p>\n\n\n\n Bash:<\/p>\n\n\n\n PHP:<\/p>\n\n\n\n PHP:<\/strong><\/p>\n\n\n\n When to use: When the rule will be reused across different forms or logic is too complex for closures.<\/p>\n\n\n\n You can register your own validation rule globally using Laravel\u2019s Validator::extend<\/em> method (typically in a service provider).<\/p>\n\n\n\n PHP<\/strong>:<\/p>\n\n\n\n PHP<\/strong>:<\/p>\n\n\n\n Optional: Custom message<\/strong><\/p>\n\n\n\n PHP:<\/p>\n\n\n\n When to use<\/strong>: When you want clean, named rules you can apply like built-in rules.<\/p>\n\n\n\n You can customize error messages like this:<\/p>\n\n\n\n PHP:<\/p>\n\n\n\n This helps you keep messages user-friendly and in plain language.<\/p>\n\n\n\n Custom Rule Class<\/strong><\/p>\n\n\n\n Bash:<\/strong><\/p>\n\n\n\n Rule Logic<\/strong><\/p>\n\n\n\n PHP:<\/p>\n\n\n\n Usage<\/strong><\/p>\n\n\n\n PHP:<\/p>\n\n\n\n Built-in validation rules such as required, email, or max are not enough for most real-word applications. Your requirements might need custom business logic such as checking if a username contains a certain word, or if a user has a specific role. Laravel gives you three main ways to define custom validation: Closure-Based Custom Rules (Inline […]<\/p>\n","protected":false},"author":2,"featured_media":1019,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[13,3],"tags":[],"class_list":["post-853","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-laravel","category-web"],"acf":[],"_links":{"self":[{"href":"https:\/\/www.cmarix.com\/qanda\/wp-json\/wp\/v2\/posts\/853","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.cmarix.com\/qanda\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.cmarix.com\/qanda\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.cmarix.com\/qanda\/wp-json\/wp\/v2\/users\/2"}],"replies":[{"embeddable":true,"href":"https:\/\/www.cmarix.com\/qanda\/wp-json\/wp\/v2\/comments?post=853"}],"version-history":[{"count":11,"href":"https:\/\/www.cmarix.com\/qanda\/wp-json\/wp\/v2\/posts\/853\/revisions"}],"predecessor-version":[{"id":918,"href":"https:\/\/www.cmarix.com\/qanda\/wp-json\/wp\/v2\/posts\/853\/revisions\/918"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/www.cmarix.com\/qanda\/wp-json\/wp\/v2\/media\/1019"}],"wp:attachment":[{"href":"https:\/\/www.cmarix.com\/qanda\/wp-json\/wp\/v2\/media?parent=853"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.cmarix.com\/qanda\/wp-json\/wp\/v2\/categories?post=853"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.cmarix.com\/qanda\/wp-json\/wp\/v2\/tags?post=853"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}
PHP:<\/strong><\/p>\n\n\n\n$request->validate([\n 'username' => [\n 'required',\n function ($attribute, $value, $fail) {\n if (stripos($value, 'admin') !== false) {\n $fail('The username cannot contain the word \"admin\".');\n }\n },\n ],\n]);<\/code><\/pre>\n\n\n\nCustom Rule Class (Reusable Rules)<\/h2>\n\n\n\n
Step 1: Create the rule<\/h3>\n\n\n\n
php artisan make:rule Uppercase<\/code><\/pre>\n\n\n\nStep 2: Define logic in the rule class<\/h3>\n\n\n\n
\/\/ app\/Rules\/Uppercase.php\nnamespace App\\Rules;\nuse Illuminate\\Contracts\\Validation\\Rule;\nclass Uppercase implements Rule\n{\n public function passes($attribute, $value)\n {\n return strtoupper($value) === $value;\n }\n public function message()\n {\n return 'The :attribute must be in uppercase.';\n }\n}<\/code><\/pre>\n\n\n\nStep 3: Use the rule in a controller<\/h3>\n\n\n\n
use App\\Rules\\Uppercase;\n$request->validate([\n 'title' => ['required', new Uppercase],\n]);<\/code><\/pre>\n\n\n\nExtending the Validator (Custom Rule Name)<\/h2>\n\n\n\n
Step 1: Extend Validator<\/h3>\n\n\n\n
use Illuminate\\Support\\Facades\\Validator;\npublic function boot()\n{\n Validator::extend('foo', function ($attribute, $value, $parameters, $validator) {\n return $value === 'foo';\n });\n}<\/code><\/pre>\n\n\n\nStep 2: Use the new rule name<\/h3>\n\n\n\n
$request->validate([\n 'code' => 'required|foo',\n]);<\/code><\/pre>\n\n\n\n\/\/ resources\/lang\/en\/validation.php\n'foo' => 'The :attribute must be \"foo\".',<\/code><\/pre>\n\n\n\nCustomizing Error Messages (All Methods)<\/h2>\n\n\n\n
$request->validate([\n 'username' => 'required|min:5',\n], [\n 'username.required' => 'Please enter your username.',\n 'username.min' => 'Your username must be at least :min characters long.',\n]);<\/code><\/pre>\n\n\n\nExample Use Case: Validating Age Must Be Over 18<\/h3>\n\n\n\n
php artisan make:rule AgeOver18<\/code><\/pre>\n\n\n\npublic function passes($attribute, $value)\n{\n return Carbon\\Carbon::parse($value)->age >= 18;\n}\npublic function message()\n{\n return 'You must be at least 18 years old.';\n}<\/code><\/pre>\n\n\n\n$request->validate([\n 'dob' => ['required', 'date', new AgeOver18],\n]);<\/code><\/pre>\n\n\n\nSummary Table<\/h3>\n\n\n\n
Method<\/strong><\/td> Use When<\/strong><\/td> Reusability<\/strong><\/td> Complexity<\/strong><\/td><\/tr> Closure-based<\/strong><\/td> Quick one-off logic<\/td> No<\/td> Simple<\/td><\/tr> Custom Rule Class<\/strong><\/td> Rule used in multiple places<\/td> Yes<\/td> Medium<\/td><\/tr> Validator Extension<\/strong><\/td> Want named rules<\/td> Yes<\/td> Advanced<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n Pro Tips<\/h3>\n\n\n\n
\n