Menginstal Laravel 10 dengan PHP 8.1 pada Command Line Khusus (Ketika Anda Memiliki Banyak Versi PHP)

Laravel 10 adalah framework PHP yang kuat dan elegan, namun penginstalannya bisa sedikit rumit, terutama jika Anda memiliki beberapa versi PHP yang terinstal di sistem Anda. Artikel ini akan memandu Anda melalui proses menginstal Laravel 10 dengan PHP 8.1 menggunakan command line khusus, memastikan bahwa proyek Anda menggunakan versi PHP yang benar. Kami akan membahas semua langkah, mulai dari pemeriksaan prasyarat hingga verifikasi instalasi.

Daftar Isi

1. Pendahuluan
2. Prasyarat
3. Memeriksa Versi PHP yang Terinstal
4. Mengidentifikasi Path PHP 8.1
5. Membuat Alias PHP 8.1 (Opsional)
6. Menginstal Composer (atau Memastikan Composer Menggunakan PHP 8.1)
7. Membuat Proyek Laravel 10 Menggunakan PHP 8.1
8. Konfigurasi Awal Proyek Laravel
9. Menjalankan Server Pengembangan Laravel
10. Pemecahan Masalah Umum
11. Kesimpulan

Pendahuluan

Mengembangkan aplikasi web dengan Laravel sering kali melibatkan penggunaan versi PHP tertentu untuk memastikan kompatibilitas dan memanfaatkan fitur-fitur terbaru. Jika Anda bekerja dengan beberapa proyek yang memerlukan versi PHP yang berbeda, Anda perlu mengelola beberapa instalasi PHP secara paralel. Artikel ini berfokus pada cara menginstal Laravel 10 secara khusus menggunakan PHP 8.1, bahkan ketika Anda memiliki versi PHP lain yang terinstal di sistem Anda. Dengan mengikuti langkah-langkah yang dijelaskan, Anda dapat memastikan bahwa proyek Laravel 10 Anda menggunakan versi PHP yang diinginkan tanpa memengaruhi proyek lain yang mungkin bergantung pada versi PHP yang berbeda.

Prasyarat

Sebelum Anda mulai, pastikan Anda memiliki prasyarat berikut:

1. Sistem Operasi: Windows, macOS, atau Linux.
2. PHP 8.1: Terinstal dan dikonfigurasi dengan benar di sistem Anda.
3. Composer: Pengelola dependensi PHP harus terinstal.
4. Web Server: Apache atau Nginx (opsional, tetapi diperlukan untuk men-deploy aplikasi Anda).
5. Database: MySQL, PostgreSQL, SQLite, atau SQL Server (pilih salah satu).
6. Command Line Interface (CLI): Akses ke terminal atau command prompt.

Memeriksa Versi PHP yang Terinstal

Langkah pertama adalah mengidentifikasi versi PHP yang terinstal di sistem Anda. Buka terminal atau command prompt dan jalankan perintah berikut:

php -v

Perintah ini akan menampilkan informasi tentang versi PHP default yang digunakan oleh sistem. Jika Anda memiliki beberapa versi PHP yang terinstal, Anda mungkin perlu menentukan versi mana yang ingin Anda gunakan untuk menginstal Laravel 10. Perhatikan output dari perintah ini. Ini penting untuk menentukan apakah PHP 8.1 adalah versi default, dan jika bukan, bagaimana cara mengaksesnya.

Jika PHP 8.1 belum terinstal, Anda harus menginstalnya terlebih dahulu. Prosedur instalasi berbeda-beda tergantung pada sistem operasi Anda:

• Windows: Gunakan XAMPP, WAMP, atau instal PHP secara manual.
• macOS: Gunakan Homebrew atau instal PHP secara manual.
• Linux (Ubuntu/Debian): Gunakan apt package manager.
• Linux (CentOS/RHEL): Gunakan yum package manager.

Setelah PHP 8.1 terinstal, lanjutkan ke langkah berikutnya.

Mengidentifikasi Path PHP 8.1

