Harnessing the Power of Open Source with Ubuntu

Cara Menginstal PHP di Ubuntu: Panduan Lengkap dari Pemula hingga Mahir (Ubuntu 22.04 LTS)

Pengaturan Lingkungan Pengembangan

.## 1. Pendahuluan

目次

Mengapa Menggunakan PHP di Ubuntu

PHP adalah bahasa skrip sisi server yang banyak digunakan dalam berbagai aplikasi web, termasuk WordPress. Bahasa ini telah digunakan secara luas dalam pengembangan web selama bertahun‑tahun, dan banyak platform CMS serta kerangka kerja dibangun di atas PHP.

Ubuntu adalah distribusi Linux yang sangat stabil dan digunakan oleh pengembang di seluruh dunia, terutama cocok untuk lingkungan server. Kombinasi Ubuntu dan PHP banyak diadopsi, mulai dari setup pengembangan pribadi hingga sistem produksi kelas perusahaan.

Target Pembaca dan Tujuan Artikel Ini

Artikel ini ditujukan untuk beragam pengguna, mulai dari pemula yang ingin menginstal PHP di Ubuntu tetapi belum tahu harus mulai dari mana, hingga pengguna menengah yang perlu menginstal versi PHP tertentu. Prosedur dijelaskan sejelas mungkin.

Instruksi didasarkan pada Ubuntu 22.04 LTS, namun langkah‑langkah dasar yang sama juga berlaku untuk versi lain.

Apa yang Akan Anda Pelajari

Dengan membaca artikel ini, Anda akan dapat memahami dan mempraktikkan hal‑hal berikut:

  • Metode dasar untuk menginstal PHP di Ubuntu
  • Cara menginstal dan beralih antar beberapa versi PHP
  • Cara memverifikasi operasi PHP dan memecahkan masalah
  • Konfigurasi integrasi dengan Apache dan Nginx
  • Cara menginstal modul PHP yang umum digunakan

2. Prasyarat dan Persiapan

Cara Memeriksa Versi Ubuntu Anda

Pertama, periksa versi Ubuntu yang Anda gunakan. Metode instalasi PHP dan modul yang didukung dapat sedikit berbeda tergantung pada versi Ubuntu.

Anda dapat memeriksa versi Ubuntu dengan menjalankan perintah berikut:

lsb_release -a

Atau, Anda dapat menggunakan perintah ini:

cat /etc/os-release

Artikel ini menjelaskan prosedur berdasarkan Ubuntu 22.04 LTS, namun langkah‑langkah yang sama umumnya berlaku untuk Ubuntu 20.04 dan 23.10.

Jaga Paket Sistem Tetap Terbaru

Sebelum menginstal PHP, sangat penting untuk memperbarui semua paket sistem. Hal ini membantu mencegah masalah ketergantungan dan konflik.

sudo apt update
sudo apt upgrade -y

Perintah ini memperbarui indeks paket APT dan memastikan semua paket dapat dipasang dalam versi stabil terbaru mereka.

Instal Utilitas yang Diperlukan

Beberapa versi PHP memerlukan alat tambahan untuk mengelola repositori. Paket software-properties-common diperlukan untuk menambahkan repositori seperti PPA.

Jika belum terinstal, instal dengan perintah berikut:

sudo apt install -y software-properties-common

Paket ini diperlukan untuk perintah seperti add-apt-repository, yang umum digunakan saat menginstal versi PHP tertentu melalui PPA.

Menggunakan Hak Akar atau sudo

Sebagian besar operasi yang diperkenalkan dalam artikel ini memerlukan perubahan pada level sistem. Pastikan untuk menggunakan sudo saat menjalankan perintah.

3. Cara Menginstal PHP

Ada dua cara utama untuk menginstal PHP di Ubuntu. Satu adalah menginstal dari repositori default, dan yang lainnya adalah menginstal versi tertentu menggunakan PPA (Personal Package Archive). Setiap metode dijelaskan secara detail di bawah ini.

Instal PHP dari Repositori Default

