Tutorial Instalasi Laravel dan Persiapan Environment: Panduan Lengkap untuk Pemula

Laravel merupakan salah satu framework PHP populer yang digunakan untuk membangun aplikasi web secara terstruktur. Framework ini menyediakan berbagai fitur, mulai dari routing, pengelolaan database, autentikasi, validasi formulir, hingga sistem template untuk membangun antarmuka website.

Namun, sebelum mulai mempelajari Laravel, ada satu tahap penting yang perlu dipahami, yaitu menyiapkan development environment atau lingkungan pengembangan. Tahap ini mencakup instalasi PHP, Composer, Node.js, serta pembuatan proyek Laravel agar dapat dijalankan di komputer sendiri.

Bagi pemula, proses instalasi terkadang terasa membingungkan karena terdapat beberapa pilihan tools dan perintah terminal yang perlu digunakan. Kesalahan versi PHP, konfigurasi PATH, atau dependensi yang belum lengkap juga dapat menyebabkan instalasi gagal.

Melalui panduan ini, kamu akan mempelajari tutorial instalasi Laravel dari awal sampai berhasil dijalankan di localhost. Pembahasan disusun secara bertahap agar mudah diikuti, termasuk alternatif tools, konfigurasi awal, contoh struktur proyek, dan solusi untuk masalah yang sering terjadi.

Daftar Isi

1. Apa Itu Laravel dan Development Environment?
2. Persiapan Sebelum Menginstal Laravel
3. Memilih Tools untuk Menjalankan Laravel
4. Cara Menginstal PHP
5. Cara Menginstal Composer
6. Cara Menginstal Node.js dan NPM
7. Cara Menginstal Laravel
8. Membuat Proyek Laravel Pertama
9. Menjalankan Laravel di Localhost
10. Mengenal Struktur Folder Laravel
11. Konfigurasi Awal Laravel
12. Menghubungkan Laravel dengan Database MySQL
13. Mengatasi Masalah Instalasi Laravel
14. Tips Belajar Laravel untuk Pemula
15. FAQ Seputar Instalasi Laravel
16. Kesimpulan

1. Apa Itu Laravel dan Development Environment?

Laravel adalah framework PHP yang membantu developer membangun aplikasi web menggunakan struktur kode yang lebih terorganisasi. Laravel menyediakan berbagai komponen siap pakai sehingga developer tidak perlu membuat seluruh fungsi aplikasi dari awal.

Sebagai contoh, ketika membuat aplikasi pengelolaan data mahasiswa, kamu mungkin membutuhkan fitur untuk menampilkan daftar mahasiswa, menambahkan data, mengedit informasi, dan menghapus data. Laravel menyediakan berbagai fasilitas untuk mengembangkan fitur tersebut secara lebih terstruktur.

Laravel juga menerapkan pola arsitektur Model-View-Controller (MVC). Pola ini memisahkan tanggung jawab pengelolaan data, tampilan, dan alur permintaan pengguna.

Jika kamu belum memahami konsep tersebut, pelajari juga artikel Memahami Konsep MVC dalam Pengembangan Web.

Sementara itu, development environment adalah kumpulan perangkat lunak dan konfigurasi yang diperlukan untuk mengembangkan serta menjalankan aplikasi.

Dalam pengembangan Laravel, lingkungan tersebut biasanya mencakup:

• PHP: bahasa pemrograman yang menjalankan kode Laravel.
• Composer: pengelola dependensi PHP.
• Node.js dan NPM: digunakan untuk mengelola serta membangun aset frontend.
• Database: tempat menyimpan data aplikasi, misalnya MySQL atau SQLite.
• Code editor: aplikasi untuk menulis dan mengelola kode program.
• Terminal: tempat menjalankan perintah instalasi dan pengembangan.

Seluruh komponen tersebut perlu disiapkan sesuai kebutuhan proyek dan versi Laravel yang digunakan.

2. Persiapan Sebelum Menginstal Laravel

Sebelum memasang Laravel, pastikan komputer sudah memiliki perangkat lunak dasar yang diperlukan.

A. Periksa spesifikasi komputer

Untuk proyek latihan sederhana, komputer modern dengan RAM 8 GB umumnya sudah cukup nyaman digunakan. RAM 4 GB masih dapat digunakan pada proyek kecil, tetapi menjalankan banyak aplikasi sekaligus mungkin terasa lebih lambat.

Selain itu, siapkan ruang penyimpanan yang cukup untuk PHP, dependensi Composer, Node.js, database, dan file proyek.