Untuk memastikan Composer dan Laravel menggunakan PHP 8.1, Anda perlu mengetahui path lengkap ke executable PHP 8.1. Path ini akan digunakan dalam perintah Composer dan Laravel. Berikut adalah cara menemukan path-nya:

1. Windows: Biasanya terletak di direktori instalasi PHP 8.1, misalnya C:\php\php8.1\php.exe. Anda mungkin perlu menjelajahi direktori instalasi PHP Anda untuk menemukannya.
2. macOS (Homebrew): Biasanya terletak di /usr/local/opt/php@8.1/bin/php. Anda dapat menggunakan perintah which php di terminal setelah mengatur PATH Anda dengan benar untuk PHP 8.1.
3. Linux: Lokasi bervariasi tergantung pada distribusi Anda. Cobalah perintah berikut:
• which php8.1
• whereis php8.1
• locate php8.1

Catat path lengkap ke executable PHP 8.1. Anda akan membutuhkannya di langkah selanjutnya.

Membuat Alias PHP 8.1 (Opsional)

Untuk kenyamanan, Anda dapat membuat alias untuk perintah PHP 8.1. Ini memungkinkan Anda untuk merujuk ke PHP 8.1 menggunakan alias yang lebih pendek, seperti `php81`. Ini bersifat opsional, tetapi dapat menyederhanakan perintah Anda.

1. Linux/macOS: Edit file .bashrc, .zshrc, atau file konfigurasi shell Anda yang sesuai dan tambahkan baris berikut (ganti `/path/ke/php8.1/php` dengan path yang sebenarnya):

   alias php81="/path/ke/php8.1/php"

   Simpan file dan jalankan source ~/.bashrc atau source ~/.zshrc untuk menerapkan perubahan.

2. Windows: Anda dapat membuat alias menggunakan perintah `doskey`. Buka Command Prompt sebagai administrator dan jalankan:

   doskey php81="C:\php\php8.1\php.exe" $*

   Perhatikan bahwa alias ini hanya berlaku untuk sesi Command Prompt saat ini. Untuk membuat alias permanen, Anda dapat menambahkannya ke variabel lingkungan sistem.

Setelah alias dibuat, Anda dapat menggunakan `php81 -v` untuk memverifikasi bahwa alias berfungsi dengan benar.

Menginstal Composer (atau Memastikan Composer Menggunakan PHP 8.1)

Composer adalah pengelola dependensi PHP yang digunakan untuk menginstal Laravel dan dependensinya. Jika Anda belum menginstal Composer, ikuti langkah-langkah berikut:

1. Unduh Composer: Buka situs web Composer dan unduh installer.
2. Jalankan Installer: Jalankan installer dan ikuti petunjuknya. Pastikan Anda menentukan path ke executable PHP 8.1 selama proses instalasi. Jika installer tidak meminta Anda untuk memilih versi PHP, itu mungkin menggunakan versi PHP default sistem. Dalam hal ini, Anda perlu menyesuaikan pengaturan Composer secara manual setelah instalasi.

Jika Composer sudah terinstal, Anda perlu memastikan bahwa ia menggunakan PHP 8.1. Anda dapat melakukan ini dengan mengonfigurasi variabel lingkungan atau menggunakan opsi command-line.

Mengonfigurasi Variabel Lingkungan (Jika Diperlukan):

Composer menggunakan variabel lingkungan `PHP_BINARY` untuk menentukan executable PHP yang akan digunakan. Jika variabel ini tidak diatur, Composer akan menggunakan versi PHP default sistem. Untuk memastikan Composer menggunakan PHP 8.1, Anda dapat mengatur variabel lingkungan ini.