Ubuntu menyediakan versi PHP yang stabil di repositori defaultnya. Jika Anda tidak memerlukan versi tertentu, ini adalah metode termudah.

sudo apt install -y php

Setelah instalasi, verifikasi bahwa PHP terpasang dengan benar:

php -v

Contoh Output:

PHP 8.1.2 (cli) (built: ...)

Pada Ubuntu 22.04, PHP 8.1 terinstal secara default.

Instal Versi PHP Tertentu Menggunakan PPA

Jika Anda ingin menggunakan versi PHP terbaru atau mengelola beberapa versi, Anda dapat menambahkan PPA ondrej/php.

Langkah 1: Tambahkan Repositori PPA

sudo add-apt-repository ppa:ondrej/php
sudo apt update

PPA ini banyak digunakan dalam komunitas Ubuntu dan menyediakan build stabil untuk berbagai versi PHP.

Langkah 2: Instal Versi PHP yang Diinginkan

Sebagai contoh, untuk menginstal PHP 8.2:

sudo apt install -y php8.2

Anda juga dapat menginstal versi lain seperti PHP 7.4 atau 8.0.

Langkah 3: Verifikasi Versi yang Terinstal

php -v

4. Memverifikasi Operasi PHP

Setelah menginstal PHP, verifikasi bahwa ia berfungsi dengan benar. Anda dapat memeriksanya melalui baris perintah dan melalui server web seperti Apache atau Nginx.

Verifikasi melalui Command Line (CLI)

Pertama, periksa versi PHP dari terminal:

php -v

Contoh Output:

PHP 8.2.10 (cli) (built: Aug 23 2023 08:12:10) ( NTS )
Copyright (c) The PHP Group
Zend Engine v4.2.10, Copyright (c) Zend Technologies

Verifikasi melalui Server Web (Apache)

Jika Apache terinstal, buat halaman uji menggunakan fungsi phpinfo().

1. Buat File Uji

echo "<?php phpinfo(); ?>" | sudo tee /var/www/html/info.php

2. Akses melalui Browser

http://localhost/info.php

3. Konfirmasi Output

Jika informasi PHP yang detail ditampilkan, PHP berfungsi dengan benar bersama Apache.

🔍 Catatan: Output phpinfo() berisi informasi sensitif. Hapus file tersebut setelah verifikasi.

sudo rm /var/www/html/info.php

Verifikasi dengan Nginx + PHP-FPM

Saat menggunakan Nginx, PHP diproses melalui php-fpm. Untuk memverifikasi integrasi yang tepat, pastikan file .php dikonfigurasi dengan benar dalam file konfigurasi Nginx, kemudian buat file info.php seperti yang Anda lakukan pada Apache.

Jika konfigurasi salah, Anda mungkin mengalami error 500 atau melihat file diunduh alih‑alih dieksekusi. Dalam kasus seperti itu, tinjau pengaturan seperti fastcgi_pass dan include fastcgi-php.conf; dalam konfigurasi Nginx.

5. Menginstal Modul PHP yang Umum Digunakan

Menginstal PHP saja tidak menyediakan semua fungsionalitas. Banyak fitur disediakan sebagai modul terpisah (ekstensi) yang harus diinstal sesuai kebutuhan. Bagian ini memperkenalkan modul PHP yang umum digunakan dalam pengembangan dan operasi dunia nyata.

Apa Itu Modul PHP?

Modul PHP (juga disebut ekstensi) menambahkan kemampuan spesifik seperti konektivitas basis data, penanganan string multibyte, pemrosesan gambar, dan parsing XML.

Modul disediakan sebagai paket APT dan dapat diinstal sebagai berikut:

sudo apt install php-module-name

Jika Anda ingin menentukan versi, gunakan format seperti php8.2-mbstring.

Modul PHP Utama dan Kegunaannya

php-mbstring (Dukungan String Multibyte)

Modul ini penting untuk menangani string karakter multibyte seperti teks Jepang. Modul ini hampir wajib untuk situs web Jepang dan pemrosesan email.