Spesifikasi yang dibutuhkan dapat berbeda bergantung pada sistem operasi, versi tools, serta ukuran aplikasi yang dikembangkan.

B. Tentukan versi Laravel

Versi framework menentukan versi PHP dan dependensi yang harus disiapkan.

Pada saat artikel ini disusun, Laravel 13 merupakan versi utama terbaru yang tersedia dalam dokumentasi resmi. Laravel 13 membutuhkan PHP 8.3 atau versi yang lebih baru dalam rentang versi yang didukung.

Sebelum memulai, periksa kembali persyaratan pada dokumentasi resmi Laravel karena ketentuan dapat berubah mengikuti rilis framework.

Dokumentasi instalasi: https://laravel.com/docs/installation

Jika kamu sedang mengikuti tutorial Laravel versi lama, jangan langsung menganggap semua perintah dan konfigurasi akan sama. Sesuaikan materi tutorial dengan versi framework yang digunakan.

C. Siapkan code editor

Kamu dapat menggunakan Visual Studio Code atau editor lain yang mendukung PHP.

Untuk mempermudah pengembangan, pertimbangkan memasang ekstensi PHP, Laravel, dan Blade yang sesuai. Ekstensi membantu memberikan pewarnaan sintaks, pelengkapan kode, serta navigasi antarfolder.

Perlu diingat, code editor tidak menggantikan PHP atau Composer. Editor berfungsi untuk menulis kode, sedangkan PHP dan tools lainnya dibutuhkan untuk menjalankan aplikasi.

D. Siapkan koneksi internet

Composer perlu mengunduh paket yang dibutuhkan proyek. NPM juga dapat mengunduh dependensi frontend.

Karena itu, koneksi internet yang stabil akan membantu proses instalasi berjalan lebih lancar.

3. Memilih Tools untuk Menjalankan Laravel

Ada beberapa cara untuk menyiapkan lingkungan Laravel. Pilihan yang tepat bergantung pada sistem operasi, pengalaman, dan kebutuhan proyek.

Opsi 1: Laravel Herd

Laravel Herd merupakan lingkungan pengembangan yang dirancang khusus untuk PHP dan Laravel. Herd menyediakan komponen untuk menjalankan aplikasi lokal dan dapat menyertakan beberapa tools yang dibutuhkan dalam pengembangan.

Herd cocok bagi pemula yang ingin mengurangi konfigurasi manual.

Situs resmi: https://herd.laravel.com

Periksa dukungan sistem operasi dan fitur pada paket yang tersedia sebelum menginstalnya.

Opsi 2: PHP dan Composer secara terpisah

Kamu juga dapat memasang PHP dan Composer secara mandiri. Metode ini memberikan fleksibilitas untuk memahami konfigurasi environment secara lebih mendalam.

Pilihan ini cocok bagi developer yang ingin mengelola beberapa proyek dengan kebutuhan versi PHP berbeda, asalkan konfigurasi setiap versi dikelola dengan benar.

Opsi 3: XAMPP

XAMPP merupakan paket lingkungan server lokal yang sering digunakan oleh pemula PHP. Paket ini umumnya menyediakan Apache, MariaDB, PHP, dan phpMyAdmin.

XAMPP dapat digunakan untuk membantu menyiapkan layanan database atau menjalankan proyek PHP tertentu. Namun, memasang XAMPP saja belum tentu memenuhi seluruh persyaratan Laravel terbaru.

Pastikan versi PHP pada XAMPP sesuai dengan persyaratan Laravel yang digunakan. Kamu mungkin perlu menyiapkan PHP atau Composer secara terpisah.

Untuk menjalankan Laravel, kamu tidak harus menempatkan proyek di folder htdocs apabila menggunakan server pengembangan bawaan Laravel melalui Artisan.

Rekomendasi: jika kamu baru mulai belajar Laravel, pilih satu metode instalasi terlebih dahulu. Hindari mencampur beberapa instalasi PHP tanpa memahami PATH dan versi PHP yang sedang digunakan.

4. Cara Menginstal PHP

PHP merupakan komponen utama karena Laravel dibangun menggunakan bahasa pemrograman tersebut.

Cara instalasi PHP berbeda untuk setiap sistem operasi. Kamu dapat mengikuti panduan resmi Laravel atau menggunakan lingkungan pengembangan yang menyediakan PHP.

Dokumentasi resmi menyediakan metode instalasi untuk Windows, macOS, dan Linux. Untuk petunjuk yang paling sesuai dengan versi Laravel terbaru, kunjungi https://laravel.com/docs/installation.

