Cara Memasang dan Menggunakan PHP pada Ubuntu: Panduan Lengkap untuk Pemula 2025

1. Pengenalan

Mengapa Menggunakan PHP pada Ubuntu?

PHP adalah bahasa skrip sisi pelayan yang digunakan secara meluas dalam banyak aplikasi web, termasuk WordPress. Ia telah menjadi piawaian dalam pembangunan web selama bertahun-tahun, memberi kuasa kepada pelbagai CMS dan rangka kerja.

Ubuntu adalah pengagihan Linux yang sangat stabil yang digemari oleh pembangun di seluruh dunia dan sangat sesuai untuk kegunaan pelayan. Gabungan Ubuntu dan PHP diadopsi secara meluas, dari projek peribadi kepada persekitaran pengeluaran perusahaan.

Siapa Artikel Ini Ditujukan & Tujuannya

Panduan ini untuk semua orang dari pemula—yang ingin memasang PHP pada Ubuntu tetapi tidak pasti di mana untuk bermula—kepada pengguna sederhana yang ingin memasang versi PHP tertentu. Kami menyediakan arahan langkah demi langkah yang jelas.

Kami menggunakan Ubuntu 22.04 LTS sebagai persekitaran contoh, tetapi langkah-langkah secara amnya serupa untuk versi lain juga.

Apa Yang Anda Akan Belajar Dalam Artikel Ini

Dengan membaca panduan ini, anda akan dapat memahami dan melaksanakan tugas-tugas berikut:

• Kaedah asas untuk memasang PHP pada Ubuntu
• Cara memasang dan bertukar antara pelbagai versi PHP
• Cara mengesahkan PHP berfungsi dan menyelesaikan masalah
• Cara menyediakan integrasi dengan Apache atau Nginx
• Cara memasang modul PHP yang biasa digunakan

2. Prasyarat dan Persediaan

Cara Memeriksa Versi Ubuntu Anda

Pertama, periksa versi Ubuntu mana yang anda gunakan. Langkah pemasangan dan modul PHP yang tersedia mungkin berbeza sedikit bergantung pada versi Ubuntu anda.

Anda boleh memeriksa versi Ubuntu anda dengan arahan ini:

lsb_release -a

Secara alternatif, anda boleh menggunakan arahan berikut:

cat /etc/os-release

Artikel ini berdasarkan Ubuntu 22.04 LTS, tetapi prosedur asas juga berlaku kepada 20.04 dan 23.10.

Pastikan Pakej Sistem Anda Sentiasa Dikemas Kini

Sebelum memasang PHP, adalah penting untuk mengemas kini pakej sistem anda kepada versi terbaru. Ini membantu mengelakkan isu pergantungan atau ketidakselarasan. Kemas kini dengan arahan-arahan berikut:

sudo apt update
sudo apt upgrade -y

Ini menyegarkan indeks pakej APT, memastikan anda memasang pakej terbaru.

Pasang Utiliti Diperlukan

Apabila memasang sesetengah versi PHP, anda memerlukan pakej software-properties-common untuk menambah repositori dan mengurus pakej. Jika belum dipasang, lakukan dengan:

sudo apt install -y software-properties-common

Pakej ini diperlukan untuk arahan seperti add-apt-repository, terutamanya apabila menggunakan PPA (Arkib Pakej Peribadi) untuk memasang versi PHP tertentu.

Menggunakan Hak Root atau Sudo

Kebanyakan langkah dalam artikel ini melibatkan perubahan sistem, jadi anda perlu menggunakan sudo dengan arahan anda. Jika anda tidak biasa dengannya, semak asas arahan sudo sebelum meneruskan.

3. Cara Memasang PHP

Terdapat dua cara utama untuk memasang PHP pada Ubuntu: menggunakan repositori lalai, atau menyatakan versi melalui PPA (Arkib Pakej Peribadi). Kami akan jelaskan kedua-dua kaedah.

Memasang PHP dari Repositori Lalai

Repositori lalai Ubuntu menyediakan versi stabil PHP. Jika anda tidak memerlukan versi tertentu, jalankan sahaja:

