Laravel adalah framework PHP yang populer untuk membangun aplikasi web modern. Dengan sintaks yang elegan, fitur yang kaya, dan komunitas yang besar, Laravel memudahkan developer untuk membuat aplikasi web yang kompleks dengan lebih cepat dan efisien. Jika Anda seorang developer Windows yang ingin memulai petualangan Anda dengan Laravel, artikel ini adalah panduan lengkap untuk cara install Laravel di Windows menggunakan Composer.
Composer adalah pengelola dependensi (dependency manager) untuk PHP, yang memungkinkan Anda mengelola pustaka (libraries) dan package yang dibutuhkan oleh proyek Anda. Menggunakan Composer adalah cara yang paling direkomendasikan dan paling mudah untuk menginstal Laravel. Jadi, mari kita mulai!
1. Persiapan Awal: Memastikan Lingkungan Pengembangan Siap
Sebelum kita mulai cara install Laravel di Windows menggunakan Composer, ada beberapa persiapan penting yang perlu Anda lakukan untuk memastikan lingkungan pengembangan Anda siap. Persiapan ini termasuk menginstal PHP, Composer, dan memastikan bahwa php.exe dan Composer ada dalam PATH environment.
1.1. Menginstal PHP (PHP Installation)
Laravel membutuhkan PHP untuk berjalan. Pastikan Anda memiliki PHP terinstal di komputer Windows Anda. Anda dapat mengunduh PHP dari situs web resmi PHP: https://www.php.net/downloads.php.
- Pilih Versi yang Tepat: Laravel mendukung berbagai versi PHP. Periksa dokumentasi Laravel resmi untuk mengetahui versi PHP yang didukung oleh versi Laravel yang ingin Anda instal. Biasanya, versi PHP terbaru yang stabil adalah pilihan yang baik.
- Unduh Versi Windows: Unduh versi PHP yang sesuai untuk Windows (biasanya dalam format .zip).
- Ekstrak PHP: Ekstrak file .zip yang diunduh ke direktori pilihan Anda (misalnya,
C:php). - Konfigurasi php.ini: Cari file
php.ini-developmentatauphp.ini-productiondi direktori PHP yang diekstrak. Salin salah satu file tersebut dan ubah namanya menjadiphp.ini. Bukaphp.inidengan editor teks dan lakukan beberapa konfigurasi:- Uncomment (hapus tanda titik koma) baris
extension_dir = "ext"dan ubah menjadiextension_dir = "C:phpext"(gantiC:phpdengan direktori PHP Anda). - Uncomment ekstensi-ekstensi yang dibutuhkan oleh Laravel, seperti
extension=pdo_mysql,extension=openssl,extension=mbstring,extension=tokenizer,extension=xml,extension=ctype, danextension=json.
- Uncomment (hapus tanda titik koma) baris
1.2. Menginstal Composer (Composer Installation)
Composer adalah pengelola dependensi yang akan kita gunakan untuk cara install Laravel di Windows. Anda dapat mengunduhnya dari situs web resmi Composer: https://getcomposer.org/download/.
- Unduh Installer: Unduh installer Composer untuk Windows (
Composer-Setup.exe). - Jalankan Installer: Jalankan installer dan ikuti petunjuk yang diberikan. Pastikan untuk memilih direktori PHP yang sudah Anda instal pada langkah sebelumnya.
- Tambahkan ke PATH: Installer Composer akan secara otomatis menambahkan Composer ke PATH environment Anda. Ini memungkinkan Anda menjalankan perintah
composerdari command prompt atau terminal mana pun.
1.3. Verifikasi Instalasi: Cek PHP dan Composer di Command Prompt
Setelah menginstal PHP dan Composer, penting untuk memverifikasi bahwa instalasi berhasil dan keduanya dapat diakses dari command prompt.
- Buka Command Prompt: Buka Command Prompt (ketik
cmddi pencarian Windows dan tekan Enter). - Periksa PHP: Ketik
php -vdan tekan Enter. Anda seharusnya melihat informasi tentang versi PHP yang terinstal. Jika Anda mendapatkan pesan kesalahan, berarti PHP belum ditambahkan ke PATH environment Anda dengan benar. - Periksa Composer: Ketik
composer -vdan tekan Enter. Anda seharusnya melihat informasi tentang versi Composer yang terinstal. Jika Anda mendapatkan pesan kesalahan, berarti Composer belum ditambahkan ke PATH environment Anda dengan benar.
Jika PHP atau Composer belum ditambahkan ke PATH:
- Cari “Environment Variables” di pencarian Windows dan buka “Edit the system environment variables”.
- Klik “Environment Variables…”
- Di bagian “System variables”, cari variabel “Path” dan klik “Edit…”.
- Klik “New” dan tambahkan direktori PHP Anda (misalnya,
C:php). - Klik “New” dan tambahkan direktori Composer Anda (biasanya
C:UsersNamaPenggunaAppDataRoamingComposervendorbin). - Klik “OK” pada semua jendela yang terbuka.
- Tutup dan buka kembali Command Prompt agar perubahan PATH environment diterapkan.
2. Memulai Proyek Laravel: Cara Membuat Proyek Baru
Setelah lingkungan pengembangan Anda siap, sekarang kita bisa mulai membuat proyek Laravel baru. Composer menyediakan cara mudah untuk membuat proyek Laravel baru dengan perintah composer create-project.
2.1. Menggunakan composer create-project
Buka Command Prompt dan arahkan ke direktori di mana Anda ingin menyimpan proyek Laravel Anda. Misalnya, jika Anda ingin menyimpan proyek di C:xampphtdocs, Anda bisa menggunakan perintah berikut:
cd C:xampphtdocs
Setelah berada di direktori yang tepat, gunakan perintah berikut untuk membuat proyek Laravel baru:
composer create-project laravel/laravel nama-proyek
Ganti nama-proyek dengan nama proyek yang Anda inginkan. Misalnya, jika Anda ingin membuat proyek dengan nama blog, perintahnya akan menjadi:
composer create-project laravel/laravel blog
Perintah ini akan mengunduh dan menginstal Laravel beserta semua dependensinya ke dalam direktori blog. Proses ini mungkin memakan waktu beberapa menit, tergantung pada kecepatan internet Anda.
2.2. Alternatif: Menggunakan Laravel Installer
Selain composer create-project, Anda juga bisa menggunakan Laravel Installer untuk membuat proyek baru. Laravel Installer adalah package Composer global yang memungkinkan Anda membuat proyek Laravel baru dengan lebih mudah.
- Instal Laravel Installer: Jika Anda belum menginstal Laravel Installer, Anda bisa menginstalnya dengan perintah berikut:
composer global require laravel/installer
Pastikan direktori Composer Anda (biasanya C:UsersNamaPenggunaAppDataRoamingComposervendorbin) ada di PATH environment Anda agar perintah laravel bisa dikenali.
- Buat Proyek Baru: Setelah Laravel Installer terinstal, Anda bisa membuat proyek baru dengan perintah berikut:
laravel new nama-proyek
Ganti nama-proyek dengan nama proyek yang Anda inginkan. Misalnya, jika Anda ingin membuat proyek dengan nama blog, perintahnya akan menjadi:
laravel new blog
Perintah ini akan membuat proyek Laravel baru di direktori blog.
3. Konfigurasi Awal: Setting Environment dan Database
Setelah proyek Laravel berhasil dibuat, langkah selanjutnya adalah melakukan konfigurasi awal, termasuk mengatur environment dan konfigurasi database.
3.1. File .env: Mengatur Environment
Laravel menggunakan file .env untuk menyimpan konfigurasi environment, seperti koneksi database, kunci aplikasi, dan pengaturan lainnya. File .env tidak boleh disimpan di repository kode Anda, karena berisi informasi sensitif.
- Salin
.env.example: Setelah membuat proyek Laravel, Anda akan menemukan file.env.exampledi direktori proyek Anda. Salin file ini dan ubah namanya menjadi.env. - Generate
APP_KEY: Buka.envdengan editor teks. Anda akan melihat barisAPP_KEY=. Generate kunci aplikasi (application key) dengan perintah berikut:
php artisan key:generate
Perintah ini akan menghasilkan kunci aplikasi acak dan menyimpannya di file .env.
- Konfigurasi Lainnya: Anda juga bisa mengkonfigurasi pengaturan lain di file
.env, seperti nama aplikasi (APP_NAME), environment (APP_ENV), dan mode debug (APP_DEBUG).
3.2. Konfigurasi Database: Menghubungkan ke Database
Laravel mendukung berbagai jenis database, seperti MySQL, PostgreSQL, SQLite, dan SQL Server. Konfigurasi database dilakukan di file .env.
- Pengaturan Database MySQL: Jika Anda menggunakan MySQL, atur variabel berikut di file
.env:
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=nama_database
DB_USERNAME=nama_pengguna
DB_PASSWORD=kata_sandi
Ganti nama_database, nama_pengguna, dan kata_sandi dengan informasi database MySQL Anda. Pastikan MySQL server Anda berjalan.
- Membuat Database: Buat database yang Anda tentukan di file
.envmenggunakan tools seperti phpMyAdmin atau command line MySQL.
4. Menjalankan Aplikasi Laravel: Menggunakan Artisan Serve
Setelah konfigurasi awal selesai, Anda bisa menjalankan aplikasi Laravel Anda menggunakan server pengembangan bawaan PHP, yaitu Artisan Serve.
4.1. Perintah php artisan serve
Buka Command Prompt dan arahkan ke direktori proyek Laravel Anda. Kemudian, jalankan perintah berikut:
php artisan serve
Perintah ini akan memulai server pengembangan PHP dan menjalankan aplikasi Laravel Anda di alamat http://127.0.0.1:8000. Anda bisa membuka alamat ini di browser Anda untuk melihat aplikasi Laravel Anda.
4.2. Mengubah Port: Kustomisasi Port
Secara default, php artisan serve menjalankan aplikasi di port 8000. Anda bisa mengubah port dengan menambahkan opsi --port ke perintah php artisan serve:
php artisan serve --port=8080
Perintah ini akan menjalankan aplikasi Laravel Anda di alamat http://127.0.0.1:8080.
5. Troubleshooting: Mengatasi Masalah Umum
Selama proses cara install Laravel di Windows menggunakan Composer, Anda mungkin menghadapi beberapa masalah. Berikut adalah beberapa masalah umum dan cara mengatasinya:
- “Class ‘PDO’ not found”: Ini berarti ekstensi PDO PHP belum diaktifkan. Buka
php.inidan uncomment barisextension=pdo_mysql(atauextension=pdo_pgsqljika Anda menggunakan PostgreSQL). - “The stream or file “/path/to/your/project/storage/logs/laravel.log” could not be opened”: Ini berarti aplikasi Laravel tidak memiliki izin untuk menulis ke direktori
storage/logs. Anda bisa memberikan izin tulis ke direktori tersebut dengan perintah berikut:
chmod -R 777 storage bootstrap/cache
(Perhatikan: Perintah ini disarankan hanya untuk development environment, karena memberikan izin penuh kepada semua pengguna.)
- “No input file specified.”: Ini sering terjadi karena konfigurasi web server yang salah (jika Anda mencoba mengakses aplikasi melalui web server seperti Apache atau Nginx). Pastikan Anda telah mengkonfigurasi virtual host dengan benar dan mengarah ke direktori
publicdi proyek Laravel Anda.
6. Melangkah Lebih Jauh: Mempelajari Konsep Dasar Laravel
Setelah berhasil menginstal dan menjalankan aplikasi Laravel, langkah selanjutnya adalah mempelajari konsep dasar Laravel untuk membangun aplikasi web yang lebih kompleks.
6.1. Routing: Mengatur URL
Routing adalah proses menghubungkan URL ke controller atau closure function. Anda bisa mendefinisikan routes di file routes/web.php.
Route::get('/', function () {
return view('welcome');
});
Route di atas menghubungkan URL / ke view welcome.
6.2. Controller: Mengelola Logika Aplikasi
Controller adalah kelas yang berisi logika aplikasi. Anda bisa membuat controller dengan perintah berikut:
php artisan make:controller NamaController
Controller bisa berisi method untuk menangani request dan mengembalikan response.
6.3. View: Menampilkan Data
View adalah template yang digunakan untuk menampilkan data ke pengguna. Anda bisa membuat view di direktori resources/views. View menggunakan sintaks Blade template engine.
6.4. Model: Berinteraksi dengan Database
Model adalah kelas yang mewakili tabel di database. Anda bisa membuat model dengan perintah berikut:
php artisan make:model NamaModel
Model digunakan untuk berinteraksi dengan database, seperti mengambil data, menyimpan data, dan menghapus data.
6.5. Migration: Membuat dan Memodifikasi Tabel Database
Migration adalah file yang digunakan untuk membuat dan memodifikasi tabel database. Anda bisa membuat migration dengan perintah berikut:
php artisan make:migration create_nama_tabel_table
Migration memungkinkan Anda mengelola struktur database Anda dengan lebih mudah dan terstruktur.
7. Keamanan Laravel: Tips Penting
Keamanan adalah aspek krusial dalam pengembangan aplikasi web. Berikut adalah beberapa tips penting untuk menjaga keamanan aplikasi Laravel Anda:
- Gunakan HTTPS: Pastikan aplikasi Anda menggunakan HTTPS untuk mengenkripsi komunikasi antara server dan browser.
- Lindungi dari Cross-Site Scripting (XSS): Gunakan sintaks Blade template engine yang secara otomatis melakukan escaping terhadap output untuk mencegah XSS.
- Lindungi dari SQL Injection: Gunakan Eloquent ORM atau query builder untuk berinteraksi dengan database. Hindari menulis query SQL secara manual.
- Validasi Input: Selalu validasi input pengguna untuk mencegah data yang berbahaya masuk ke aplikasi Anda.
- Gunakan CSRF Protection: Laravel secara otomatis menyediakan CSRF protection untuk melindungi aplikasi Anda dari serangan Cross-Site Request Forgery.
- Perbarui Laravel dan Dependensi Secara Teratur: Pastikan Anda selalu menggunakan versi Laravel terbaru dan memperbarui dependensi Anda secara teratur untuk mendapatkan perbaikan keamanan terbaru.
8. Sumber Belajar Laravel: Dokumentasi dan Komunitas
Laravel memiliki dokumentasi yang lengkap dan komunitas yang besar. Anda bisa memanfaatkan sumber-sumber ini untuk belajar Laravel lebih dalam dan mendapatkan bantuan jika Anda mengalami masalah.
- Dokumentasi Resmi Laravel: https://laravel.com/docs/
- Laravel News: https://laravel-news.com/
- Laravel Forums: https://laracasts.com/discuss
- Stack Overflow: https://stackoverflow.com/questions/tagged/laravel
9. Kesimpulan: Selamat Membangun Aplikasi Web dengan Laravel!
Selamat! Anda telah berhasil mengikuti panduan lengkap cara install Laravel di Windows menggunakan Composer. Sekarang Anda siap untuk memulai petualangan Anda membangun aplikasi web yang luar biasa dengan Laravel. Ingatlah untuk terus belajar, berlatih, dan berpartisipasi dalam komunitas Laravel untuk meningkatkan kemampuan Anda. Dengan dedikasi dan kerja keras, Anda akan menjadi seorang developer Laravel yang handal. Selamat berkarya!