Setelah instalasi selesai, buka terminal baru.

Pada Windows, kamu dapat menggunakan PowerShell atau terminal di Visual Studio Code. Pada macOS dan Linux, gunakan terminal bawaan atau terminal dari editor.

Jalankan perintah berikut:

php -v

Jika instalasi berhasil dan PHP dapat ditemukan oleh terminal, versi PHP akan ditampilkan. Contohnya, keluaran dapat menunjukkan versi PHP 8.3 atau versi lebih baru yang didukung.

Angka versi pada komputer kamu mungkin berbeda.

Memeriksa ekstensi PHP

Laravel membutuhkan sejumlah ekstensi PHP untuk menjalankan berbagai fitur. Kebutuhan pastinya mengikuti versi Laravel dan dependensi proyek.

Untuk melihat konfigurasi PHP yang aktif, gunakan:

php --ini

Untuk melihat daftar ekstensi yang tersedia:

php -m

Jika muncul pesan bahwa perintah php tidak dikenali, kemungkinan PHP belum terpasang dengan benar atau lokasi executable PHP belum ditambahkan ke PATH.

Jangan melanjutkan ke instalasi Laravel sebelum perintah php -v berhasil dijalankan.

5. Cara Menginstal Composer

Composer adalah pengelola dependensi PHP. Tools ini membantu mengunduh library, mengatur versi paket, serta memastikan dependensi proyek sesuai dengan konfigurasi yang ditentukan.

Laravel menggunakan Composer untuk mengelola banyak komponen utamanya.

Langkah 1: Unduh Composer

Kunjungi situs resmi Composer:

https://getcomposer.org/download

Untuk Windows, ikuti petunjuk installer resmi yang tersedia. Pada macOS dan Linux, gunakan metode instalasi yang sesuai dengan sistem operasi.

Hindari mengunduh installer dari sumber yang tidak jelas.

Langkah 2: Pastikan Composer terdeteksi

Setelah instalasi selesai, buka terminal baru dan jalankan:

composer -V

Jika berhasil, terminal akan menampilkan informasi versi Composer.

Langkah 3: Periksa hubungan Composer dengan PHP

Composer menggunakan PHP untuk menjalankan berbagai prosesnya. Jika Composer tidak dapat berjalan, periksa apakah PHP sudah tersedia di terminal yang sama.

Gunakan:

php -v
composer -V

Kedua perintah tersebut seharusnya dapat dijalankan tanpa kesalahan.

Apa perbedaan PHP dan Composer?

PHP adalah bahasa pemrograman sekaligus runtime yang menjalankan kode PHP. Composer adalah alat untuk mengelola paket dan dependensi PHP.

Misalnya, PHP digunakan ketika kamu menjalankan aplikasi, sedangkan Composer membantu mengunduh library yang dibutuhkan aplikasi tersebut.

Keduanya memiliki fungsi berbeda, tetapi saling mendukung dalam pengembangan Laravel.

6. Cara Menginstal Node.js dan NPM

Selain PHP dan Composer, pengembangan Laravel modern biasanya menggunakan Node.js dan NPM untuk mengelola aset frontend.

Aset frontend dapat mencakup file JavaScript, CSS, dan berbagai dependensi yang digunakan oleh antarmuka aplikasi. Laravel menyediakan integrasi dengan Vite untuk proses pengembangan dan pembangunan aset tersebut.

Langkah 1: Unduh Node.js

Kunjungi situs resmi Node.js:

https://nodejs.org

Pilih versi yang sesuai dengan sistem operasi dan kebutuhan proyek. Untuk penggunaan umum, versi LTS sering menjadi pilihan yang praktis karena ditujukan untuk penggunaan jangka panjang.

Ikuti petunjuk instalasi dari situs resminya.

Langkah 2: Periksa instalasi Node.js

Buka terminal baru, lalu jalankan:

node -v

Perintah tersebut akan menampilkan versi Node.js yang terpasang.

Selanjutnya, periksa NPM:

npm -v

Jika kedua perintah berhasil, Node.js dan NPM sudah dapat digunakan dari terminal.

Langkah 3: Pahami kapan NPM dibutuhkan

NPM tidak menggantikan Composer.

Composer mengelola dependensi PHP, sedangkan NPM mengelola paket JavaScript dan perangkat yang dibutuhkan untuk membangun aset frontend.

Pada proyek Laravel yang menggunakan Vite, kamu biasanya menjalankan:

npm install

Kemudian, untuk membangun aset frontend:

npm run build

