Custom Error Pages in Laravel

Wednesday, 22/09/2021

Tram Ho

Default in Laravel when we give error codes like 404, 401, 500… the system will process and give default error message pages which look very simple and not very nice Today I will show you how you how to customize these pages and this is very simple in version Laravel 8 Because it is a demo, I only create simple pages, the rest you guys can create as you like.

Create project

I will create a demo project using composer

composer create-project laravel/laravel example-app

1 2	composer create-project laravel/laravel example-app

Wait a moment the latest version of laravel 8 will be downloaded to your directory. Next start the project server:

cd example-app
php artisan serve

cd example-app

php artisan serve

And open the local url: http://127.0.0.1:8000/

Create erors page views

Next we will create views for the pages that will display the corresponding error in the directory resources/views/errors

404.blade.php:

@extends('errors.layouts')

@section('code', '401')
@section('title', __('Unauthorized'))

@section('image')
    &lt;div style="background-image: url({{ asset('/svg/403.svg') }});" class="absolute pin bg-cover bg-no-repeat md:bg-left lg:bg-center"&gt;
    &lt;/div&gt;
@endsection

@section('message', __('Sorry, you are not authorized to access this page.'))

@extends('errors.layouts')

@section('code', '401')

@section('title', __('Unauthorized'))

@section('image')

</div>

@endsection

@section('message', __('Sorry, you are not authorized to access this page.'))

401.blade.php:

@extends('errors.layouts')

@section('code', '404')
@section('title', __('Page Not Found'))

@section('image')
    &lt;div style="background-image: url({{ asset('/svg/404.svg') }});" class="absolute pin bg-cover bg-no-repeat md:bg-left lg:bg-center"&gt;
    &lt;/div&gt;
@endsection

@section('message', __('Sorry, the page you are looking for could not be found.'))

@extends('errors.layouts')

@section('code', '404')

@section('title', __('Page Not Found'))

@section('image')

</div>

@endsection

@section('message', __('Sorry, the page you are looking for could not be found.'))

500.blade.php:

@extends('errors.layouts')

@section('code', '500')
@section('title', __('Error'))

@section('image')
    &lt;div style="background-image: url({{ asset('/svg/500.svg') }});" class="absolute pin bg-cover bg-no-repeat md:bg-left lg:bg-center"&gt;
    &lt;/div&gt;
@endsection

@section('message', __('Whoops, something went wrong on our servers.'))

@extends('errors.layouts')

@section('code', '500')

@section('title', __('Error'))

@section('image')

</div>

@endsection

@section('message', __('Whoops, something went wrong on our servers.'))

Similarly for other error codes we also create corresponding views for it. Above we have extended errors.layouts so we will need to create one more layouts.blade file in resources/views/errors

layouts.blade.php:

