Laravel: Up & Running: A Framework for Building Modern PHP Apps

Cover
Copyright
Table of Contents
Preface
	What This Book Is About
	Who This Book Is For
	How This Book Is Structured
	About the Third Edition
	Conventions Used in This Book
	O’Reilly Online Learning
	How to Contact Us
	Acknowledgements
Chapter 1. Why Laravel?
	Why Use a Framework?
		“I’ll Just Build It Myself”
		Consistency and Flexibility
	A Short History of Web and PHP Frameworks
		Ruby on Rails
		The Influx of PHP Frameworks
		The Good and the Bad of CodeIgniter
		Laravel 1, 2, and 3
		Laravel 4
		Laravel 5
		Laravel 6
		Laravel Versions in the New SemVer World (6+)
	What’s So Special About Laravel?
		The Philosophy of Laravel
		How Laravel Achieves Developer Happiness
		The Laravel Community
	How It Works
	Why Laravel?
Chapter 2. Setting Up a Laravel Development Environment
	System Requirements
	Composer
	Local Development Environments
		Artisan Serve
		Laravel Sail
		Laravel Valet
		Laravel Herd
		Laravel Homestead
	Creating a New Laravel Project
		Installing Laravel with the Laravel Installer Tool
		Installing Laravel with Composer’s create-project Feature
		Installing Laravel with Sail
	Laravel’s Directory Structure
		The Folders
		The Loose Files
	Configuration
		The .env File
	Up and Running
	Testing
	TL;DR
Chapter 3. Routing and Controllers
	A Quick Introduction to MVC, the HTTP Verbs, and REST
		What Is MVC?
		The HTTP Verbs
		What Is REST?
	Route Definitions
		Route Verbs
		Route Handling
		Route Parameters
		Route Names
	Route Groups
		Middleware
		Path Prefixes
		Subdomain Routing
		Name Prefixes
		Route Group Controllers
		Fallback Routes
	Signed Routes
		Signing a Route
		Modifying Routes to Allow Signed Links
	Views
		Returning Simple Routes Directly with Route::view()
		Using View Composers to Share Variables with Every View
	Controllers
		Getting User Input
		Injecting Dependencies into Controllers
		Resource Controllers
		API Resource Controllers
		Single Action Controllers
	Route Model Binding
		Implicit Route Model Binding
		Custom Route Model Binding
	Route Caching
	Form Method Spoofing
		HTTP Verbs in Laravel
		HTTP Method Spoofing in HTML Forms
	CSRF Protection
	Redirects
		redirect()->to()
		redirect()->route()
		redirect()->back()
		Other Redirect Methods
		redirect()->with()
	Aborting the Request
	Custom Responses
		response()->make()
		response()->json() and ->jsonp()
		response()->download(), ->streamDownload(), and ->file()
	Testing
	TL;DR
Chapter 4. Blade Templating
	Echoing Data
	Control Structures
		Conditionals
		Loops
	Template Inheritance
		Defining Sections with @section/@show and @yield
		Including View Partials
		Using Components
		Using Stacks
	View Composers and Service Injection
		Binding Data to Views Using View Composers
		Blade Service Injection
	Custom Blade Directives
		Parameters in Custom Blade Directives
		Example: Using Custom Blade Directives for a Multitenant App
		Easier Custom Directives for “if” Statements
	Testing
	TL;DR
Chapter 5. Databases and Eloquent
	Configuration
		Database Connections
		URL Configurations
		Other Database Configuration Options
	Migrations
		Defining Migrations
		Running Migrations
	Inspecting Your Database
	Seeding
		Creating a Seeder
		Model Factories
	Query Builder
		Basic Usage of the DB Facade
		Raw SQL
		Chaining with the Query Builder
		Transactions
	Introduction to Eloquent
		Creating and Defining Eloquent Models
		Retrieving Data with Eloquent
		Inserts and Updates with Eloquent
		Deleting with Eloquent
		Scopes
		Customizing Field Interactions with Accessors, Mutators, and Attribute Casting
		Eloquent Collections
		Eloquent Serialization
		Eloquent Relationships
	Eloquent Events
	Testing
	TL;DR
