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

Persiapan — alat yang kamu buka

Alat yang dipakai di artikel ini (semua gratis):

• Browser — unduh Laragon/XAMPP/Composer, dan nanti membuka halaman welcome Laravel.
• Laragon (disarankan) atau XAMPP — aplikasi yang membawa PHP di Windows. Di Laragon ada menu Terminal; di XAMPP pakai tombol Shell (lihat catatan di bawah).
• Terminal — tempat mengetik php, composer, dan php artisan …. Di jalur utama: buka dari menu Terminal Laragon (bukan sembarang CMD yang belum kenal PHP).
• Explorer (opsional) — melihat folder C:\laragon\www dan proyek perpustakaan-api.
• Editor teks — Notepad / VS Code — hanya untuk file demo PHP di akhir artikel (bukan wajib untuk instal Laravel).

Awam: urutan nyaman: pasang aplikasi -> buka terminal yang benar -> ketik perintah -> cek di browser. Jangan loncat ke create-project sebelum php -v dan composer -V jalan.

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. Buka browser, unduh Laragon (disarankan) atau XAMPP dari situs resmi, lalu instal seperti aplikasi biasa (klik Next sampai selesai).
2. Buka aplikasi Laragon, klik Start All (Apache/MySQL boleh hidup — untuk Laravel kita fokus PHP dulu).
3. Di jendela Laragon, buka menu Terminal (ini terminal yang sudah “kenal” PHP). Lalu ketik perintah di bawah dan tekan Enter:

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 lagi terminal dari menu Laragon, bukan CMD/PowerShell acak dari Start Menu.

Kalau kamu pakai XAMPP (bukan Laragon):

1. Buka aplikasi XAMPP Control Panel.
2. Klik tombol Shell (bukan asal buka CMD dari Start Menu) — itu terminal yang biasanya sudah “kenal” PHP XAMPP.
3. Ketik php -v. Harus muncul PHP 8.3+. Kalau lebih tua, upgrade paket PHP di XAMPP atau pilih jalur Laragon.
4. Folder kerja umum: C:\xampp\htdocs — nanti cd C:\xampp\htdocs sebelum create-project (setara C:\laragon\www di Laragon).

Awam: Laragon = menu Terminal. XAMPP = tombol Shell. Intinya sama: ketik perintah di jendela yang sudah terhubung ke PHP.

Composer — pengelola paket PHP

Setelah php -v sukses di terminal Laragon (atau Shell XAMPP):

1. Buka browser, unduh installer Windows dari getcomposer.org.
2. Jalankan file installer (klik dua kali), ikuti Next. Biarkan installer mendeteksi PHP dari Laragon/XAMPP bila ditanya.
3. Tutup lalu buka lagi terminal Laragon / Shell XAMPP (supaya PATH Composer terbaca), lalu ketik:

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. Cek composer -V di terminal yang sama tempat php -v sudah jalan.

create-project — lahirkan proyek Laravel

Masih di terminal Laragon (atau Shell XAMPP). Masuk dulu ke folder kerja (contoh jalur Laragon):

cd C:\laragon\www

Kalau foldernya belum ada, buat dulu lewat Explorer atau mkdir C:\laragon\www. Di XAMPP biasanya: cd C:\xampp\htdocs. 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; biarkan terminal bekerja sampai selesai. 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. Pastikan prompt terminal sudah berada di dalam perpustakaan-api sebelum perintah Artisan.

Cek versi & artisan serve

Masih di folder perpustakaan-api, tiga cek cepat sebelum lanjut (ketik satu per satu, Enter):

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

Biarkan jendela terminal ini tetap hidup (jangan ditutup). Buka browser (Chrome/Edge/Firefox), ketik alamat yang muncul di terminal (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 yang menjalankan serve.

Alternatif singkat — PHP di PATH + Composer resmi

Jika tidak memakai Laragon/XAMPP, kamu bisa memasang PHP manual. Ringkasnya:

1. Buka browser, unduh PHP zip berlabel Thread Safe dari windows.php.net.
   Awam: Thread Safe = paket PHP yang biasa dipakai untuk belajar di Windows (pilih yang bertuliskan itu di situs unduhan — jangan bingung dengan paket Non Thread Safe kecuali panduan lain memintanya).
2. Ekstrak ke folder tetap, misalnya C:\php (ingat path ini).
3. Tambahkan folder itu ke PATH Windows supaya perintah php dikenali di terminal mana pun:
   • Tekan tombol Windows, ketik environment, buka Edit the system environment variables / Edit variabel lingkungan sistem.
   • Klik Environment Variables… / Variabel lingkungan….
   • Di bagian User atau System, pilih baris Path, klik Edit.
   • Klik New, tulis C:\php (sesuai folder ekstrakmu), OK semua jendela.
   • Tutup semua terminal lama, buka terminal baru, ketik php -v.
4. Pasang Composer installer dari getcomposer.org (sama seperti bagian Composer di atas).

Setelah php -v dan composer -V sama-sama jalan, langkah create-project dan artisan serve identik dengan jalur Laragon. Folder kerja boleh kamu pilih sendiri (misalnya C:\proyek).

Awam: PATH = daftar alamat folder yang Windows cari saat kamu mengetik nama perintah. Tanpa PATH, terminal bilang “tidak dikenali” meski file php.exe sudah ada.

Pola Dasar — enam langkah instal bersih

Demo cek versi — file mandiri

Latihan membaca bentuk output (tanpa mengubah proyek Laravel):

1. Buka editor teks, buat file baru, tempel cuplikan di bawah, simpan sebagai laravel_instalasi_proyek_pertama_demo.php (boleh di Desktop).
2. Buka terminal di folder tempat file itu disimpan (Explorer: Shift+klik kanan folder -> “Open in Terminal” / “Buka di Terminal”, atau cd manual). Pastikan php -v sudah jalan di terminal itu.
3. Jalankan: php laravel_instalasi_proyek_pertama_demo.php — layar menampilkan contoh teks cek versi.

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).

Terminal mana yang harus dibuka?
Di jalur utama: terminal dari menu Laragon (setelah Start All). Di XAMPP: tombol Shell di Control Panel. Kalau kamu buka CMD/PowerShell dari Start Menu dan php tidak dikenali, hampir selalu karena PATH — kembali ke terminal Laragon/Shell XAMPP, atau ikuti bagian alternatif PATH.

Apa itu PATH Windows?
Daftar folder yang dicari sistem saat kamu mengetik perintah. Cara menambahkannya ada di bagian Alternatif singkat — PHP di PATH di atas (Environment Variables / Variabel lingkungan).

Harus install editor seperti VS Code dulu?
Tidak wajib untuk instalasi. Editor hanya membantu menyimpan file demo di akhir artikel. Mengedit kode Laravel dimulai lebih serius di langkah berikutnya.

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).