> For the complete documentation index, see [llms.txt](https://learn.devlabss.my.id/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://learn.devlabss.my.id/laravel/bab-9-autentikasi-and-middleware/9.2-instalasi-login-dengan-laravel-breeze.md).

# 9.2 Instalasi Login dengan Laravel Breeze

## Instalasi login dengan Laravel Breeze

Setelah memahami session dan middleware, sekarang kita masuk ke praktik instalasi login.

Di Laravel, cara paling aman dan cepat untuk memulai autentikasi dasar adalah memakai **Laravel Breeze**.

Breeze memberi kita fondasi login yang sudah rapi.

Jadi kita tidak perlu membangun semuanya dari nol.

### Teori awal dan analogi

Bayangkan sekolah ingin membuat sistem kartu akses.

Daripada membuat mesin kartu dari nol, sekolah memakai perangkat yang sudah jadi lalu menyesuaikannya.

Laravel Breeze bekerja mirip seperti itu.

Ia memberi kita paket login dasar yang siap dipakai.

Lalu kita tinggal menyesuaikannya dengan proyek E-Library.

### Apa yang disiapkan Breeze

Secara umum, Breeze akan membantu menyiapkan:

* halaman login
* halaman register
* logika autentikasi dasar
* route yang diperlukan
* middleware yang terkait dengan pengguna login

Untuk tahap awal, ini sudah sangat cukup.

### Target praktik subbab ini

Setelah menyelesaikan subbab ini, Anda seharusnya bisa:

* memasang Laravel Breeze
* menjalankan instalasi autentikasi dasar
* menyiapkan database pengguna
* membuka halaman login di browser
* memastikan akun bisa dipakai untuk masuk

### Langkah praktik step-by-step

Ikuti langkah berikut dengan urut.

{% stepper %}
{% step %}

### Pastikan Node.js dan npm siap dipakai

Laravel Breeze membutuhkan proses build aset front-end.

Karena itu, pastikan Node.js dan npm sudah terpasang di komputer Anda.

Kalau perintah `npm` tidak dikenali, instalasi Breeze belum bisa dilanjutkan dengan lancar.
{% endstep %}

{% step %}

### Pasang paket Breeze

Buka terminal proyek Laravel.

Lalu jalankan perintah berikut:

```bash
composer require laravel/breeze --dev
```

Perintah ini akan memasang paket Breeze ke proyek Anda.
{% endstep %}

{% step %}

### Jalankan instalasi Breeze

Setelah itu, jalankan:

```bash
php artisan breeze:install blade
```

Di modul ini kita memakai tampilan Blade agar tetap sejalur dengan materi sebelumnya.
{% endstep %}

{% step %}

### Jalankan migration

Setelah Breeze terpasang, jalankan:

```bash
php artisan migrate
```

Perintah ini penting karena autentikasi butuh tabel `users` dan tabel pendukung lainnya.
{% endstep %}

{% step %}

### Instal dependensi front-end

Lanjutkan dengan dua perintah ini:

```bash
npm install
```

dan:

```bash
npm run dev
```

Perintah ini akan menyiapkan aset tampilan Breeze agar halaman login bisa tampil dengan benar.
{% endstep %}

{% step %}

### Jalankan server lalu uji di browser

Sebelum mengetes, pastikan server Laravel hidup.

Silakan pilih salah satu:

* buka **Laragon** lalu klik **Start All**
* atau jalankan `php artisan serve`

Kalau `npm run dev` tadi dijalankan di terminal lain, biarkan tetap aktif.

Setelah itu, buka:

```
http://127.0.0.1:8000/login
```

Kalau berhasil, Anda akan melihat halaman login.
{% endstep %}

{% step %}

### Buat akun lalu coba login

Untuk pengujian awal, buka juga halaman:

```
http://127.0.0.1:8000/register
```

Buat satu akun baru.

Setelah akun berhasil dibuat, coba login memakai akun tersebut.
{% endstep %}
{% endstepper %}

### Penjelasan pasca-praktik

Sekarang mari kita bedah bagian yang paling penting.

#### 1. `composer require laravel/breeze --dev`

Perintah ini memasang paket Breeze ke proyek Laravel Anda.

Status `--dev` berarti paket ini dipakai untuk kebutuhan pengembangan proyek.

#### 2. `php artisan breeze:install blade`

Perintah ini membuat file dan route autentikasi dasar dengan tampilan Blade.

Karena modul ini memang memakai Blade, pilihan ini paling cocok.

#### 3. `php artisan migrate`

Setelah Breeze dipasang, tabel pengguna perlu benar-benar dibuat di database.

Kalau migration tidak dijalankan, sistem login tidak punya tempat menyimpan akun.

#### 4. `npm install` dan `npm run dev`

Breeze memakai aset front-end yang perlu dibangun lebih dulu.

Karena itu, dua perintah ini sangat penting agar tampilan login tidak berantakan.

### Alur data teknis

Saat pengguna membuat akun lalu login, alurnya seperti ini:

1. pengguna membuka halaman register
2. data akun dikirim ke Laravel
3. Laravel menyimpan akun ke tabel `users`
4. pengguna membuka halaman login
5. email dan password diperiksa
6. jika cocok, Laravel membuat session login
7. pengguna dianggap sudah terautentikasi

### Output yang harus terlihat

Setelah subbab ini selesai, hasil berikut seharusnya sudah terlihat:

* halaman `/login` dan `/register` bisa dibuka
* tabel `users` tersedia setelah migration
* aset Breeze tampil rapi setelah `npm install` dan `npm run dev`
* akun baru bisa dibuat lalu dipakai untuk login

### Troubleshooting yang paling sering

Masalah yang paling sering muncul:

* **`npm` tidak dikenali** — Node.js belum terpasang
* **halaman login rusak** — `npm install` atau `npm run dev` belum dijalankan
* **tabel `users` tidak ada** — migration belum dijalankan
* **login gagal terus** — akun belum dibuat atau password salah

{% hint style="warning" %}
Kalau Breeze sudah diinstal tetapi halaman login aneh atau berantakan, cek dulu proses `npm install` dan `npm run dev`.
{% endhint %}

{% hint style="info" %}
Jangan panik kalau setelah instalasi muncul banyak file baru. Itu normal, karena Breeze memang menyiapkan paket autentikasi yang cukup lengkap.
{% endhint %}

### Poin evaluasi bab 9.2

Pastikan Anda sudah memahami poin berikut:

* Saya tahu cara memasang Laravel Breeze.
* Saya tahu kenapa migration harus dijalankan setelah Breeze diinstal.
* Saya tahu kenapa `npm install` dan `npm run dev` dibutuhkan.
* Saya bisa membuka halaman login dan register.
* Saya bisa membuat akun lalu masuk ke aplikasi.

Jika semuanya sudah jelas, lanjut ke [9.3 Mengunci Halaman dengan Middleware](/laravel/bab-9-autentikasi-and-middleware/9.3-mengunci-halaman-dengan-middleware.md).


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://learn.devlabss.my.id/laravel/bab-9-autentikasi-and-middleware/9.2-instalasi-login-dengan-laravel-breeze.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.