&lt;!doctype html&gt;
&lt;html lang="en"&gt;
&lt;head&gt;
    &lt;title&gt;@yield('title')&lt;/title&gt;

    &lt;meta charset="utf-8"&gt;
    &lt;meta name="viewport" content="width=device-width, initial-scale=1, shrink-to-fit=no"&gt;

    &lt;!-- Fonts --&gt;
    &lt;link rel="dns-prefetch" href="//fonts.gstatic.com"&gt;
    &lt;link href="https://fonts.googleapis.com/css?family=Nunito" rel="stylesheet" type="text/css"&gt;

    &lt;!-- Styles --&gt;
    &lt;style&gt;
        html {
            line-height: 1.15;
            -ms-text-size-adjust: 100%;
            -webkit-text-size-adjust: 100%;
        }
        body {
            margin: 0;
        }
        header,
        nav,
        section {
            display: block;
        }
        figcaption,
        main {
            display: block;
        }
        a {
            background-color: transparent;
            -webkit-text-decoration-skip: objects;
        }
        strong {
            font-weight: inherit;
        }
        strong {
            font-weight: bolder;
        }
        code {
            font-family: monospace, monospace;
            font-size: 1em;
        }
        dfn {
            font-style: italic;
        }
        svg:not(:root) {
            overflow: hidden;
        }
        button,
        input {
            font-family: sans-serif;
            font-size: 100%;
            line-height: 1.15;
            margin: 0;
        }
        button,
        input {
            overflow: visible;
        }
        button {
            text-transform: none;
        }
        button,
        html [type="button"],
        [type="reset"],
        [type="submit"] {
            -webkit-appearance: button;
        }
        button::-moz-focus-inner,
        [type="button"]::-moz-focus-inner,
        [type="reset"]::-moz-focus-inner,
        [type="submit"]::-moz-focus-inner {
            border-style: none;
            padding: 0;
        }
        button:-moz-focusring,
        [type="button"]:-moz-focusring,
        [type="reset"]:-moz-focusring,
        [type="submit"]:-moz-focusring {
            outline: 1px dotted ButtonText;
        }
        legend {
            -webkit-box-sizing: border-box;
            box-sizing: border-box;
            color: inherit;
            display: table;
            max-width: 100%;
            padding: 0;
            white-space: normal;
        }
        [type="checkbox"],
        [type="radio"] {
            -webkit-box-sizing: border-box;
            box-sizing: border-box;
            padding: 0;
        }
        [type="number"]::-webkit-inner-spin-button,
        [type="number"]::-webkit-outer-spin-button {
            height: auto;
        }
        [type="search"] {
            -webkit-appearance: textfield;
            outline-offset: -2px;
        }
        [type="search"]::-webkit-search-cancel-button,
        [type="search"]::-webkit-search-decoration {
            -webkit-appearance: none;
        }
        ::-webkit-file-upload-button {
            -webkit-appearance: button;
            font: inherit;
        }
        menu {
            display: block;
        }
        canvas {
            display: inline-block;
        }
        template {
            display: none;
        }
        [hidden] {
            display: none;
        }
        html {
            -webkit-box-sizing: border-box;
            box-sizing: border-box;
            font-family: sans-serif;
        }
        *,
        *::before,
        *::after {
            -webkit-box-sizing: inherit;
            box-sizing: inherit;
        }
        p {
            margin: 0;
        }
        button {
            background: transparent;
            padding: 0;
        }
        button:focus {
            outline: 1px dotted;
            outline: 5px auto -webkit-focus-ring-color;
        }
        *,
        *::before,
        *::after {
            border-width: 0;
            border-style: solid;
            border-color: #dae1e7;
        }
        button,
        [type="button"],
        [type="reset"],
        [type="submit"] {
            border-radius: 0;
        }
        button,
        input {
            font-family: inherit;
        }
        input::-webkit-input-placeholder {
            color: inherit;
            opacity: .5;
        }
        input:-ms-input-placeholder {
            color: inherit;
            opacity: .5;
        }
        input::-ms-input-placeholder {
            color: inherit;
            opacity: .5;
        }
        input::placeholder {
            color: inherit;
            opacity: .5;
        }
        button,
        [role=button] {
            cursor: pointer;
        }
        .bg-transparent {
            background-color: transparent;
        }
        .bg-white {
            background-color: #fff;
        }
        .bg-teal-light {
            background-color: #64d5ca;
        }
        .bg-blue-dark {
            background-color: #2779bd;
        }
        .bg-indigo-light {
            background-color: #7886d7;
        }
        .bg-purple-light {
            background-color: #a779e9;
        }
        .bg-no-repeat {
            background-repeat: no-repeat;
        }
        .bg-cover {
            background-size: cover;
        }
        .border-grey-light {
            border-color: #dae1e7;
        }
        .hover\:border-grey:hover {
            border-color: #b8c2cc;
        }
        .rounded-lg {
            border-radius: .5rem;
        }
        .border-2 {
            border-width: 2px;
        }
        .hidden {
            display: none;
        }
        .flex {
            display: -webkit-box;
            display: -ms-flexbox;
            display: flex;
        }
        .items-center {
            -webkit-box-align: center;
            -ms-flex-align: center;
            align-items: center;
        }
        .justify-center {
            -webkit-box-pack: center;
            -ms-flex-pack: center;
            justify-content: center;
        }
        .font-sans {
            font-family: Nunito, sans-serif;
        }
        .font-light {
            font-weight: 300;
        }
        .font-bold {
            font-weight: 700;
        }
        .font-black {
            font-weight: 900;
        }
        .h-1 {
            height: .25rem;
        }
        .leading-normal {
            line-height: 1.5;
        }
        .m-8 {
            margin: 2rem;
        }
        .my-3 {
            margin-top: .75rem;
            margin-bottom: .75rem;
        }
        .mb-8 {
            margin-bottom: 2rem;
        }
        .max-w-sm {
            max-width: 30rem;
        }
        .min-h-screen {
            min-height: 100vh;
        }
        .py-3 {
            padding-top: .75rem;
            padding-bottom: .75rem;
        }
        .px-6 {
            padding-left: 1.5rem;
            padding-right: 1.5rem;
        }
        .pb-full {
            padding-bottom: 100%;
        }
        .absolute {
            position: absolute;
        }
        .relative {
            position: relative;
        }
        .pin {
            top: 0;
            right: 0;
            bottom: 0;
            left: 0;
        }
        .text-black {
            color: #22292f;
        }
        .text-grey-darkest {
            color: #3d4852;
        }
        .text-grey-darker {
            color: #606f7b;
        }
        .text-2xl {
            font-size: 1.5rem;
        }
        .text-5xl {
            font-size: 3rem;
        }
        .uppercase {
            text-transform: uppercase;
        }
        .antialiased {
            -webkit-font-smoothing: antialiased;
            -moz-osx-font-smoothing: grayscale;
        }
        .tracking-wide {
            letter-spacing: .05em;
        }
        .w-16 {
            width: 4rem;
        }
        .w-full {
            width: 100%;
        }
        @media (min-width: 768px) {
            .md\:bg-left {
                background-position: left;
            }
            .md\:bg-right {
                background-position: right;
            }
            .md\:flex {
                display: -webkit-box;
                display: -ms-flexbox;
                display: flex;
            }
            .md\:my-6 {
                margin-top: 1.5rem;
                margin-bottom: 1.5rem;
            }
            .md\:min-h-screen {
                min-height: 100vh;
            }
            .md\:pb-0 {
                padding-bottom: 0;
            }
            .md\:text-3xl {
                font-size: 1.875rem;
            }
            .md\:text-15xl {
                font-size: 9rem;
            }
            .md\:w-1\/2 {
                width: 50%;
            }
        }
        @media (min-width: 992px) {
            .lg\:bg-center {
                background-position: center;
            }
        }
    &lt;/style&gt;