sudo apt install php-mbstring

php-mysql (Konektivitas MySQL / MariaDB)

Modul ini diperlukan saat terhubung ke basis data seperti MySQL atau MariaDB. Modul ini esensial untuk aplikasi seperti WordPress.

sudo apt install php-mysql

php-gd (Pemrosesan Gambar)

Modul ini digunakan untuk menghasilkan, mengonversi, dan mengubah ukuran gambar, dan biasanya dipakai untuk thumbnail serta manipulasi gambar.

sudo apt install php-gd

php-xml (Pemrosesan XML)

Modul ini diperlukan untuk menangani data berbasis XML seperti feed RSS dan layanan SOAP. Modul ini umum digunakan pada platform CMS dan integrasi API.

sudo apt install php-xml

php-curl (Komunikasi HTTP)

Modul ini memungkinkan permintaan HTTP dari server, misalnya saat mengintegrasikan dengan API eksternal. Modul ini dibutuhkan oleh banyak kerangka kerja modern.

sudo apt install php-curl

php-zip (Penanganan File Terkompresi)

Modul ini memungkinkan Anda membuat dan mengekstrak file ZIP dan sering dipakai dalam fitur unggah berkas.

sudo apt install php-zip

Mengaktifkan Modul dan Memulai Ulang Layanan

Beberapa modul memerlukan aktivasi eksplisit setelah instalasi. Gunakan phpenmod untuk mengaktifkannya.

sudo phpenmod module_name
sudo systemctl restart apache2

Modul yang diaktifkan akan berlaku setelah memulai ulang server web.

6. Mengelola dan Beralih Versi PHP

Ubuntu memungkinkan Anda menginstal dan menggunakan berbagai versi PHP pada satu server. Ini sangat berguna di lingkungan pengembangan atau server yang menampung banyak aplikasi web.

Bagian ini menjelaskan cara mengganti versi PHP untuk CLI dan untuk Apache.

Mengganti Versi PHP di CLI

Perintah yang Digunakan: update-alternatives

Anda dapat dengan mudah mengganti versi PHP yang digunakan di baris perintah menggunakan update-alternatives.

Langkah 1: Periksa Versi PHP yang Terpasang

ls /usr/bin/php*

Langkah 2: Daftarkan Versi PHP (Hanya untuk Pertama Kali)

sudo update-alternatives --install /usr/bin/php php /usr/bin/php7.4 74
sudo update-alternatives --install /usr/bin/php php /usr/bin/php8.2 82

Langkah 3: Pilih Versi PHP

sudo update-alternatives --config php

Anda akan melihat menu pilihan yang mirip dengan berikut:

There are 2 choices for the alternative php (providing /usr/bin/php).

  Selection    Path             Priority   Status
------------------------------------------------------------
* 0            /usr/bin/php8.2   82        auto mode
  1            /usr/bin/php7.4   74        manual mode
  2            /usr/bin/php8.2   82        manual mode

Press <enter> to keep the current choice[*], or type selection number:

Langkah 4: Verifikasi Versi

php -v

Mengganti Versi PHP di Apache

Saat menggunakan Apache, versi PHP dikelola melalui modul Apache. Anda dapat mengganti versi dengan mengaktifkan dan menonaktifkan modul.

1. Periksa Modul yang Tersedia

ls /etc/apache2/mods-available | grep php

2. Nonaktifkan Modul yang Sedang Aktif

sudo a2dismod php7.4

3. Aktifkan Versi yang Diinginkan

sudo a2enmod php8.2

4. Restart Apache

sudo systemctl restart apache2

7. Mengintegrasikan PHP dengan Apache dan Nginx

PHP menjadi sangat kuat ketika diintegrasikan dengan server web. Di Ubuntu, server web yang paling umum digunakan adalah Apache dan Nginx.

Integrasi Apache (mod_php)

Apache dapat memproses skrip PHP secara langsung menggunakan modul mod_php. Metode ini sederhana dan cocok untuk platform CMS seperti WordPress.

Langkah 1: Instal Apache dan mod_php