sudo apt install -y php

Selepas pemasangan, periksa bahawa PHP dipasang dengan betul:

php -v

Contoh:

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

Pada Ubuntu 22.04, PHP 8.1 disediakan secara lalai.

Memasang Versi Tertentu Menggunakan PPA

Jika anda mahu PHP terbaru atau perlu menggunakan pelbagai versi, anda boleh tambah PPA ondrej/php yang dipercayai dan nyatakan versi yang anda mahu.

Langkah 1: Tambah Repositori PPA

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

Repositori ini digunakan secara meluas dalam komuniti Ubuntu dan menawarkan binaan stabil untuk semua versi PHP utama.

Langkah 2: Pasang Versi PHP Yang Diingini

Sebagai contoh, untuk memasang PHP 8.2:

sudo apt install -y php8.2

Anda juga boleh memasang versi lain seperti PHP 7.4 atau 8.0 dengan cara yang sama.

Langkah 3: Periksa Versi Yang Dipasang

php -v

Jika versi khusus telah dipasang dengan berjaya, ia akan dipaparkan di sini.

4. Mengesahkan Pemasangan PHP

Setelah PHP dipasang, periksa bahawa ia berfungsi. Pada Ubuntu, anda boleh mengesahkannya melalui baris perintah (CLI) dan juga melalui pelayan web anda (Apache atau Nginx). Begini caranya:

Memeriksa melalui Baris Perintah (CLI)

Paparkan versi PHP dalam terminal untuk mengesahkan bahawa PHP berfungsi:

php -v

Jika anda melihat versi PHP dan maklumat binaan, PHP berfungsi dalam CLI.

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

Memeriksa melalui Pelayan Web (Contoh Apache)

Jika anda menggunakan Apache, cipta halaman ujian dengan fungsi phpinfo() untuk mengesahkan PHP berfungsi dengan Apache.

1. Cipta Fail Ujian

Cipta fail PHP dalam direktori web Apache anda (biasanya /var/www/html) dengan:

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

2. Periksa dalam Penyemak Imbas Anda

Akses fail tersebut dalam penyemak imbas anda. Pada mesin tempatan anda, lawati:

http://localhost/info.php

3. Semak Output

Jika anda melihat maklumat PHP terperinci, PHP berfungsi melalui Apache.

🔍 Tip: Oleh kerana phpinfo() boleh memaparkan maklumat sensitif, hapuskan fail info.php selepas memeriksa.

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

Memeriksa dengan Nginx + PHP-FPM

Jika anda menggunakan Nginx, PHP berjalan melalui php-fpm. Pastikan Nginx dikonfigurasikan untuk mengendalikan fail .php, kemudian cipta info.php seperti di atas. Jika anda melihat ralat 500 atau prompt muat turun, semak tetapan Nginx anda, khususnya fastcgi_pass dan include fastcgi-php.conf;.

5. Memasang Modul PHP yang Kerap Digunakan

Pemasangan teras PHP tidak termasuk semua ciri. Banyak yang disediakan sebagai modul (sambungan) yang mesti dipasang mengikut keperluan. Di sini, kami memperkenalkan modul PHP penting untuk pembangunan dan produksi.

Apa Itu Modul PHP?

Modul PHP (atau sambungan) menambah ciri seperti sambungan pangkalan data, pemprosesan rentetan multibait, manipulasi imej, atau pengendalian XML.

Modul tersedia sebagai pakej APT dan boleh dipasang seperti ini:

sudo apt install php-[module-name]

Untuk menentukan versi, gunakan sesuatu seperti php8.2-mbstring.

Modul PHP Utama dan Kegunaannya

php-mbstring (Sokongan Rentetan Multibait)

Diperlukan untuk mengendalikan aksara multibait seperti Jepun. Penting untuk laman Jepun atau pemprosesan e‑mel.

sudo apt install php-mbstring

php-mysql (Sambungan MySQL/MariaDB)

Diperlukan untuk menyambung ke pangkalan data MySQL atau MariaDB. Diperlukan untuk aplikasi seperti WordPress yang menggunakan pangkalan data.