Pada tahap pengembangan, kamu juga dapat menggunakan perintah:

npm run dev

Perintah terakhir menjalankan proses pengembangan frontend. Dalam setup standar, proses tersebut perlu berjalan bersamaan dengan server aplikasi Laravel.

Jika kamu ingin memahami konfigurasi aset frontend lebih jauh, dokumentasi resmi Vite pada Laravel dapat diakses melalui https://laravel.com/docs/vite.

7. Cara Menginstal Laravel

Setelah PHP dan Composer siap, kamu dapat membuat proyek Laravel dengan dua pendekatan utama.

Metode A: Menggunakan Laravel Installer

Laravel Installer merupakan alat berbasis command line yang mempermudah pembuatan proyek Laravel.

Jika installer belum tersedia, jalankan:

composer global require laravel/installer

Perintah tersebut memasang Laravel Installer secara global melalui Composer.

Setelah instalasi selesai, periksa apakah perintah laravel dapat dijalankan:

laravel --version

Jika perintah tidak dikenali, lokasi direktori executable global Composer mungkin belum ditambahkan ke PATH. Lokasinya berbeda bergantung pada sistem operasi dan konfigurasi Composer.

Setelah installer dapat digunakan, buat proyek baru:

laravel new belajar-laravel

Installer dapat menampilkan pertanyaan interaktif mengenai starter kit, database, atau pengujian, tergantung versi yang digunakan.

Jika kamu belum memahami semua pilihan tersebut, gunakan pilihan dasar yang tersedia dan catat konfigurasi yang dipilih.

Metode B: Menggunakan Composer Create-Project

Alternatifnya, kamu dapat membuat proyek langsung menggunakan Composer:

composer create-project laravel/laravel belajar-laravel

Perintah ini mengunduh kerangka proyek Laravel ke dalam folder belajar-laravel dan memasang dependensi yang diperlukan.

Metode ini cocok bagi pemula yang ingin memahami proses pembuatan proyek tanpa harus memasang Laravel Installer terlebih dahulu.

Mana yang sebaiknya dipilih?

Kedua metode dapat digunakan untuk memulai proyek Laravel.

• Gunakan Laravel Installer jika kamu ingin mengikuti alur pembuatan proyek yang disediakan Laravel.
• Gunakan Composer Create-Project jika kamu ingin membuat proyek melalui Composer secara langsung.

Pilih salah satu metode untuk proyek latihan pertama agar prosesnya lebih mudah dipahami. Jangan menjalankan kedua perintah hanya untuk membuat proyek yang sama.

8. Membuat Proyek Laravel Pertama

Sekarang kita akan membuat proyek sederhana bernama belajar-laravel.

Jika menggunakan Laravel Installer, jalankan:

laravel new belajar-laravel

Jika menggunakan Composer, jalankan:

composer create-project laravel/laravel belajar-laravel

Tunggu sampai proses instalasi selesai. Durasi instalasi bergantung pada koneksi internet, kinerja komputer, dan jumlah dependensi yang harus diunduh.

Setelah selesai, masuk ke direktori proyek:

cd belajar-laravel

Periksa isi direktori untuk memastikan struktur proyek Laravel sudah tersedia.

Di dalamnya, kamu biasanya akan menemukan folder seperti app, bootstrap, config, database, public, resources, routes, storage, dan tests, serta sejumlah file konfigurasi.

Jika folder dan file proyek sudah terbentuk, kamu dapat melanjutkan ke proses menjalankan aplikasi.

Periksa dependensi proyek

Kamu juga dapat memastikan dependensi PHP telah terpasang. Pada proyek yang berhasil dibuat melalui metode di atas, Composer biasanya sudah mengerjakan proses ini.

Jika dependensi belum tersedia atau instalasi sebelumnya terhenti, jalankan:

composer install

Perintah tersebut membaca konfigurasi dependensi proyek dan memasang paket yang diperlukan.

Jalankan perintah dari direktori utama proyek, yaitu direktori yang berisi file composer.json.

9. Menjalankan Laravel di Localhost

Setelah proyek berhasil dibuat, langkah berikutnya adalah menjalankan server pengembangan.

Pastikan terminal sedang berada di direktori proyek belajar-laravel.

Jalankan perintah berikut:

php artisan serve

Jika berhasil, Laravel akan menampilkan alamat server pengembangan, yang umumnya menggunakan alamat seperti:

http://127.0.0.1:8000

Buka alamat tersebut di browser.

Jika halaman awal Laravel muncul, berarti aplikasi sudah berhasil dijalankan di komputer lokal.