sudo apt install -y apache2 libapache2-mod-php

Langkah 2: Restart Apache

sudo systemctl restart apache2

Langkah 3: Uji Eksekusi PHP

<?php
phpinfo();
?>

http://localhost/test.php

Integrasi Nginx (PHP-FPM)

Nginx tidak memproses PHP secara langsung. Sebagai gantinya, ia mengandalkan PHP-FPM (FastCGI Process Manager).

Langkah 1: Instal Nginx dan PHP-FPM

sudo apt install -y nginx php-fpm

Langkah 2: Edit Konfigurasi Nginx

sudo nano /etc/nginx/sites-available/default

location ~ \.php$ {
    include snippets/fastcgi-php.conf;
    fastcgi_pass unix:/run/php/php8.2-fpm.sock;
}

Langkah 3: Restart Nginx

sudo systemctl restart nginx

8. Pemecahan Masalah

Kode Sumber PHP Ditampilkan di Browser

Penyebab

Hal ini terjadi ketika server web tidak memproses file PHP dengan benar.

Solusi

  • Apache:
    sudo apt install libapache2-mod-php
sudo systemctl restart apache2
  • Nginx:
    sudo systemctl restart php8.2-fpm
sudo systemctl restart nginx

Fungsi PHP Tidak Didefinisikan

Penyebab

Modul PHP yang diperlukan tidak terinstal atau tidak diaktifkan.

Solusi

sudo apt install php-mbstring php-xml php-curl
sudo systemctl restart apache2

php -m

Kesalahan PHP Tidak Ditampilkan

Solusi

sudo nano /etc/php/8.2/apache2/php.ini

display_errors = On
error_reporting = E_ALL

sudo systemctl restart apache2

Lokasi File Log

Apache:

/var/log/apache2/error.log

Nginx:

/var/log/nginx/error.log

PHP-FPM:

/var/log/php8.2-fpm.log

9. Ringkasan

.Artikel ini memberikan penjelasan langkah demi langkah tentang cara menginstal PHP di Ubuntu, dari dasar hingga topik lanjutan.

Poin Penting

  • Periksa versi Ubuntu Anda dan perbarui paket
  • Instal PHP melalui repositori default atau PPA
  • Verifikasi PHP melalui CLI dan server web
  • Perluas fungsionalitas dengan modul
  • Kelola beberapa versi PHP secara fleksibel
  • Integrasikan dengan benar ke Apache atau Nginx
  • Periksa log saat melakukan pemecahan masalah

Langkah Selanjutnya

  • Instal MySQL atau MariaDB
  • Siapkan WordPress
  • Gunakan kerangka kerja PHP seperti Laravel
  • Aktifkan HTTPS dengan sertifikat SSL
  • Kelola layanan dengan systemd

Ubuntu dan PHP bersama-sama menyediakan lingkungan pengembangan yang kuat dan fleksibel. Gunakan panduan ini sebagai dasar dan terus kembangkan keahlian Anda.

10. Pertanyaan yang Sering Diajukan (FAQ)

Q1. Bagaimana cara menginstal versi PHP terbaru di Ubuntu?

A. Gunakan PPA ondrej/php dan tentukan versi yang diinginkan.

Q2. Bagaimana cara mengganti versi PHP di CLI?

sudo update-alternatives --config php

Q3. Kode sumber PHP ditampilkan di Apache.

sudo apt install libapache2-mod-php
sudo systemctl restart apache2

Q4. Di mana letak php.ini?

  • Apache: /etc/php/8.2/apache2/php.ini
  • CLI: /etc/php/8.2/cli/php.ini

Q5. Bagaimana cara mengaktifkan modul PHP?

sudo phpenmod mbstring
sudo systemctl restart apache2

Q6. PHP tidak berfungsi dengan Nginx.

Pastikan php-fpm terinstal dan fastcgi_pass dikonfigurasi dengan benar.

Q7. Kesalahan PHP tidak terlihat.

display_errors = On
error_reporting = E_ALL
年収訴求