Laravel Conventions

Use this when writing or changing Laravel application code.

Defaults

• Inspect existing routes, models, config, tests, and installed Laravel version before choosing a pattern; match established project conventions where they are sound.
• Eloquent over raw SQL unless the query is too complex for the ORM.
• Form Request classes for all validation; never inline validate in controllers.
• config('key') instead of env('KEY') outside config files.
• Queue jobs (ShouldQueue) for anything slow, external, or async.
• Keep controllers thin; introduce service classes only when the project's existing structure or real complexity warrants them.
• Use named routes and route helpers for application links and redirects.
• Check the installed Laravel major version before applying framework structure or API guidance; Laravel 10, 11, and 12 are not interchangeable.

Models