Apa fungsi perintah Artisan?

Artisan adalah command-line interface yang disediakan Laravel. Tools ini mempermudah developer menjalankan berbagai tugas, seperti membuat controller, melakukan migrasi database, membersihkan cache, dan menjalankan server pengembangan.

Contoh perintah Artisan lainnya:

php artisan --version

Untuk melihat daftar perintah yang tersedia:

php artisan list

Untuk melihat daftar route:

php artisan route:list

Perlu diingat, php artisan serve digunakan untuk pengembangan lokal, bukan sebagai pengganti konfigurasi server produksi.

Menjalankan aset frontend

Pada proyek Laravel yang menggunakan Vite, buka terminal kedua di direktori proyek.

Jalankan:

npm install

Kemudian, jalankan:

npm run dev

Biarkan proses tersebut tetap berjalan selama diperlukan dalam pengembangan. Sementara itu, terminal pertama dapat digunakan untuk menjalankan php artisan serve.

Pada konfigurasi standar, Laravel terbaru juga dapat menyediakan skrip pengembangan melalui Composer. Ikuti instruksi yang ditampilkan oleh installer dan dokumentasi versi proyek kamu agar perintah yang digunakan sesuai.

10. Mengenal Struktur Folder Laravel

Setelah Laravel berhasil dijalankan, kamu perlu mengenali folder penting di dalam proyek.

Memahami struktur direktori akan mempermudah proses belajar karena setiap bagian aplikasi memiliki tempat dan tanggung jawab masing-masing.

A. Folder app

Folder app berisi kode inti aplikasi. Di dalamnya terdapat direktori seperti Models dan Http, yang dapat berisi model serta controller aplikasi.

Sebagai contoh, ketika membuat fitur pengelolaan data produk, kamu dapat menempatkan model Product di direktori model.

B. Folder routes

Folder routes berisi definisi route atau jalur permintaan aplikasi.

File routes/web.php digunakan untuk mendefinisikan route web pada setup Laravel standar.

Contoh sederhana:

<?php

use Illuminate\Support\Facades\Route;

Route::get('/halo', function () {
    return 'Halo, Laravel!';
});

Setelah menyimpan perubahan, buka:

http://127.0.0.1:8000/halo

Jika server berjalan dan route telah terdaftar, browser akan menampilkan teks Halo, Laravel!.

Contoh ini merupakan latihan sederhana untuk memastikan kamu memahami hubungan antara route dan permintaan browser.

C. Folder resources

Folder resources menyimpan sumber daya frontend, termasuk template Blade pada aplikasi Laravel yang menggunakan Blade.

Misalnya, kamu dapat membuat halaman HTML dinamis melalui file berekstensi .blade.php.

D. Folder database

Folder database berisi file yang berkaitan dengan database, termasuk migrations, seeders, dan factories.

Migration membantu mendefinisikan perubahan struktur database melalui kode sehingga skema database dapat dikelola secara lebih terorganisasi.

E. Folder public

Folder public merupakan direktori publik aplikasi. File entry point aplikasi web Laravel berada di sini.

Pada deployment, server web seharusnya diarahkan ke direktori public, bukan ke seluruh direktori proyek. Pengaturan ini membantu mencegah file konfigurasi dan kode internal terekspos secara tidak semestinya.

F. File .env

File .env digunakan untuk menyimpan konfigurasi lingkungan, seperti koneksi database dan sejumlah pengaturan aplikasi.

File ini dapat memuat informasi sensitif. Jangan memasukkan kredensial asli ke repositori publik.

Memahami fungsi folder-folder tersebut akan mempermudah kamu mengikuti artikel selanjutnya mengenai routing, controller, Blade, dan database.

11. Konfigurasi Awal Laravel

Setelah aplikasi berhasil berjalan, lakukan pemeriksaan konfigurasi dasar sebelum mulai mengembangkan fitur.

A. Periksa file environment

Pada instalasi standar, Laravel biasanya menyediakan file .env yang berisi konfigurasi lingkungan.

Jika file tersebut belum tersedia, periksa petunjuk instalasi sesuai versi proyek. Jangan menyalin konfigurasi dari proyek lain secara sembarangan karena nilai konfigurasi bisa berbeda.

B. Atur nama aplikasi

Di file .env, kamu dapat menemukan konfigurasi nama aplikasi, misalnya:

APP_NAME=Laravel

Kamu dapat mengubahnya menjadi:

APP_NAME="Belajar Laravel"