sudo apt install php-mysql

php-gd (Pemprosesan Imej)

Mengendalikan penciptaan imej, penukaran, dan penukaran saiz; digunakan untuk menjana tangkapan skrin atau gambar kecil.

sudo apt install php-gd

php-xml (Pemprosesan XML)

Diperlukan untuk mengendalikan data berasaskan XML seperti suapan RSS atau SOAP. Digunakan dalam CMS dan untuk integrasi API.

sudo apt install php-xml

php-curl (Komunikasi HTTP)

Digunakan untuk menghantar permintaan HTTP, seperti ketika mengintegrasikan dengan API luaran. Digunakan secara meluas oleh kerangka kerja moden.

sudo apt install php-curl

php-zip (Pengendalian Fail ZIP)

Mengendalikan pemampatan dan pengekstrakan fail ZIP; berguna untuk ciri muat naik fail.

sudo apt install php-zip

Mengaktifkan Modul dan Memulakan Semula Perkhidmatan

Beberapa modul memerlukan pengaktifan eksplisit selepas pemasangan. Gunakan phpenmod seperti berikut:

sudo phpenmod [module-name]
sudo systemctl restart apache2

Perubahan akan berkuat kuasa selepas memulakan semula pelayan web anda.

6. Mengurus dan Menukar Versi PHP

Ubuntu membolehkan anda memasang dan menggunakan pelbagai versi PHP pada satu pelayan. Ini berguna apabila menghoskan pelbagai aplikasi atau membangun dalam pelbagai persekitaran. Begini cara menukar versi pada CLI dan dengan Apache.

Menukar Versi PHP dalam CLI

Perintah: update-alternatives

Gunakan update-alternatives untuk menukar versi PHP yang digunakan dalam CLI dengan mudah.

Langkah 1: Senaraikan Versi PHP yang Dipasang

ls /usr/bin/php*

Langkah 2: Daftar Versi PHP dengan update-alternatives (Hanya Kali Pertama)

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 yang Akan Digunakan

sudo update-alternatives --config php

Ini memaparkan skrin pilihan seperti:

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:

Taip nombor versi yang dikehendaki dan tekan Enter.

Langkah 4: Sahkan Versi

php -v

Menukar Versi PHP dengan Apache

Dengan Apache, anda boleh mengaktifkan atau menyahaktif modul PHP mengikut versi. Berikut cara memilih versi yang anda mahu:

1. Senaraikan Modul yang Tersedia

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

2. Nyahaktifkan Modul Semasa

sudo a2dismod php7.4

3. Aktifkan Versi yang Dikehendaki

sudo a2enmod php8.2

4. Mulakan Semula Apache

sudo systemctl restart apache2

Ini akan melaksanakan perubahan anda pada CLI dan Apache.

7. Menyediakan Integrasi dengan Apache dan Nginx

PHP menjadi lebih berkuasa apabila digabungkan dengan pelayan web. Pada Ubuntu, anda biasanya akan menggunakan Apache atau Nginx. Berikut cara menyambungkan PHP dengan kedua-duanya.

Menyediakan Apache (mod_php)

Dengan Apache, modul mod_php membolehkan skrip PHP dijalankan secara langsung. Ia mudah disediakan, menjadikannya pilihan yang baik untuk WordPress dan CMS lain.

Langkah 1: Pasang Apache dan mod_php

sudo apt install -y apache2 libapache2-mod-php

Dengan libapache2-mod-php dipasang, Apache dapat memproses fail PHP.

Langkah 2: Mulakan Semula Apache

sudo systemctl restart apache2

Langkah 3: Uji dengan Fail PHP

Buat fail test.php di dalam /var/www/html dan semak di pelayar anda:

<?php
phpinfo();
?>

Contoh URL:

http://localhost/test.php

Menyediakan Nginx (PHP-FPM)

Nginx ringan dan pantas, tetapi tidak dapat memproses PHP secara langsung. Anda akan menggunakan PHP-FPM (FastCGI Process Manager) untuk sokongan PHP.

Langkah 1: Pasang Nginx dan PHP-FPM

