> 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-1-pengenalan-and-instalasi/1.5-troubleshooting-and-error-populer.md).

# 1.5 Troubleshooting & Error Populer

## Troubleshooting dan error populer

Error adalah bagian normal dari proses belajar Laravel.

Yang penting bukan menghindari semua error. Yang penting adalah tahu cara membaca dan memperbaikinya.

Bab ini merangkum masalah yang paling sering muncul saat tahap instalasi dan awal praktik.

{% hint style="info" %}
Saat error muncul, jangan langsung panik. Baca pesannya pelan-pelan lalu fokus pada file, baris, dan kata kunci yang ditampilkan.
{% endhint %}

### `'php'` atau `'composer' is not recognized`

Error ini sering muncul saat menjalankan:

```bash
php -v
composer -v
```

Contoh pesannya:

```
'php' is not recognized as an internal or external command,
operable program or batch file.
```

#### Penyebab

Windows belum mengenali lokasi `php.exe` atau Composer.

Biasanya path Laragon belum masuk ke sistem.

#### Solusi

1. Tutup terminal atau VS Code.
2. Buka Laragon.
3. Pilih **Tools** → **Path** → **Add Laragon to PATH**.
4. Restart komputer.
5. Buka terminal lagi lalu uji ulang `php -v` dan `composer -v`.

### Port 80 atau 3306 bentrok

Masalah ini biasanya muncul saat Laragon gagal menjalankan Apache atau MySQL.

#### Penyebab

Port dipakai aplikasi lain, misalnya XAMPP atau service server lain.

#### Solusi

* Pastikan XAMPP atau server lain benar-benar dimatikan.
* Jika perlu, ubah port di Laragon melalui **Preferences** → **Services & Ports**.

Jika Apache memakai port selain `80`, alamat lokal proyek juga bisa berubah.

### `e-library.test` tidak bisa dibuka

Kadang proyek berhasil dibuat, tetapi alamat lokal tidak bisa diakses di browser.

#### Penyebab

Masalah ini biasanya terjadi karena:

* Laragon belum menjalankan service.
* virtual host lokal tidak aktif
* jaringan atau sistem membatasi akses lokal tertentu

#### Solusi

1. Pastikan **Start All** di Laragon sudah aktif.
2. Coba akses ulang `http://e-library.test`.
3. Jika masih gagal, jalankan server bawaan Laravel:

```bash
php artisan serve
```

Lalu buka:

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

### `failed to open stream` atau error dari folder `vendor`

Error ini sering muncul jika file Laravel belum lengkap atau ada package yang rusak.

Contoh kata kuncinya:

```
failed to open stream: No such file or directory
```

#### Penyebab

Proses instalasi sebelumnya terputus, atau isi folder `vendor` tidak lengkap.

#### Solusi

Jalankan perintah berikut dari folder proyek:

```bash
composer install
```

Perintah ini akan memasang ulang dependency yang dibutuhkan Laravel.

{% hint style="warning" %}
Jangan hapus isi folder `vendor` sembarangan jika belum paham dampaknya. Folder ini dibangun otomatis oleh Composer.
{% endhint %}

### Cara membaca halaman error Laravel

Laravel biasanya menampilkan pesan error yang cukup jelas.

Fokus pada tiga bagian ini:

1. **Pesan utama** — menjelaskan masalahnya.
2. **Lokasi file** — menunjukkan file yang terlibat.
3. **Nomor baris** — menunjukkan area yang perlu dicek.

Contoh:

```
Target class [BukuController] does not exist.
In web.php line 15
```

Dari pesan itu, Anda bisa menyimpulkan:

* Laravel tidak menemukan `BukuController`.
* Kesalahan terdeteksi di `web.php`.
* Baris yang perlu dicek adalah baris 15.

Biasanya masalah seperti ini muncul karena controller belum dibuat, salah namespace, atau belum di-import.

### Pola berpikir saat menemukan error

Gunakan urutan sederhana ini:

1. Baca kata kunci error.
2. Lihat file dan nomor baris.
3. Cocokkan dengan kode yang baru terakhir diubah.
4. Perbaiki satu hal dulu.
5. Jalankan ulang lalu cek hasilnya.

{% hint style="danger" %}
Jika menemukan error yang tidak ada di bab ini, salin pesan utamanya lalu cari dengan teliti atau diskusikan dengan guru. Kemampuan membaca error adalah skill penting dalam pemrograman.
{% endhint %}

### Poin evaluasi bab 1.5

Pastikan Anda sudah siap menghadapi error dasar berikut:

* Saya tahu cara mengatasi error `php` atau `composer` yang tidak dikenali.
* Saya paham bentrok port bisa membuat Laragon gagal berjalan.
* Saya tahu `php artisan serve` bisa dipakai jika alamat `.test` gagal dibuka.
* Saya tahu `composer install` dipakai saat dependency proyek belum lengkap.
* Saya siap membaca file, baris, dan pesan error sebelum panik.

Jika semua poin ini sudah jelas, lanjut ke [Checkpoint: Uji Pemahamanmu Sebelum Lanjut!](/laravel/bab-1-pengenalan-and-instalasi/1.6-checkpoint-uji-pemahamanmu-sebelum-lanjut.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-1-pengenalan-and-instalasi/1.5-troubleshooting-and-error-populer.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.