Penggunaan tanda kutip dapat membantu ketika nilai konfigurasi mengandung spasi.

Perubahan tersebut tidak otomatis mengubah seluruh teks yang terlihat di halaman. Nama yang ditampilkan di browser tetap bergantung pada bagaimana aplikasi menggunakan konfigurasi tersebut.

C. Perhatikan mode debug

Pada lingkungan lokal, mode debug membantu menampilkan informasi ketika terjadi kesalahan. Namun, mode debug tidak boleh dibiarkan aktif pada aplikasi produksi yang dapat diakses publik.

Konfigurasi produksi harus menggunakan pengaturan yang aman dan tidak menampilkan detail internal aplikasi kepada pengguna.

D. Jangan sembarangan menghapus file konfigurasi

Ketika mengikuti tutorial, hindari menghapus file atau mengubah konfigurasi yang belum dipahami. Jika terjadi kesalahan, periksa pesan error dan dokumentasi terlebih dahulu.

Biasakan membuat salinan kode penting atau menggunakan Git agar perubahan dapat dilacak dan dipulihkan.

12. Menghubungkan Laravel dengan Database MySQL

Laravel mendukung beberapa sistem database, termasuk MySQL dan SQLite. Untuk latihan yang melibatkan pengelolaan data, kamu dapat memilih MySQL jika sudah familiar dengan phpMyAdmin atau MySQL Workbench.

Sebelum menghubungkan aplikasi, pastikan layanan database telah terpasang dan berjalan.

Langkah 1: Buat database

Buat database baru melalui alat pengelolaan database yang kamu gunakan.

Sebagai contoh, gunakan nama:

belajar_laravel

Nama database harus sesuai dengan konfigurasi yang akan digunakan oleh aplikasi.

Langkah 2: Sesuaikan file .env

Buka file .env di direktori utama proyek. Untuk konfigurasi MySQL lokal, contohnya:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=belajar_laravel
DB_USERNAME=root
DB_PASSWORD=

Contoh di atas menggunakan akun lokal dengan nama pengguna root dan kata sandi kosong. Konfigurasi tersebut hanya contoh dan tidak boleh dianggap sesuai untuk semua komputer.

Sesuaikan nama pengguna, kata sandi, port, dan informasi koneksi dengan pengaturan database milikmu. Hindari menggunakan akun tanpa kata sandi untuk lingkungan produksi.

Langkah 3: Jalankan migration

Setelah konfigurasi database benar, jalankan:

php artisan migrate

Laravel akan mencoba terhubung ke database dan menjalankan migration yang tersedia.

Jika perintah berhasil, beberapa tabel bawaan dapat dibuat sesuai dengan migration yang ada pada proyek tersebut.

Jika koneksi gagal, periksa apakah layanan database sedang berjalan, nama database benar, dan kredensial sesuai.

Alternatif: Menggunakan SQLite

Jika belum ingin menyiapkan server MySQL, SQLite dapat menjadi pilihan untuk latihan awal.

SQLite menyimpan data dalam sebuah file dan tidak memerlukan server database terpisah seperti MySQL. Namun, langkah konfigurasi tetap harus mengikuti versi Laravel dan struktur proyek yang digunakan.

Untuk proyek yang lebih besar, pilih database berdasarkan kebutuhan aplikasi dan lingkungan deployment.

13. Mengatasi Masalah Instalasi Laravel

Masalah instalasi merupakan bagian yang wajar dalam proses belajar. Hal terpenting adalah memahami pesan error dan memperbaiki penyebabnya, bukan sekadar mencoba berbagai perintah secara acak.

Berikut beberapa masalah yang sering ditemukan.

A. Perintah php tidak dikenali

Pesan error dapat menunjukkan bahwa sistem tidak menemukan perintah PHP.

Penyebab yang umum adalah PHP belum terpasang atau direktori executable PHP belum ditambahkan ke PATH.

Solusinya:

1. Pastikan PHP sudah terpasang.
2. Periksa lokasi instalasi PHP.
3. Periksa konfigurasi PATH sistem operasi.
4. Buka terminal baru.
5. Jalankan kembali php -v.

Jika kamu memasang beberapa versi PHP, pastikan terminal menggunakan versi yang sesuai dengan kebutuhan proyek.

B. Perintah composer tidak dikenali

Masalah ini biasanya berkaitan dengan instalasi Composer atau PATH.

Pastikan installer selesai dijalankan dan ikuti panduan konfigurasi sistem operasi pada dokumentasi Composer.

Setelah memperbaiki konfigurasi, tutup terminal lama dan buka terminal baru sebelum menguji kembali.