&lt;/head&gt;
&lt;body class="antialiased font-sans"&gt;
&lt;div class="md:flex min-h-screen"&gt;
    &lt;div class="w-full md:w-1/2 bg-white flex items-center justify-center"&gt;
        &lt;div class="max-w-sm m-8"&gt;
            &lt;div class="text-black text-5xl md:text-15xl font-black"&gt;
                @yield('code', __('Oh no'))
            &lt;/div&gt;

            &lt;div class="w-16 h-1 bg-purple-light my-3 md:my-6"&gt;&lt;/div&gt;

            &lt;p class="text-grey-darker text-2xl md:text-3xl font-light mb-8 leading-normal"&gt;
                @yield('message')
            &lt;/p&gt;

            &lt;a href="{{ app('router')-&gt;has('home') ? route('home') : url('/') }}"&gt;
                &lt;button class="bg-transparent text-grey-darkest font-bold uppercase tracking-wide py-3 px-6 border-2 border-grey-light hover:border-grey rounded-lg"&gt;
                    {{ __('Go Home') }}
                &lt;/button&gt;
            &lt;/a&gt;
        &lt;/div&gt;
    &lt;/div&gt;

    &lt;div class="relative pb-full md:flex md:pb-0 md:min-h-screen w-full md:w-1/2"&gt;
        @yield('image')
    &lt;/div&gt;
&lt;/div&gt;
&lt;/body&gt;
&lt;/html&gt;

100

101

102

103

104

105

106

107

108

109

110

111

112

113

114

115

116

117

118

119

120

121

122

123

124

125

126

127

128

129

130

131

132

133

134

135

136

137

138

139

140

141

142

143

144

145

146

147

148

149

150

151

152

153

154

155

156

157

158

159

160

161

162

163

164

165

166

167

168

169

170

171

172

173

174

175

176

177

178

179

180

181

182

183

184

185

186

187

188

189

190

191

192

193

194

195

196

197

198

199

200

201

202

203

204

205

206

207

208

209

210

211

212

213

214

215

216

217

218

219

220

221

222

223

224

225

226

227

228

229

230

231

232

233

234

235

236

237

238

239

240

241

242

243

244

245

246

247

248

249

250

251

252

253

254

255

256

257

258

259

260

261

262

263

264

265

266

267

268

269

270

271

272

273

274

275

276