1. Windows:
1. Buka “System Properties” (Anda dapat mencarinya di menu Start).
2. Klik “Environment Variables”.
3. Di bagian “System variables”, klik “New”.
4. Masukkan `PHP_BINARY` sebagai nama variabel dan path ke executable PHP 8.1 (misalnya, `C:\php\php8.1\php.exe`) sebagai nilai variabel.
5. Klik “OK” untuk menyimpan perubahan.
2. Linux/macOS: Tambahkan baris berikut ke file .bashrc, .zshrc, atau file konfigurasi shell Anda yang sesuai (ganti `/path/ke/php8.1/php` dengan path yang sebenarnya):

   export PHP_BINARY="/path/ke/php8.1/php"

   Simpan file dan jalankan source ~/.bashrc atau source ~/.zshrc untuk menerapkan perubahan.

Memverifikasi Versi PHP yang Digunakan oleh Composer:

Setelah menginstal atau mengonfigurasi Composer, verifikasi bahwa ia menggunakan PHP 8.1 dengan menjalankan perintah berikut:

composer -v

Periksa outputnya. Output harus menunjukkan bahwa Composer menggunakan PHP 8.1. Jika output menunjukkan versi PHP yang berbeda, tinjau langkah-langkah instalasi dan konfigurasi Composer Anda.

Selain variabel lingkungan, Anda juga dapat menentukan versi PHP yang akan digunakan dengan Composer secara eksplisit menggunakan opsi command-line `–php`. Namun, ini akan membuat perintah Anda lebih panjang dan rumit. Mengatur variabel lingkungan `PHP_BINARY` biasanya merupakan solusi yang lebih baik.

Membuat Proyek Laravel 10 Menggunakan PHP 8.1

Sekarang setelah Anda memiliki PHP 8.1 dan Composer yang dikonfigurasi dengan benar, Anda dapat membuat proyek Laravel 10 baru menggunakan perintah `composer create-project`.

1. Buka Terminal atau Command Prompt: Buka terminal atau command prompt dan navigasikan ke direktori tempat Anda ingin membuat proyek Laravel Anda.
2. Jalankan Perintah `create-project`: Jalankan perintah berikut (ganti `nama-proyek` dengan nama proyek Anda):

   composer create-project --prefer-dist laravel/laravel nama-proyek

   Jika Anda tidak membuat alias PHP 8.1 dan Composer tidak menggunakan PHP 8.1 secara default, Anda dapat menambahkan opsi `–php` ke perintah untuk menentukan executable PHP 8.1 secara eksplisit:

   composer create-project --prefer-dist laravel/laravel nama-proyek --php /path/ke/php8.1/php

   Namun, menggunakan opsi `–php` disarankan hanya jika Anda mengalami masalah dengan konfigurasi default Composer Anda.

3. Tunggu Instalasi Selesai: Composer akan mengunduh Laravel dan dependensinya. Ini mungkin memakan waktu beberapa menit tergantung pada kecepatan internet Anda.

Setelah instalasi selesai, Anda akan memiliki proyek Laravel 10 baru di direktori yang Anda tentukan.

Konfigurasi Awal Proyek Laravel

Setelah proyek Laravel Anda dibuat, Anda perlu melakukan beberapa konfigurasi awal.

1. Navigasikan ke Direktori Proyek: Buka terminal atau command prompt dan navigasikan ke direktori proyek Laravel Anda:

   cd nama-proyek

2. Salin File `.env.example`: Salin file `.env.example` ke `.env`:

   cp .env.example .env

   (Di Windows, gunakan `copy .env.example .env`)

3. Hasilkan Aplikasi Key: Hasilkan aplikasi key menggunakan perintah `php artisan key:generate`:

   php artisan key:generate

   Jika Anda belum membuat alias PHP 8.1 dan versi PHP default sistem Anda bukan PHP 8.1, Anda mungkin perlu menggunakan path lengkap ke executable PHP 8.1:

   /path/ke/php8.1/php artisan key:generate

   Atau, jika Anda membuat alias PHP 8.1:

   php81 artisan key:generate

4. Konfigurasikan Koneksi Database: Edit file `.env` dan konfigurasikan pengaturan koneksi database Anda. Atur variabel `DB_CONNECTION`, `DB_HOST`, `DB_PORT`, `DB_DATABASE`, `DB_USERNAME`, dan `DB_PASSWORD` agar sesuai dengan konfigurasi database Anda.