C. Versi PHP tidak sesuai

Composer dapat menolak pemasangan dependensi apabila versi PHP yang aktif tidak memenuhi persyaratan proyek.

Periksa versi PHP melalui:

php -v

Kemudian, bandingkan dengan persyaratan pada dokumentasi Laravel dan file composer.json proyek.

Jangan hanya mengganti versi Laravel atau mengabaikan pemeriksaan platform tanpa memahami konsekuensinya. Versi PHP yang tidak sesuai dapat menimbulkan error saat aplikasi dijalankan.

D. Instalasi Composer berhenti di tengah jalan

Proses dapat terganggu oleh koneksi internet, masalah akses direktori, atau ketidakcocokan dependensi.

Baca pesan error yang ditampilkan. Pastikan koneksi internet stabil dan jalankan kembali perintah yang sesuai setelah penyebabnya diperbaiki.

Jika proyek sudah terbentuk, perintah composer install dapat digunakan untuk memasang dependensi berdasarkan konfigurasi proyek.

E. Perintah laravel tidak dikenali

Jika kamu memasang Laravel Installer secara global tetapi perintah laravel tidak dapat digunakan, periksa apakah direktori executable global Composer sudah masuk ke PATH.

Sebagai alternatif, kamu dapat membuat proyek melalui Composer:

composer create-project laravel/laravel belajar-laravel

F. Port localhost sudah digunakan

Server pengembangan Laravel biasanya menggunakan port 8000 secara default. Jika port tersebut sudah digunakan aplikasi lain, server mungkin tidak dapat dijalankan pada port yang sama.

Kamu dapat memilih port lain:

php artisan serve --port=8080

Setelah itu, buka alamat lokal yang sesuai dengan port tersebut, misalnya http://127.0.0.1:8080.

G. Halaman Laravel tidak bisa dibuka

Jika browser tidak menampilkan halaman, periksa beberapa hal berikut:

• Pastikan server Laravel masih berjalan.
• Pastikan alamat dan port pada browser benar.
• Periksa apakah terminal menampilkan pesan error.
• Pastikan kamu menjalankan server dari direktori proyek yang benar.
• Jika menggunakan Vite, periksa apakah dependensi frontend sudah dipasang dan proses pengembangannya berjalan.

Jika masalah tetap terjadi, catat pesan error secara lengkap. Informasi tersebut biasanya lebih membantu dibandingkan hanya menyebutkan bahwa Laravel tidak bisa dibuka.

H. Database gagal terhubung

Periksa konfigurasi DB_CONNECTION, DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, dan DB_PASSWORD pada file .env.

Pastikan layanan database aktif dan database yang dituju memang tersedia.

Jika kamu mengubah konfigurasi tetapi aplikasi masih menggunakan nilai lama, periksa cache konfigurasi. Pada lingkungan lokal, kamu dapat mencoba:

php artisan config:clear

Jalankan perintah tersebut dari direktori proyek yang benar.

14. Tips Belajar Laravel untuk Pemula

Berhasil menginstal Laravel merupakan langkah awal. Setelah itu, kamu perlu membangun pemahaman mengenai cara kerja framework dan menggunakannya untuk membuat fitur aplikasi.

Berikut urutan belajar yang dapat kamu ikuti.

1. Kuasai dasar PHP

Pelajari variabel, tipe data, percabangan, perulangan, fungsi, array, dan cara mengelola form.

Jika dasar PHP belum cukup kuat, kamu dapat memulai dari artikel Belajar PHP dari Nol: Panduan Lengkap untuk Pemula.

2. Pelajari OOP PHP

Laravel banyak menggunakan konsep pemrograman berorientasi objek. Pahami class, object, property, method, inheritance, dan encapsulation.

Baca juga panduan Belajar OOP PHP untuk Pemula untuk memperkuat fondasi tersebut.

3. Pahami routing dan controller

Setelah instalasi selesai, coba buat beberapa route sederhana. Selanjutnya, pindahkan logika tertentu ke controller agar kode lebih terstruktur.

4. Pelajari Blade

Blade merupakan template engine Laravel yang membantu membuat tampilan dinamis. Pelajari cara menampilkan data, membuat layout, dan menggunakan struktur kontrol dalam template.

5. Pelajari database dan Eloquent ORM

Pahami migration, model, relasi, dan operasi CRUD. Gunakan data latihan yang sederhana agar kamu dapat mengikuti alur pengolahan data dari database sampai tampilan.