277

278

279

280

281

282

283

284

285

286

287

288

289

290

291

292

293

294

295

296

297

298

299

300

301

302

303

304

305

306

307

308

309

310

311

312

313

314

315

316

317

318

319

320

321

322

323

324

325

326

327

328

329

330

331

332

333

334

335

336

337

338

339

340

341

342

343

344

345

346

347

348

349

350

351

352

353

354

355

356

357

358

359

360

361

362

363

364

365

366

367

368

369

370

371

372

373

374

375

376

377

378

379

380

381

382

383

384

385

386

387

388

389

390

391

392

393

394

395

396

<!doctype html>

<head>

<title>@yield('title')</title>

<style>

html {

line-height: 1.15;

-ms-text-size-adjust: 100%;

-webkit-text-size-adjust: 100%;

}

body {

margin: 0;

}

header,

nav,

section {

display: block;

}

figcaption,

main {

display: block;

}

a {

background-color: transparent;

-webkit-text-decoration-skip: objects;

}

strong {

font-weight: inherit;

}

strong {

font-weight: bolder;

}

code {

font-family: monospace, monospace;

font-size: 1em;

}

dfn {

font-style: italic;

}

svg:not(:root) {

overflow: hidden;

}

button,

input {

font-family: sans-serif;

font-size: 100%;

line-height: 1.15;

margin: 0;

}

button,

input {

overflow: visible;

}

button {

text-transform: none;

}

button,

html [type="button"],

[type="reset"],

[type="submit"] {

-webkit-appearance: button;

}

button::-moz-focus-inner,

[type="button"]::-moz-focus-inner,

[type="reset"]::-moz-focus-inner,

[type="submit"]::-moz-focus-inner {

border-style: none;

padding: 0;

}

button:-moz-focusring,

[type="button"]:-moz-focusring,

[type="reset"]:-moz-focusring,

[type="submit"]:-moz-focusring {

outline: 1px dotted ButtonText;

}

legend {

-webkit-box-sizing: border-box;

box-sizing: border-box;

color: inherit;

display: table;

max-width: 100%;

padding: 0;

white-space: normal;

}

[type="checkbox"],

[type="radio"] {

-webkit-box-sizing: border-box;

box-sizing: border-box;

padding: 0;

}

[type="number"]::-webkit-inner-spin-button,

[type="number"]::-webkit-outer-spin-button {

height: auto;

}

[type="search"] {

-webkit-appearance: textfield;

outline-offset: -2px;

}

[type="search"]::-webkit-search-cancel-button,

[type="search"]::-webkit-search-decoration {

-webkit-appearance: none;

}

::-webkit-file-upload-button {

-webkit-appearance: button;

font: inherit;

}

menu {

display: block;

}

canvas {

display: inline-block;

}

template {

display: none;

}

[hidden] {

display: none;

}

html {

-webkit-box-sizing: border-box;

box-sizing: border-box;

font-family: sans-serif;

}

*::before,

*::after {

-webkit-box-sizing: inherit;

box-sizing: inherit;

}

p {

margin: 0;

}

button {

background: transparent;

padding: 0;

}

button:focus {

outline: 1px dotted;

outline: 5px auto -webkit-focus-ring-color;

}

*::before,

*::after {

border-width: 0;

border-style: solid;

border-color: #dae1e7;

}

button,

[type="button"],

[type="reset"],

[type="submit"] {

border-radius: 0;

}

button,

input {

font-family: inherit;

}

input::-webkit-input-placeholder {

color: inherit;

opacity: .5;

}

input:-ms-input-placeholder {

color: inherit;

opacity: .5;

}

input::-ms-input-placeholder {

color: inherit;

opacity: .5;

}

input::placeholder {

color: inherit;

opacity: .5;

}

button,

[role=button] {

cursor: pointer;

}

.bg-transparent {

background-color: transparent;

}

.bg-white {

background-color: #fff;

}

.bg-teal-light {

background-color: #64d5ca;

}

.bg-blue-dark {

background-color: #2779bd;

}

.bg-indigo-light {

background-color: #7886d7;

}

.bg-purple-light {

background-color: #a779e9;

}

.bg-no-repeat {

background-repeat: no-repeat;

}

.bg-cover {

background-size: cover;

}

.border-grey-light {

border-color: #dae1e7;

}

.hover\:border-grey:hover {

border-color: #b8c2cc;

}