Chapter 6. Frontend Components
	Laravel Starter Kits
		Laravel Breeze
		Laravel Jetstream
	Laravel’s Vite Configuration
		Bundling Files with Vite
		The Vite Dev Server
		Working with Static Assets and Vite
		Working with JavaScript Frameworks and Vite
		Using Environment Variables in Vite
	Pagination
		Paginating Database Results
		Manually Creating Paginators
	Message Bags
	String Helpers, Pluralization, and Localization
		The String Helpers and Pluralization
		Localization
	Testing
		Testing Message and Error Bags
		Translation and Localization
		Disabling Vite in Testing
	TL;DR
Chapter 7. Collecting and Handling User Data
	Injecting a Request Object
		$request->all()
		$request->except() and ->only()
		$request->has() and ->missing()
		$request->whenHas()
		$request->filled()
		$request->whenFilled()
		$request->mergeIfMissing()
		$request->input()
		$request->method() and ->isMethod()
		$request->integer(), ->float(), ->string(), and ->enum()
		$request->dump() and ->dd()
		Array Input
		JSON Input (and $request->json())
	Route Data
		From Request
		From Route Parameters
	Uploaded Files
	Validation
		validate() on the Request Object
		More on Laravel’s Validation Rules
		Manual Validation
		Using Validated Data
		Custom Rule Objects
		Displaying Validation Error Messages
	Form Requests
		Creating a Form Request
		Using a Form Request
	Eloquent Model Mass Assignment
	{{ Versus {!!
	Testing
	TL;DR
Chapter 8. Artisan and Tinker
	An Introduction to Artisan
	Basic Artisan Commands
		Options
		The Grouped Commands
	Writing Custom Artisan Commands
		A Sample Command
		Arguments and Options
		Using Input
		Prompts
		Output
		Writing Closure-Based Commands
	Calling Artisan Commands in Normal Code
	Tinker
	Laravel Dump Server
	Customizing Generator Stubs
	Testing
	TL;DR
Chapter 9. User Authentication and Authorization
	The User Model and Migration
	Using the auth() Global Helper and the Auth Facade
	routes/auth.php, Auth Controllers, and Auth Actions
	Breeze and Jetstream’s Frontend Templates
	“Remember Me”
	Password Confirmation
	Manually Authenticating Users
	Manually Logging Out a User
		Invalidating Sessions on Other Devices
	Auth Middleware
	Email Verification
	Blade Authentication Directives
	Guards
		Changing the Default Guard
		Using Other Guards Without Changing the Default
		Adding a New Guard
		Closure Request Guards
		Creating a Custom User Provider
		Custom User Providers for Nonrelational Databases
	Auth Events
	Authorization and Roles
		Defining Authorization Rules
		The Gate Facade (and Injecting Gate)
		Resource Gates
		The Authorize Middleware
		Controller Authorization
		Checking the User Instance
		Blade Checks
		Intercepting Checks
		Policies
	Testing
	TL;DR
Chapter 10. Requests, Responses, and Middleware
	Laravel’s Request Lifecycle
		Bootstrapping the Application
		Service Providers
	The Request Object
		Getting a Request Object in Laravel
		Getting Basic Information About a Request
	The Response Object
		Using and Creating Response Objects in Controllers
		Specialized Response Types
	Laravel and Middleware
		An Introduction to Middleware
		Creating Custom Middleware
		Binding Middleware
		Passing Parameters to Middleware
	Default Middleware
		Maintenance Mode
		Rate Limiting
		Trusted Proxies
		CORS
	Testing
	TL;DR
Chapter 11. The Container
	A Quick Introduction to Dependency Injection
	Dependency Injection and Laravel
	The app() Global Helper
	How the Container Is Wired
	Binding Classes to the Container
		Binding to a Closure
		Binding to Singletons, Aliases, and Instances
		Binding a Concrete Instance to an Interface
		Contextual Binding
	Constructor Injection in Laravel Framework Files
	Method Injection
	Facades and the Container
		How Facades Work
		Real-Time Facades
	Service Providers
	Testing
	TL;DR
Chapter 12. Testing
	Testing Basics
	Naming Tests
	The Testing Environment
	The Testing Traits
		RefreshDatabase
		DatabaseMigrations
		DatabaseTransactions
		WithoutMiddleware
	Simple Unit Tests
	Application Testing: How It Works
	HTTP Tests
		Testing Basic Pages with $this->get() and Other HTTP Calls
		Testing JSON APIs with $this->getJson() and Other JSON HTTP Calls
		Assertions Against $response
		Authenticating Responses
		A Few Other Customizations to Your HTTP Tests
		Handling Exceptions in Application Tests
		Debugging Responses
	Database Tests
		Asserting Against the Database
		Asserting Against Eloquent Models
		Using Model Factories in Tests
		Seeding in Tests
	Testing Other Laravel Systems
		Event Fakes
		Bus and Queue Fakes
		Mail Fakes
		Notification Fakes
		Storage Fakes
	Working with Time in Tests
	Mocking
		A Quick Introduction to Mocking
		A Quick Introduction to Mockery
		Faking Other Facades
	Testing Artisan Commands
	Parallel Testing
	Browser Tests
		Choosing a Tool
		Testing with Dusk
	Pest
	TL;DR
Chapter 13. Writing APIs
	The Basics of REST-Like JSON APIs
	Controller Organization and JSON Returns
	Reading and Sending Headers
		Sending Response Headers in Laravel
		Reading Request Headers in Laravel
	Eloquent Pagination
	Sorting and Filtering
		Sorting Your API Results
		Filtering Your API Results
	Transforming Results
	API Resources
		Creating a Resource Class
		Resource Collections
		Nesting Relationships
		Using Pagination with API Resources
		Conditionally Applying Attributes
		More Customizations for API Resources
	API Authentication
		API Authentication with Sanctum
		API Authentication with Laravel Passport
	Customizing 404 Responses
		Triggering the Fallback Route
	Testing
		Testing Passport
	TL;DR
Chapter 14. Storage and Retrieval
	Local and Cloud File Managers
		Configuring File Access
		Using the Storage Facade
		Adding Additional Flysystem Providers
	Basic File Uploads and Manipulation
	Simple File Downloads
	Sessions
		Accessing the Session
		Methods Available on Session Instances
		Flash Session Storage
	Cache
		Accessing the Cache
		Methods Available on Cache Instances
	Cookies
		Cookies in Laravel
		Accessing the Cookie Tools
	Logging
		When and Why to Use Logs
		Writing to the Logs
		Log Channels
	Full-Text Search with Laravel Scout
		Installing Scout
		Marking Your Model for Indexing
		Searching Your Index
		Queues and Scout
		Performing Operations Without Indexing
		Conditionally Indexing Models
		Manually Triggering Indexing via Code
		Manually Triggering Indexing via the CLI
	The HTTP Client
		Using the HTTP Facade
		Handling Errors and Timeouts and Checking Statuses
	Testing
		File Storage
		Session
		Cache
		Cookies
		Log
		Scout
		HTTP Client
	TL;DR
Chapter 15. Mail and Notifications
	Mail
		Basic “Mailable” Mail Usage
		Mail Templates
		Methods Available in envelope()
		Attaching Files and Inlining Images
		Markdown Mailables
		Rendering Mailables to the Browser
		Queues
		Local Development
	Notifications
		Defining the via() Method for Your Notifiables
		Sending Notifications
		Queueing Notifications
		Out-of-the-Box Notification Types
	Testing
		Mail
		Notifications
	TL;DR
Chapter 16. Queues, Jobs, Events, Broadcasting, and the Scheduler
	Queues
		Why Queues?
		Basic Queue Configuration
		Queued Jobs
		Running a Queue Worker
		Handling Errors
		Controlling the Queue
		Queues Supporting Other Functions
	Laravel Horizon
	Events
		Firing an Event
		Listening for an Event
	Broadcasting Events Over WebSockets, and Laravel Echo
		Configuration and Setup
		Broadcasting an Event
		Receiving the Message
		Advanced Broadcasting Tools
		Laravel Echo (the JavaScript Side)
	Scheduler
		Available Task Types
		Available Time Frames
		Defining Time Zones for Scheduled Commands
		Blocking and Overlap
		Handling Task Output
		Task Hooks
		Running the Scheduler in Local Development
	Testing
	TL;DR
Chapter 17. Helpers and Collections
	Helpers
		Arrays
		Strings
		Application Paths
		URLs
		Miscellaneous
	Collections
		The Basics
		A Few Collection Operations
	TL;DR
Chapter 18. The Laravel Ecosystem
	Tools Covered in This Book
		Valet
		Homestead
		Herd
		The Laravel Installer
		Dusk
		Passport
		Sail
		Sanctum
		Fortify
		Breeze
		Jetstream
		Horizon
		Echo
	Tools Not Covered in This Book
		Forge
		Vapor
		Envoyer
		Cashier
		Socialite
		Nova
		Spark
		Envoy
		Telescope
		Octane
		Pennant
		Folio
		Volt
		Pint
	Other Resources
Glossary
Index
About the Author
Colophon