book

Laravel: Up & Running, 3rd Edition

Name: Laravel: Up & Running, 3rd Edition
Author: Matt Stauffer
ISBN: 9781098153267

by Matt Stauffer

September 2023

Beginner to intermediate

572 pages

12h 1m

English

O'Reilly Media, Inc.

Read now

Unlock full access

Preface
What This Book Is AboutWho This Book Is ForHow This Book Is StructuredAbout the Third EditionConventions Used in This BookO’Reilly Online LearningHow to Contact UsAcknowledgements
1. Why Laravel?
Why Use a Framework?“I’ll Just Build It Myself”Consistency and FlexibilityA Short History of Web and PHP FrameworksRuby on RailsThe Influx of PHP FrameworksThe Good and the Bad of CodeIgniterLaravel 1, 2, and 3Laravel 4Laravel 5Laravel 6Laravel Versions in the New SemVer World (6+)Laravel 11What’s So Special About Laravel?The Philosophy of LaravelHow Laravel Achieves Developer HappinessThe Laravel CommunityHow It WorksWhy Laravel?
2. Setting Up a Laravel Development Environment
System RequirementsComposerLocal Development EnvironmentsArtisan ServeLaravel SailLaravel ValetLaravel HerdLaravel HomesteadCreating a New Laravel ProjectInstalling Laravel with Composer’s create-project FeatureInstalling Laravel with the Laravel Installer ToolInstalling Laravel with SailLaravel’s Directory StructureThe FoldersThe Loose FilesConfigurationThe .env FileUp and RunningTestingTL;DR
3. Routing and Controllers
A Quick Introduction to MVC, the HTTP Verbs, and RESTWhat Is MVC?The HTTP VerbsWhat Is REST?Route DefinitionsRoute VerbsRoute HandlingRoute ParametersRoute NamesRoute GroupsMiddlewarePath PrefixesSubdomain RoutingName PrefixesRoute Group ControllersFallback RoutesSigned RoutesSigning a RouteModifying Routes to Allow Signed LinksViewsReturning Simple Routes Directly with Route::view()Using View Composers to Share Variables with Every ViewControllersGetting User InputInjecting Dependencies into ControllersResource ControllersAPI Resource ControllersSingle Action ControllersRoute Model BindingImplicit Route Model BindingCustom Route Model BindingRoute CachingForm Method SpoofingHTTP Verbs in LaravelHTTP Method Spoofing in HTML FormsCSRF ProtectionRedirectsredirect()->to()redirect()->route()redirect()->back()Other Redirect Methodsredirect()->with()Aborting the RequestCustom Responsesresponse()->make()response()->json() and ->jsonp()response()->download(), ->streamDownload(), and ->file()TestingTL;DR
4. Blade Templating
Echoing DataControl StructuresConditionalsLoopsTemplate InheritanceDefining Sections with @section/@show and @yieldIncluding View PartialsUsing ComponentsUsing StacksView Composers and Service InjectionBinding Data to Views Using View ComposersBlade Service InjectionCustom Blade DirectivesParameters in Custom Blade DirectivesExample: Using Custom Blade Directives for a Multitenant AppEasier Custom Directives for “if” StatementsTestingTL;DR
5. Databases and Eloquent
ConfigurationDatabase ConnectionsURL ConfigurationsOther Database Configuration OptionsMigrationsDefining MigrationsRunning MigrationsInspecting Your DatabaseSeedingCreating a SeederModel FactoriesQuery BuilderBasic Usage of the DB FacadeRaw SQLChaining with the Query BuilderTransactionsIntroduction to EloquentCreating and Defining Eloquent ModelsRetrieving Data with EloquentInserts and Updates with EloquentDeleting with EloquentScopesCustomizing Field Interactions with Accessors, Mutators, and Attribute CastingEloquent CollectionsEloquent SerializationEloquent RelationshipsEloquent EventsTestingTL;DR
6. Frontend Components
Laravel Starter KitsLaravel BreezeLaravel JetstreamLaravel’s Vite ConfigurationBundling Files with ViteThe Vite Dev ServerWorking with Static Assets and ViteWorking with JavaScript Frameworks and ViteUsing Environment Variables in VitePaginationPaginating Database ResultsManually Creating PaginatorsMessage BagsString Helpers, Number Helper, Pluralization, and LocalizationThe String Helpers and PluralizationThe Number HelperLocalizationTestingTesting Message and Error BagsTranslation and LocalizationDisabling Vite in TestingTL;DR
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 InputJSON Input (and $request->json())Route DataFrom RequestFrom Route ParametersUploaded FilesValidationvalidate() on the Request ObjectMore on Laravel’s Validation RulesManual ValidationUsing Validated DataCustom Rule ObjectsDisplaying Validation Error MessagesForm RequestsCreating a Form RequestUsing a Form RequestEloquent Model Mass Assignment{{ Versus {!!TestingTL;DR
8. Artisan and Tinker
An Introduction to ArtisanBasic Artisan CommandsOptionsThe Grouped CommandsWriting Custom Artisan CommandsA Sample CommandArguments and OptionsUsing InputPromptsOutputWriting Closure-Based CommandsCalling Artisan Commands in Normal CodeTinkerLaravel Dump ServerCustomizing Generator StubsTestingTL;DR
9. User Authentication and Authorization
The User Model and MigrationUsing the auth() Global Helper and the Auth Facaderoutes/auth.php, Auth Controllers, and Auth ActionsBreeze and Jetstream’s Frontend Templates“Remember Me”Password ConfirmationManually Authenticating UsersManually Logging Out a UserInvalidating Sessions on Other DevicesAuth MiddlewareEmail VerificationBlade Authentication DirectivesGuardsChanging the Default GuardUsing Other Guards Without Changing the DefaultAdding a New GuardClosure Request GuardsCreating a Custom User ProviderCustom User Providers for Nonrelational DatabasesAuth EventsAuthorization and RolesDefining Authorization RulesThe Gate Facade (and Injecting Gate)Resource GatesThe Authorize MiddlewareController AuthorizationChecking the User InstanceBlade ChecksIntercepting ChecksPoliciesTestingTL;DR

10. Requests, Responses, and Middleware
Laravel’s Request LifecycleBootstrapping the ApplicationService ProvidersThe Request ObjectGetting a Request Object in LaravelGetting Basic Information About a RequestThe Response ObjectUsing and Creating Response Objects in ControllersSpecialized Response TypesLaravel and MiddlewareAn Introduction to MiddlewareCreating Custom MiddlewareBinding MiddlewarePassing Parameters to MiddlewareDefault MiddlewareMaintenance ModeTrusted ProxiesCORSRate LimitingOther Default MiddlewareTestingTL;DR
11. The Container
A Quick Introduction to Dependency InjectionDependency Injection and LaravelThe app() Global HelperHow the Container Is WiredBinding Classes to the ContainerBinding to a ClosureBinding to Singletons, Aliases, and InstancesBinding a Concrete Instance to an InterfaceContextual BindingConstructor Injection in Laravel Framework FilesMethod InjectionFacades and the ContainerHow Facades WorkReal-Time FacadesService ProvidersTestingTL;DR
12. Testing
Testing BasicsNaming TestsThe Testing EnvironmentThe Testing TraitsRefreshDatabaseDatabaseMigrationsDatabaseTransactionsWithoutMiddlewareSimple Unit TestsApplication Testing: How It WorksHTTP TestsTesting Basic Pages with $this->get() and Other HTTP CallsTesting JSON APIs with $this->getJson() and Other JSON HTTP CallsAssertions Against $responseAuthenticating ResponsesA Few Other Customizations to Your HTTP TestsHandling Exceptions in Application TestsDebugging ResponsesDatabase TestsAsserting Against the DatabaseAsserting Against Eloquent ModelsUsing Model Factories in TestsSeeding in TestsTesting Other Laravel SystemsEvent FakesBus and Queue FakesMail FakesNotification FakesStorage FakesWorking with Time in TestsMockingA Quick Introduction to MockingA Quick Introduction to MockeryFaking Other FacadesTesting Artisan CommandsParallel TestingBrowser TestsChoosing a ToolTesting with DuskPestTL;DR
13. Writing APIs
The Basics of REST-Like JSON APIsController Organization and JSON ReturnsReading and Sending HeadersSending Response Headers in LaravelReading Request Headers in LaravelEloquent PaginationSorting and FilteringSorting Your API ResultsFiltering Your API ResultsTransforming ResultsAPI ResourcesCreating a Resource ClassResource CollectionsNesting RelationshipsUsing Pagination with API ResourcesConditionally Applying AttributesMore Customizations for API ResourcesAPI AuthenticationAPI Authentication with SanctumAPI Authentication with Laravel PassportCustomizing 404 ResponsesTriggering the Fallback RouteTestingTesting PassportTL;DR
14. Storage and Retrieval
Local and Cloud File ManagersConfiguring File AccessUsing the Storage FacadeAdding Additional Flysystem ProvidersBasic File Uploads and ManipulationSimple File DownloadsSessionsAccessing the SessionMethods Available on Session InstancesFlash Session StorageCacheAccessing the CacheMethods Available on Cache InstancesCookiesCookies in LaravelAccessing the Cookie ToolsContextAdding to and Reading from ContextHidden Context ItemsLoggingWhen and Why to Use LogsWriting to the LogsLog ChannelsWatching Logs with PailFiltering Log Messages with PailFull-Text Search with Laravel ScoutInstalling ScoutMarking Your Model for IndexingSearching Your IndexQueues and ScoutPerforming Operations Without IndexingConditionally Indexing ModelsManually Triggering Indexing via CodeManually Triggering Indexing via the CLIThe HTTP ClientUsing the HTTP FacadeHandling Errors and Timeouts and Checking StatusesTestingFile StorageSessionCacheCookiesLogScoutHTTP ClientTL;DR
15. Mail and Notifications
MailBasic “Mailable” Mail UsageMail TemplatesMethods Available in envelope()Attaching Files and Inlining ImagesMarkdown MailablesRendering Mailables to the BrowserQueuesLocal DevelopmentNotificationsDefining the via() Method for Your NotifiablesSending NotificationsQueueing NotificationsOut-of-the-Box Notification TypesTestingMailNotificationsTL;DR
16. Queues, Jobs, Events, Broadcasting, and the Scheduler
QueuesWhy Queues?Basic Queue ConfigurationQueued JobsRunning a Queue WorkerHandling ErrorsControlling the QueueQueues Supporting Other FunctionsLaravel HorizonEventsFiring an EventListening for an EventBroadcasting Events Over WebSockets, Laravel Reverb, and Laravel EchoConfiguration and SetupBroadcasting an EventWorking with WebSocket ServersLaravel Echo (the JavaScript Side)SchedulerAvailable Task TypesAvailable Time FramesViewing Your Scheduled Tasks with schedule:listDefining Time Zones for Scheduled CommandsBlocking and OverlapHandling Task OutputTask HooksRunning the Scheduler in Local DevelopmentTestingTL;DR
17. Helpers and Collections
HelpersArraysStringsApplication PathsURLsMiscellaneousCollectionsThe BasicsA Few Collection OperationsTL;DR
18. The Laravel Ecosystem
Tools Covered in This BookValetHomesteadHerdThe Laravel InstallerDuskPassportSailSanctumFortifyBreezeJetstreamHorizonEchoReverbPailTools Not Covered in This BookForgeVaporEnvoyerCloudCashierSocialiteNovaSparkEnvoyTelescopeOctanePennantFolioLivewireVoltPintPromptsPrecognitionPulseOther Resources
Glossary
Index
About the Author

Content preview from Laravel: Up & Running, 3rd Edition

Chapter 15. Mail and Notifications

Sending an application’s users notifications via email, Slack, SMS, or another notification system is a common but surprisingly complex requirement. Laravel’s mail and notification features provide consistent APIs that abstract away the need to pay too close attention to any particular provider. Just like in Chapter 14, you’ll write your code once and choose at the configuration level which provider you’ll use to send your email or notifications.

Mail

Laravel’s mail functionality is a convenience layer on top of Symfony Mailer. Out of the box, Laravel comes with drivers for SMTP, Mailgun, Postmark, Amazon SES, Sendmail, and Log.

For all of the cloud services, you’ll set your authentication information in config/services.php. However, if you take a look, you’ll see there are already keys there—and in config/mail.php—that allow you to customize your application’s mail functionality in .env using variables like MAIL_MAILER and MAILGUN_SECRET.

Cloud-Based API Driver Dependencies

If you’re using any of the cloud-based API drivers, you may need to bring in external dependencies to support them.

If you’re using Mailgun, you’ll want to bring in Symfony’s Mailgun Mailer and its HTTP client:

composer require symfony/mailgun-mailer \
    symfony/http-client

If you’re using Postmark, you’ll pull in Symfony’s Postmark Mailer and its HTTP client:

composer require symfony/postmark-mailer \
    symfony/http-client

And if you use the SES driver, you’ll want to pull ...

Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.

Read now

Unlock full access

More than 5,000 organizations count on O’Reilly

O’Reilly covers everything we've got, with content to help us build a world-class technology community, upgrade the capabilities and competencies of our teams, and improve overall team performance as well as their engagement.

Julian F.

Head of Cybersecurity

I wanted to learn C and C++, but it didn't click for me until I picked up an O'Reilly book. When I went on the O’Reilly platform, I was astonished to find all the books there, plus live events and sandboxes so you could play around with the technology.

Addison B.

Field Engineer

I’ve been on the O’Reilly platform for more than eight years. I use a couple of learning platforms, but I'm on O'Reilly more than anybody else. When you're there, you start learning. I'm never disappointed.

Amir M.

Data Platform Tech Lead

I'm always learning. So when I got on to O'Reilly, I was like a kid in a candy store. There are playlists. There are answers. There's on-demand training. It's worth its weight in gold, in terms of what it allows me to do.

Mark W.

Embedded Software Engineer

Publisher Resources

ISBN: 9781098153250Errata Page

Cloud Computing

Data Engineering

Data Science

AI & ML

Programming Languages

Software Architecture

IT/Ops

Security

Design

Business

Soft Skills

Laravel: Up & Running, 3rd Edition

by Matt Stauffer

Chapter 15. Mail and Notifications

Mail

Become an O’Reilly member and get unlimited access to this title plus top books and audiobooks from O’Reilly and nearly 200 top publishers, thousands of courses curated by job role, 150+ live events each month,
and much more.