.rounded-lg {

border-radius: .5rem;

}

.border-2 {

border-width: 2px;

}

.hidden {

display: none;

}

.flex {

display: -webkit-box;

display: -ms-flexbox;

display: flex;

}

.items-center {

-webkit-box-align: center;

-ms-flex-align: center;

align-items: center;

}

.justify-center {

-webkit-box-pack: center;

-ms-flex-pack: center;

justify-content: center;

}

.font-sans {

font-family: Nunito, sans-serif;

}

.font-light {

font-weight: 300;

}

.font-bold {

font-weight: 700;

}

.font-black {

font-weight: 900;

}

.h-1 {

height: .25rem;

}

.leading-normal {

line-height: 1.5;

}

.m-8 {

margin: 2rem;

}

.my-3 {

margin-top: .75rem;

margin-bottom: .75rem;

}

.mb-8 {

margin-bottom: 2rem;

}

.max-w-sm {

max-width: 30rem;

}

.min-h-screen {

min-height: 100vh;

}

.py-3 {

padding-top: .75rem;

padding-bottom: .75rem;

}

.px-6 {

padding-left: 1.5rem;

padding-right: 1.5rem;

}

.pb-full {

padding-bottom: 100%;

}

.absolute {

position: absolute;

}

.relative {

position: relative;

}

.pin {

top: 0;

right: 0;

bottom: 0;

left: 0;

}

.text-black {

color: #22292f;

}

.text-grey-darkest {

color: #3d4852;

}

.text-grey-darker {

color: #606f7b;

}

.text-2xl {

font-size: 1.5rem;

}

.text-5xl {

font-size: 3rem;

}

.uppercase {

text-transform: uppercase;

}

.antialiased {

-webkit-font-smoothing: antialiased;

-moz-osx-font-smoothing: grayscale;

}

.tracking-wide {

letter-spacing: .05em;

}

.w-16 {

width: 4rem;

}

.w-full {

width: 100%;

}

@media (min-width: 768px) {

.md\:bg-left {

background-position: left;

}

.md\:bg-right {

background-position: right;

}

.md\:flex {

display: -webkit-box;

display: -ms-flexbox;

display: flex;

}

.md\:my-6 {

margin-top: 1.5rem;

margin-bottom: 1.5rem;

}

.md\:min-h-screen {

min-height: 100vh;

}

.md\:pb-0 {

padding-bottom: 0;

}

.md\:text-3xl {

font-size: 1.875rem;

}

.md\:text-15xl {

font-size: 9rem;

}

.md\:w-1\/2 {

width: 50%;

}

@media (min-width: 992px) {

.lg\:bg-center {

background-position: center;

}

</style>

</head>

@yield('code', __('Oh no'))

</div>

@yield('message')

</p>

<a href="{{ app('router')->has('home') ? route('home') : url('/') }}">

</button>

</a>

</div>

@yield('image')

</div>

</body>

</html>

Check it out Finally to see these views let’s try to edit the routes/web.php file as follows: You can include these error pages in the project depending on each specific router or each specific case, here I put the page right in the home page to test it

&lt;?php

use Illuminate\Support\Facades\Route;

/*
|--------------------------------------------------------------------------
| Web Routes
|--------------------------------------------------------------------------
|
| Here is where you can register web routes for your application. These
| routes are loaded by the RouteServiceProvider within a group which
| contains the "web" middleware group. Now create something great!
|
*/

Route::get('/', function () {
    abort(404);
});

<?php

use Illuminate\Support\Facades\Route;

|--------------------------------------------------------------------------

| Web Routes

|--------------------------------------------------------------------------

| Here is where you can register web routes for your application. These

| routes are loaded by the RouteServiceProvider within a group which

| contains the "web" middleware group. Now create something great!

Route::get('/', function () {

abort(404);

});

and as a result we will get a more vivid error message page

Similar to check other error pages abort(401);, abort(500);… Thanks for watching.

References at : https://welcm.uk/blog/custom-error-pages-in-laravel

Share the news now

Custom Error Pages in Laravel

Create project

Create erors page views

TikTok becomes the second largest social platform in South Africa

The fastest depreciating after 9 months of launch, iPhone 14 Pro Max continues to break the bottom in Vietnam

Beginner's guide to R: Introduction

10 essential SublimeText plugins for JavaScript developers