Laravel Framework Reference Guide

Quick reference guide for the Laravel framework — query builder, Eloquent, controllers, and more.

These notes are written for anyone who's used Laravel before and needs a fast reminder of syntax, rather than a first introduction to the framework. Each topic below is a self-contained page with runnable code examples, organized by category so related concepts sit together. They lean on the official Laravel documentation for anything that needs the full detail, but cover enough on their own that you shouldn't need to leave the page for common tasks.

Why Laravel

Laravel is a PHP framework built around convention over configuration: routing, the ORM, validation, queues, caching, and authentication are all provided out of the box and designed to work together, so a new project gets a consistent structure without much upfront decision-making. That's the main appeal over assembling a stack from individual PHP libraries — less boilerplate and fewer integration decisions, at the cost of some flexibility if a project's needs fall outside what the framework expects.

Eloquent, Laravel's ActiveRecord-style ORM, is usually the biggest single reason developers pick it over a plain PHP or a leaner framework like Slim. Relationships, eager loading, query scopes, and model events cover most of what an application needs from its database layer without writing raw SQL, and the same fluency carries through to migrations, form validation, and the templating engine (Blade). The trade-off is a heavier framework with more moving parts than a minimal router-plus-database-layer setup, which matters for very small scripts but pays off quickly once an application grows past a handful of routes.

Starting a new project

composer create-project laravel/laravel PROJECTNAME
cd PROJECTNAME

Authentication scaffolding — pick one

Laravel Breeze — lightweight, modern, easiest to customize. Blade views only (no Vue/React), so the Node build tooling can be stripped out afterwards.

composer require laravel/breeze --dev
php artisan breeze:install blade
rm -rf node_modules package.json package-lock.json vite.config.js
php artisan migrate

Laravel UI + Bootstrap — older-style scaffolding, matches this project's own login/register modals.

composer require laravel/ui
php artisan ui bootstrap --auth

Further viewing

Fundamentals

The pieces every Laravel request passes through: a route matches the URL, middleware filters or inspects the request, a controller handles the logic, and Blade renders the response.

Routing

Defining routes, parameters, named routes, and route groups.

Controllers

Organizing route logic into controller classes, resource controllers, and route model binding.

Middleware

Filtering and inspecting HTTP requests before they reach a route or controller.

Blade Templating

Laravel's templating engine: directives, layouts, and components.

Data

Reading and writing data, from Eloquent's ORM down to raw query building and the migration syntax that defines a table's columns in the first place.

Query Builder

Laravel's fluent query builder for reading and writing data without raw SQL.

Eloquent

Laravel's ActiveRecord ORM: models, relationships, eager loading, and query scopes.

Database Field Types

A reference for migration column types and modifiers in the Schema builder.

Collections

A fluent, chainable wrapper around arrays that every Eloquent query returns.

Caching

Storing expensive-to-compute values so repeat requests are fast.

Validation & Security

Rejecting bad input before it reaches application logic, and controlling what an authenticated user is allowed to do once they're in.

Validation Rules

A reference for validating request data with rules, custom messages, and Form Requests.

Policies & Gates

Authorizing what a user can do, beyond simple route middleware.

Building an API

Setting up Sanctum, issuing API tokens, and building JSON API resource controllers.

Automation & Communication

Work that happens outside the request/response cycle: scheduled jobs, custom Artisan commands, and outbound email or notifications.

Scheduling

Laravel's task scheduler for running commands and closures on a recurring basis.

Artisan Commands

Laravel's command-line tool: built-in commands and writing your own.

Mail & Notifications

Sending email with Mailables, and multi-channel alerts with Notifications.