sudo apt install -y nginx php-fpm

Langkah 2: Edit Fail Konfigurasi Nginx

Edit /etc/nginx/sites-available/default (atau konfigurasi virtual host anda):

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

Tambah atau kemas kini blok ini:

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

Langkah 3: Mulakan Semula Nginx

sudo systemctl restart nginx

Langkah 4: Uji dengan Fail PHP

Buat /var/www/html/test.php dan semak di pelayar anda, seperti pada Apache.

Nota: Tetapan Firewall (Jika Diperlukan)

Jika menggunakan UFW (Uncomplicated Firewall), benarkan akses dengan:

sudo ufw allow 'Apache Full'
# or
sudo ufw allow 'Nginx Full'

Apache mudah disediakan, manakala Nginx menawarkan prestasi tinggi. Pilih yang paling sesuai dan pastikan integrasi PHP dikonfigurasi dengan betul.

8. Penyelesaian Masalah

Kadang‑kadang PHP mungkin tidak berfungsi seperti yang dijangkakan, walaupun selepas pemasangan dan integrasi pelayan. Bahagian ini membincangkan masalah biasa, punca, dan penyelesaiannya.

PHP Tidak Berfungsi (Kod Sumber Dipaparkan dalam Pelayar)

Punca

Ini berlaku apabila Apache atau Nginx memaparkan fail PHP sebagai teks biasa dan bukannya memprosesnya. Modul PHP atau tetapan FastCGI mungkin tidak dikonfigurasi dengan betul.

Penyelesaian

• Untuk Apache: Periksa bahawa libapache2-mod-php dipasang dan diaktifkan, kemudian mulakan semula Apache.

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

• Untuk Nginx: Semak bahawa php-fpm telah dipasang dan konfigurasi Nginx mempunyai fastcgi_pass dan tetapan yang betul.

  sudo systemctl restart php8.2-fpm
  sudo systemctl restart nginx
  

Sesetengah Ciri PHP Tidak Berfungsi (Fungsi Tidak Ditakrifkan)

Punca

Ini biasanya disebabkan modul PHP yang diperlukan tidak dipasang atau diaktifkan.

Penyelesaian

• Pasang modul yang diperlukan, seperti mbstring , xml , atau curl :

  sudo apt install php-mbstring php-xml php-curl
  

• Selepas mengaktifkan modul, mulakan semula pelayan web anda.

  sudo systemctl restart apache2  # or nginx
  

• Semak modul yang diaktifkan dengan:

  php -m
  

Ralat PHP Tidak Dipaparkan

Punca

Secara lalai, mesej ralat PHP mungkin dimatikan.

Penyelesaian

Edit php.ini dan ubah tetapan paparan ralat:

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

Cari dan tetapkan yang berikut:

display_errors = On
error_reporting = E_ALL

Kemudian mulakan semula pelayan web anda:

sudo systemctl restart apache2

Cara Semak Log Ralat

Untuk Apache:

/var/log/apache2/error.log

Untuk Nginx:

/var/log/nginx/error.log

Untuk PHP-FPM (dengan Nginx):

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

Semak log ini untuk penyelesaian masalah:

sudo tail -f /var/log/apache2/error.log

Apabila ralat berlaku, ingat: Semak log → Semak konfigurasi → Mulakan semula pelayan. Kekal tenang dan selesaikan masalah langkah demi langkah.

9. Kesimpulan

Artikel ini menerangkan—dari asas hingga langkah lanjutan—cara memasang PHP pada Ubuntu. Berikut adalah perkara utama dan langkah seterusnya untuk diteroka.

Ringkasan Perkara Utama