Konfigurasi awal sekarang sudah selesai.

Menjalankan Server Pengembangan Laravel

Laravel dilengkapi dengan server pengembangan bawaan yang dapat Anda gunakan untuk menjalankan aplikasi Anda. Untuk menjalankan server pengembangan, gunakan perintah `php artisan serve`:

php artisan serve

Jika Anda belum membuat alias PHP 8.1 dan versi PHP default sistem Anda bukan PHP 8.1, Anda mungkin perlu menggunakan path lengkap ke executable PHP 8.1:

/path/ke/php8.1/php artisan serve

Atau, jika Anda membuat alias PHP 8.1:

php81 artisan serve

Perintah ini akan memulai server pengembangan dan menampilkan URL tempat aplikasi Anda dapat diakses (biasanya `http://localhost:8000`). Buka URL ini di browser web Anda untuk melihat aplikasi Laravel 10 Anda berjalan.

Untuk menghentikan server pengembangan, tekan `Ctrl+C` di terminal atau command prompt.

Pemecahan Masalah Umum

Berikut adalah beberapa masalah umum yang mungkin Anda temui dan cara mengatasinya:

• `php` tidak dikenali sebagai perintah internal atau eksternal: Ini berarti bahwa PHP tidak ditambahkan ke PATH sistem Anda. Anda perlu menambahkan direktori instalasi PHP ke PATH Anda.
• Composer melaporkan kesalahan tentang versi PHP: Ini berarti bahwa Composer menggunakan versi PHP yang salah. Pastikan Anda telah mengonfigurasi variabel lingkungan `PHP_BINARY` dengan benar atau menggunakan opsi command-line `–php` saat menjalankan perintah Composer.
• `php artisan` melaporkan kesalahan tentang dependensi yang hilang: Ini berarti bahwa beberapa dependensi Laravel tidak terinstal. Coba jalankan `composer install` untuk menginstal dependensi yang hilang.
• Server pengembangan tidak berfungsi: Pastikan Anda telah mengonfigurasi koneksi database Anda dengan benar di file `.env`. Periksa juga log server (di direktori `storage/logs`) untuk kesalahan.

Jika Anda mengalami masalah lain, cari solusi di internet atau tanyakan di forum atau komunitas Laravel.

Kesimpulan

Menginstal Laravel 10 dengan PHP 8.1 di sistem dengan banyak versi PHP memerlukan perhatian terhadap detail dan pemahaman tentang bagaimana Composer dan Laravel menggunakan PHP. Dengan mengikuti langkah-langkah yang diuraikan dalam artikel ini, Anda dapat memastikan bahwa proyek Laravel 10 Anda menggunakan versi PHP yang benar dan dapat menghindari masalah kompatibilitas. Ingatlah untuk selalu memverifikasi versi PHP yang digunakan oleh Composer dan Laravel, dan gunakan alias atau variabel lingkungan untuk menyederhanakan perintah Anda. Dengan sedikit usaha, Anda dapat memiliki lingkungan pengembangan yang berfungsi dengan baik untuk proyek Laravel 10 Anda.

Artikel ini mencakup:

• Pemeriksaan Prasyarat: Memastikan semua persyaratan terpenuhi sebelum memulai proses instalasi.
• Identifikasi dan Konfigurasi PHP 8.1: Menemukan path ke executable PHP 8.1 dan mengonfigurasi Composer untuk menggunakannya.
• Pembuatan Proyek Laravel: Membuat proyek Laravel 10 baru menggunakan perintah `composer create-project`.
• Konfigurasi Awal: Melakukan konfigurasi awal proyek Laravel, seperti menghasilkan aplikasi key dan mengonfigurasi koneksi database.
• Menjalankan Server Pengembangan: Memulai server pengembangan Laravel dan mengakses aplikasi di browser web.
• Pemecahan Masalah: Mengatasi masalah umum yang mungkin timbul selama proses instalasi.

Semoga panduan ini membantu Anda menginstal Laravel 10 dengan PHP 8.1 dengan sukses! Selamat mengembangkan!