Instal PHP, Composer & Proyek Laravel Pertama

Pendahuluan — mendirikan toko sebelum jual buku

Artikel ini adalah #56 (ini) di Seri 4: Pemrograman Web Lanjut v2. Setelah jembatan OOP PHP dari Mengenal OOP (#53) hingga Visibility (#55), kamu mulai jalur Laravel — langkah 1/8.

Di Visibility & Composition (#55) kamu sudah punya object Buku dan Katalog di PHP biasa. Sekarang kita siapkan rumah kerja Laravel: PHP, Composer, lalu proyek baru bernama perpustakaan-api (nama awam — nanti dipakai untuk API perpustakaan mini).

Awam: bayangkan mau jual buku di pasar. Sebelum display buku, kamu butuh mendirikan toko dulu — atap, meja, kasir. PHP + Composer + proyek Laravel = toko itu. Baru setelahnya kita isi rak buku (routing, data, API).

Jika class/object masih baru, singgah sebentar ke Property, Method & Constructor (#54) — fondasi OOP ringan sebelum masuk framework.

Prasyarat: sudah baca Visibility & Composition (#55) — paham class/object ringan. Domain tetap perpustakaan mini. Pakai Laravel 13+ (versi terbaru resmi) — butuh PHP 8.3+.

Spesifikasi fitur — apa yang kita pasang?

Daftar singkat yang bisa kamu centang di akhir artikel:

1. PHP 8.3+ jalan di terminal (php -v) — syarat Laravel 13.
2. Composer terpasang (composer -V).
3. Proyek Laravel baru lewat composer create-project — folder perpustakaan-api.
4. Artisan hidup (php artisan --version) dan server lokal (php artisan serve) menampilkan halaman welcome.

Awam: urutan nyaman: PHP dulu -> Composer -> buat proyek -> cek -> jalankan server. Jangan loncat ke kode API sebelum toko berdiri.

Istilah — ringkas untuk instalasi

Urutan belajar: pasang alat -> buat folder proyek -> cek versi -> hidupkan server lokal.

Kenapa instal dulu?

Laravel bukan satu file yang bisa disalin sembarang. Ia butuh PHP versi cukup baru, banyak file pendukung, dan Composer untuk mengunduhnya rapi. Kalau kamu langsung membuka tutorial routing tanpa PHP/Composer, error-nya sering membingungkan: “command not found”, “Class not found”, atau versi PHP terlalu tua.

Awam: sama seperti perpustakaan — sebelum menerima peminjaman, pastikan loket, buku besar, dan stempel sudah ada. Instalasi = menyiapkan loket. API perpustakaan datang setelah fondasi ini.

Artikel ini sengaja install-dari-nol: setiap langkah bisa diikuti di komputer Windows awam (Laragon/XAMPP) tanpa asumsi Laravel sudah terpasang.

Alur instal — dari nol sampai proyek hidup

Laragon (atau XAMPP) — PHP di Windows

Jalur utama Windows: pasang Laragon (disarankan) atau XAMPP. Keduanya sudah menyertakan PHP — kamu tidak perlu mengunduh PHP terpisah untuk langkah awal. Tautan unduh ada di langkah 1 di bawah.

1. Unduh Laragon (disarankan) atau XAMPP dari situs resmi, lalu instal seperti aplikasi biasa.
2. Buka Laragon, klik Start All (Apache/MySQL boleh hidup — untuk Laravel kita fokus PHP dulu).
3. Buka terminal Laragon (menu Terminal) lalu ketik:

php -v

Output yang sehat menampilkan PHP 8.3 atau lebih baru (Laravel 13 tidak menerima PHP 8.2). Contoh bentuknya:

<?php
// Simulasi output php -v (bukan perintah sungguhan — hanya bentuk teks).
echo "PHP 8.3.12 (cli) (built: Oct 24 2024 00:00:00)", PHP_EOL;
echo "Copyright (c) The PHP Group", PHP_EOL;

Awam: kalau terminal bilang php tidak dikenali, PHP belum masuk PATH — restart Laragon atau buka terminal dari menu Laragon, bukan CMD acak.

Composer — pengelola paket PHP

Setelah PHP hidup, pasang Composer dari getcomposer.org (installer Windows). Composer mengunduh Laravel dan dependensinya ke folder proyek.

composer -V

Contoh output yang kamu harapkan:

<?php
// Simulasi output composer -V.
echo "Composer version 2.8.3 2024-11-12 15:00:00", PHP_EOL;

Awam: Composer seperti kurir yang mengantar rak, label, dan perlengkapan toko Laravel — kamu tidak mengunduh ribuan file manual.

create-project — lahirkan proyek Laravel

Pilih folder kerja (misalnya C:\laragon\www di Laragon). Lalu jalankan:

composer create-project laravel/laravel perpustakaan-api

Perintah ini membuat folder perpustakaan-api berisi kerangka Laravel 13+ (yang diunduh Composer saat ini). Proses bisa beberapa menit — normal. Nama perpustakaan-api mengingatkan bahwa proyek ini nanti dipakai untuk API perpustakaan mini.

Masuk ke folder proyek:

cd perpustakaan-api

Awam: create-project = paket “toko siap bangun”. Isi rak buku (route, model) kita tambah di artikel berikutnya.

Cek versi & artisan serve

Tiga cek cepat sebelum lanjut:

php -v
composer -V
php artisan --version

Contoh output Artisan (bentuk mirip):

<?php
// Simulasi output php artisan --version.
echo "Laravel Framework 13.0.0", PHP_EOL;

Hidupkan server pengembangan bawaan:

php artisan serve

Buka browser ke alamat yang muncul (biasanya http://127.0.0.1:8000). Kamu harus melihat halaman welcome Laravel — artinya proyek hidup.

Awam: artisan serve = menyalakan lampu toko sementara di komputermu. Matikan dengan Ctrl+C di terminal.

Alternatif singkat — PHP di PATH + Composer resmi

Jika tidak memakai Laragon/XAMPP: unduh PHP zip dari windows.php.net, ekstrak, tambahkan folder PHP ke PATH Windows, lalu pasang Composer installer. Setelah php -v dan composer -V sama-sama jalan, langkah create-project dan artisan serve identik dengan atas.

Pola Dasar — enam langkah instal bersih

Demo cek versi — file mandiri

Simpan sebagai laravel_instalasi_proyek_pertama_demo.php, lalu jalankan php laravel_instalasi_proyek_pertama_demo.php. File ini mensimulasikan output cek versi — tidak butuh Laravel terpasang:

<?php
declare(strict_types=1);

/**
 * Demo cek versi instalasi — simulasi string output.
 */

function cekVersi(string $label, string $perintah, string $outputSimulasi, bool $lulus): array
{
    return [
        "label" => $label,
        "perintah" => $perintah,
        "output" => $outputSimulasi,
        "lulus" => $lulus,
    ];
}

function demo(): void
{
    $cek = [
        cekVersi("PHP", "php -v", "PHP 8.3.12 (cli)", true),
        cekVersi("Composer", "composer -V", "Composer version 2.8.3", true),
        cekVersi("Artisan", "php artisan --version", "Laravel Framework 13.0.0", true),
        cekVersi("Server", "php artisan serve", "Server running on http://127.0.0.1:8000", true),
    ];

    echo "=== Demo cek instal Laravel ===", PHP_EOL;
    foreach ($cek as $baris) {
        $status = $baris["lulus"] ? "OK" : "GAGAL";
        echo "[{$status}] {$baris["label"]}: {$baris["perintah"]}", PHP_EOL;
        echo "  -> {$baris["output"]}", PHP_EOL;
    }
    echo PHP_EOL, "Semua cek simulasi lulus — siap lanjut ke struktur proyek.", PHP_EOL;
}

demo();

Awam: demo() hanya menampilkan contoh teks yang kamu harapkan dari terminal sungguhan. declare(strict_types=1); membuat tipe lebih ketat — boleh diikuti, tidak wajib dihafal. Setelah instal nyata, bandingkan output-mu dengan baris di atas.

Kesalahan umum

Latihan

1. Jalankan demo PHP di atas, lalu jalankan php -v sungguhan — bandingkan baris versinya.
2. Buat proyek dengan nama lain (mis. perpustakaan-coba) dan pastikan halaman welcome muncul.
3. Jelaskan ke teman analogi “mendirikan toko sebelum jual buku” untuk instal Laravel.

FAQ

Harus pakai Laragon?
Tidak wajib. Laragon/XAMPP hanya jalur paling nyaman di Windows. Yang wajib: PHP 8.3+ dan Composer jalan di terminal yang sama (syarat Laravel 13).

Kenapa bukan Laravel 11 lagi?
Versi terbaru resmi saat artikel ini ditulis adalah Laravel 13 — butuh PHP 8.3 sampai 8.5. Kalau php -v masih 8.2, upgrade PHP di Laragon dulu sebelum create-project.

Boleh pakai nama folder selain perpustakaan-api?
Boleh. Nama itu hanya pengingat domain perpustakaan — yang penting kamu tahu lokasi foldernya.

Ke mana setelah ini?
Berikutnya: Struktur Folder, .env & Artisan Laravel (#57) — kenali denah folder, pengaturan, dan perintah Artisan sehari-hari sebelum routing JSON.

Kesimpulan

Kamu sudah menyiapkan fondasi Laravel dari nol: PHP, Composer, proyek perpustakaan-api lewat create-project, cek artisan --version, dan php artisan serve dengan halaman welcome. Ini langkah 1/8 jalur Laravel di Seri 4.

Seri 4 progress: langkah #56 (ini) · 1/8 jalur Laravel · prasyarat: Visibility & Composition (#55) LIVE. Berikutnya: Struktur Folder, .env & Artisan Laravel (#57).