• Semak Versi Ubuntu dan Sediakan Semakan versi OS anda dan kemas kini pakej adalah penting untuk pemasangan PHP yang lancar.
• Dua Cara Memasang PHP Pasang dengan mudah dari repositori lalai, atau gunakan PPA untuk versi khusus.
• Pengesahan Selepas Pemasangan Gunakan php -v dan phpinfo() untuk semak PHP dalam konteks CLI dan web.
• Lanjutkan Fungsi dengan Modul Pasang modul yang biasa digunakan seperti php-mbstring dan php-mysql mengikut keperluan.
• Tukar Antara Pelbagai Versi Urus versi dengan mudah menggunakan update-alternatives atau pertukaran modul Apache.
• Integrasi Betul dengan Apache/Nginx Konfigurasi yang sesuai dengan pelayan web pilihan memastikan operasi yang stabil.
• Semak Log untuk Penyelesaian Masalah Jika PHP tidak dipaparkan atau berfungsi dengan betul, semakan log ralat adalah langkah pertama yang paling berkesan.

Langkah Seterusnya untuk Dipelajari

Selepas memasang PHP pada Ubuntu, anda mungkin ingin mendalami topik berkaitan ini:

• Memasang MySQL (MariaDB) dan Menghubungkan Pangkalan Data
• Memasang dan Menyediakan WordPress
• Menggunakan Rangka PHP Seperti Laravel
• Mengaktifkan HTTPS (Menyediakan Sijil SSL dengan Let’s Encrypt)
• Menguruskan Auto-Mula dan Mulakan Semula (Menggunakan systemd)

Dengan ini, anda boleh membina perkhidmatan web dan aplikasi yang lebih lanjutan. Ubuntu dan PHP secara bersama-sama menawarkan persekitaran pembangunan sumber terbuka yang kukuh dan fleksibel. Gunakan artikel ini sebagai asas untuk melangkah ke projek baru!

10. Soalan Lazim (FAQ)

FAQ ini meliputi halangan biasa dan soalan yang sering dicari oleh pengguna semasa memasang atau menyediakan PHP pada Ubuntu. Jawapan dijaga ringkas dan praktikal, walaupun untuk pemula.

Q1. Bagaimana saya memasang versi terbaru PHP pada Ubuntu?

A1.
Versi PHP terbaru tidak sentiasa ada dalam repositori lalai Ubuntu. Tambah PPA ondrej/php yang dipercayai, kemudian pasang versi yang anda mahu.

sudo add-apt-repository ppa:ondrej/php
sudo apt update
sudo apt install php8.2

Q2. Bagaimana saya boleh menukar versi PHP pada CLI?

A2.
Jika anda mempunyai pelbagai versi yang dipasang, gunakan update-alternatives untuk menukar di antara mereka.

sudo update-alternatives --config php

Masukkan nombor untuk versi pilihan anda dari senarai yang dipaparkan.

Q3. Apache memaparkan fail PHP saya sebagai teks biasa bukannya melaksanakannya.

A3.
Ini bermakna Apache tidak memproses PHP—ia memaparkan sebagai teks biasa. Pastikan modul libapache2-mod-php diaktifkan dan mulakan semula Apache:

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

Q4. Di mana fail konfigurasi PHP (php.ini) berada?

A4.
Terdapat fail berasingan untuk penggunaan CLI dan pelayan web. Lokasi biasa ialah:

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

Bahagian “8.2” berubah mengikut versi PHP anda.

Q5. Bagaimana saya mengaktifkan ekstensi PHP?

A5.
Selepas memasang, aktifkan modul dengan phpenmod:

sudo phpenmod mbstring
sudo systemctl restart apache2

Mulakan semula pelayan web anda selepas mengaktifkannya.

Q6. PHP tidak berfungsi dengan betul bersama Nginx. Apa yang perlu saya periksa?

A6.
Nginx memerlukan php-fpm untuk memproses PHP. Pastikan konfigurasi anda mengandungi entri fastcgi_pass yang betul:

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

Sesuaikan bahagian .sock mengikut versi PHP anda.

Q7. Ralat PHP tidak dipaparkan pada skrin.

A7.
Dalam php.ini, display_errors mungkin diset kepada Off. Untuk pembangunan, anda boleh mengaktifkannya seperti ini:

display_errors = On
error_reporting = E_ALL

Mulakan semula pelayan web anda selepas membuat perubahan.

FAQ ini akan membantu anda mengelakkan perangkap biasa ketika menggunakan PHP pada Ubuntu. Simpan pengetahuan ini untuk memudahkan penyelesaian masalah!