Jika belum memahami SQL, pelajari Belajar MySQL dan SQL dari Dasar untuk Pemula.

6. Buat proyek kecil

Sebagai latihan, buat aplikasi pengelolaan catatan atau daftar tugas. Mulai dari menampilkan data, menambahkan data, mengedit, dan menghapus data.

Proyek kecil membantu kamu memahami bagaimana routing, controller, model, view, dan database bekerja bersama.

Untuk gambaran belajar yang lebih luas, lanjutkan dengan Roadmap Belajar Laravel dari Nol sampai Mahir.

15. FAQ Seputar Instalasi Laravel

Apakah Laravel gratis?

Laravel merupakan framework open-source yang dapat digunakan sesuai ketentuan lisensinya. Kamu dapat mempelajari dan mengembangkan aplikasi menggunakan Laravel tanpa membeli lisensi framework itu sendiri.

Apakah harus menginstal XAMPP sebelum Laravel?

Tidak harus. Kamu dapat menggunakan PHP dan Composer secara terpisah atau lingkungan pengembangan seperti Laravel Herd. XAMPP merupakan salah satu pilihan, khususnya jika kamu membutuhkan layanan database lokal yang disertakan di dalamnya.

Pastikan versi PHP dan ekstensi yang tersedia memenuhi persyaratan Laravel.

Apakah Laravel bisa dijalankan tanpa internet?

Setelah proyek dan seluruh dependensinya terpasang, pengembangan lokal dapat dilakukan tanpa koneksi internet untuk banyak aktivitas. Namun, proses instalasi paket baru, mengunduh dependensi, atau menggunakan layanan daring tetap membutuhkan koneksi.

Apakah Laravel bisa digunakan di Windows?

Ya. Laravel dapat dikembangkan di Windows dengan lingkungan yang sesuai, termasuk PHP, Composer, dan Node.js. Kamu juga dapat mempertimbangkan Laravel Herd atau lingkungan Linux melalui WSL apabila sesuai dengan kebutuhanmu.

Apakah Node.js wajib untuk Laravel?

Tidak setiap fitur Laravel membutuhkan Node.js. Namun, Node.js dan NPM diperlukan ketika kamu menggunakan workflow frontend yang mengandalkan Vite atau dependensi JavaScript.

Untuk mengikuti setup Laravel modern secara lengkap, sebaiknya siapkan Node.js dan NPM.

Bagaimana cara mengetahui Laravel berhasil diinstal?

Jalankan server pengembangan menggunakan php artisan serve, kemudian buka alamat localhost yang ditampilkan di terminal. Jika halaman aplikasi dapat dibuka, instalasi dasar dan server lokal telah berfungsi.

Kamu juga dapat memeriksa versi framework melalui:

php artisan --version

Apakah php artisan serve cocok untuk website produksi?

Perintah tersebut ditujukan untuk pengembangan lokal. Website produksi sebaiknya dijalankan melalui lingkungan hosting atau server yang dikonfigurasi sesuai rekomendasi deployment Laravel.

Apakah pemula harus langsung belajar semua fitur Laravel?

Tidak. Mulailah dengan memahami instalasi, routing, controller, Blade, dan dasar database. Setelah itu, lanjutkan ke CRUD, validasi, autentikasi, pengujian, dan fitur lain secara bertahap.

16. Kesimpulan

Tutorial instalasi Laravel dan persiapan environment merupakan langkah penting sebelum memulai pengembangan aplikasi web menggunakan framework Laravel.

Untuk memulai, pastikan PHP dan Composer sudah terpasang serta dapat dijalankan melalui terminal. Siapkan Node.js dan NPM jika proyek menggunakan workflow frontend berbasis Vite. Setelah itu, buat proyek Laravel, periksa dependensinya, dan jalankan aplikasi melalui server pengembangan lokal.

Kamu juga perlu mengenali struktur folder, memahami konfigurasi .env, dan mengetahui cara menghubungkan aplikasi dengan database. Jika muncul masalah, periksa versi perangkat lunak, PATH, dependensi, port server, dan pesan error sebelum mencoba solusi lain.

Setelah berhasil menjalankan proyek pertama, lanjutkan dengan mempelajari routing, controller, Blade, database, dan operasi CRUD. Dengan latihan bertahap serta proyek sederhana, kamu akan lebih mudah memahami bagaimana Laravel digunakan dalam pengembangan aplikasi web.

Langkah berikutnya: setelah menyelesaikan instalasi, pelajari cara kerja routing dan controller Laravel agar kamu dapat mulai membangun fitur aplikasi sendiri.