Fondasi PHP

BAB 2: Instalasi dan Setup

Memasang PHP 8.4, memeriksa berkas konfigurasi dan ekstensi, menjalankan server pengembangan, serta memperbaiki 2 kesalahan setup paling umum.

3 hal yang harus ada sebelum menulis kode

PHP tidak berjalan sendiri. Ada 3 bagian yang harus siap: program PHP di komputer, terminal untuk menjalankannya, dan editor untuk menulis berkas. Bagian keempat, web server, sudah disertakan PHP dalam bentuk server pengembangan, sehingga kamu belum perlu memasang Apache atau Nginx untuk belajar.

Bab ini memeriksa 3 bagian itu satu per satu dengan perintah yang dijalankan langsung, lalu membahas 2 kesalahan setup yang paling sering menghambat pemula. Setelah bab ini selesai, kamu punya PHP yang bisa dipanggil dari terminal, tahu di mana berkas konfigurasinya, dan bisa menyalakan server lokal untuk membuka halaman di browser.

Memastikan PHP sudah dikenali terminal

Perintah pertama yang dijalankan setiap orang adalah pemeriksaan versi:

BashBASH
php -v

Keluaran di mesin penulisan bab ini:

CodeTEXT
PHP 8.4.27 (cli) (built: Oct 21 2026 14:34:07) (NTS)
Copyright (c) The PHP Group
Built by Ubuntu
Zend Engine v4.4.27, Copyright (c) Zend Technologies
    with Zend OPcache v8.4.27, Copyright (c), by Zend Technologies

3 keterangan pada baris pertama menentukan cara PHP dipakai:

  • cli berarti berkas ini adalah PHP untuk command line, bukan untuk web server.
  • NTS berarti non thread safe, pilihan yang umum pada Linux.
  • Nomor versi menandakan fitur apa yang tersedia. Contoh di bab ini memakai 8.4.

Kalau muncul pesan PHP: command not found, artinya program PHP belum terpasang atau lokasinya tidak dikenal terminal. Pada Ubuntu dan Debian, pemasangan lewat paket resmi menambahkan PHP ke PATH secara otomatis:

BashBASH
sudo apt install php8.4-cli php8.4-mbstring php8.4-mysql

Pada macOS, paket yang sering dipakai adalah Homebrew:

BashBASH
brew install php

Pada Windows, pengelola paket yang paling sedikit menimbulkan masalah adalah Scoop atau Chocolatey, dan PATH perlu diperiksa sekali setelah pemasangan. Berkas hasil unduhan manual dari situs PHP tidak menambahkan dirinya ke PATH, sehingga perintah php -v tetap gagal walau berkasnya ada.

Kesalahan pertama: perintah php tidak ditemukan

Pesan ini muncul saat terminal mencari program bernama php di daftar folder PATH dan tidak menemukannya:

CodeTEXT
bash: line 1: php: command not found

Pesan di atas dihasilkan dengan menjalankan terminal memakai PATH kosong, yaitu keadaan yang sama seperti komputer tanpa PHP terpasang. Ada 2 cara memastikan sumber masalahnya:

BashBASH
which php
echo $PATH

which php mencetak lokasi program kalau ditemukan, dan tidak mencetak apa pun kalau tidak ada. echo $PATH menampilkan daftar folder yang dicari terminal. Kalau folder tempat PHP terpasang tidak ada di daftar itu, tambahkan dengan menyunting berkas profil shell (~/.bashrc pada bash atau ~/.zshrc pada zsh), lalu buka terminal baru.

Memeriksa berkas konfigurasi

Semua pengaturan PHP, mulai batas memori sampai ukuran unggahan berkas, dibaca dari php.ini. Lokasi berkas itu berbeda di setiap sistem, jadi jangan menebak:

BashBASH
php --ini

Keluaran:

CodeTEXT
Configuration File (php.ini) Path: /etc/php/8.4/cli
Loaded Configuration File:         /etc/php/8.4/cli/php.ini
Scan for additional .ini files in: /etc/php/8.4/cli/conf.d
Additional .ini files parsed:      /etc/php/8.4/cli/conf.d/10-mysqlnd.ini,
/etc/php/8.4/cli/conf.d/10-opcache.ini,
/etc/php/8.4/cli/conf.d/10-pdo.ini,

Baris Loaded Configuration File adalah berkas utama yang harus disunting. Baris Scan for additional .ini files menunjukkan folder tambahan, tempat paket ekstensi menyimpan pengaturannya sendiri, misalnya 20-pdo_mysql.ini. Pada Ubuntu, folder itu diisi otomatis saat paket ekstensi dipasang, sehingga kamu tidak perlu menyunting banyak berkas.

Nilai (none) pada baris Loaded Configuration File berarti PHP berjalan tanpa php.ini. Kondisi itu bukan kesalahan fatal, tetapi semua pengaturan kembali ke nilai bawaan, dan beberapa ekstensi tidak aktif. Kalau itu terjadi, salin berkas contoh yang disertakan paket PHP, misalnya php.ini-development, ke lokasi yang disebut pada baris pertama.

Memeriksa ekstensi

PHP dipasang sebagai inti kecil dengan banyak ekstensi terpisah. Ekstensi untuk MySQL, pengolah string multibyte, dan pembaca JSON adalah paket berbeda. Jumlah ekstensi yang aktif bisa dihitung langsung:

PHPPHP
<?php

echo "Jumlah ekstensi: ", count(get_loaded_extensions()), PHP_EOL;
echo extension_loaded('pdo_mysql') ? "pdo_mysql aktif" : "pdo_mysql belum aktif", PHP_EOL;

Jalankan:

BashBASH
php modul.php

Keluaran di mesin penulisan bab ini:

CodeTEXT
Jumlah ekstensi: 58
pdo_mysql aktif

Angka 58 bukan patokan mutlak. Yang penting adalah 2 ekstensi yang dipakai sepanjang buku ini: mbstring untuk mengolah teks dan pdo_mysql untuk menyambung ke MySQL. Kalau salah satunya belum aktif, pasang paketnya, misalnya php8.4-mbstring dan php8.4-mysql, lalu jalankan ulang pemeriksaan.

Daftar lengkap ekstensi bisa dilihat dengan perintah:

BashBASH
php -m

Keluaran perintah itu panjang, terdiri dari blok [PHP Modules] dan [Zend Modules]. Untuk mencari satu nama, sambungkan dengan pencarian:

BashBASH
php -m | grep pdo_mysql

Perintah php -m | grep pdo_mysql mencetak pdo_mysql satu baris kalau ekstensinya ada, dan tidak mencetak apa pun kalau tidak ada.

Memeriksa berkas tanpa menjalankannya

Sebelum menjalankan skrip panjang, periksa dulu apakah berkasnya bisa dibaca mesin PHP. Perintah php -l (lint) hanya memeriksa sintaks, tanpa menjalankan satu perintah pun:

BashBASH
php -l hello.php

Keluaran untuk berkas yang benar:

CodeTEXT
No syntax errors detected in hello.php

Kalau ada titik koma yang hilang, perintah yang sama mencetak pesan parse error beserta nomor barisnya:

CodeTEXT
PHP Parse error:  syntax error, unexpected token "echo" in salah-titik-koma.php on line 4
Errors parsing salah-titik-koma.php
``` Kebiasaan menjalankan `php -l` setelah menyunting berkas menghemat satu putaran: kesalahan sintaks ketahuan sebelum halaman dibuka di browser.

## Menjalankan server pengembangan

PHP menyertakan web server untuk keperluan pengembangan. Perintahnya menerima alamat, port, dan folder yang dilayani:

```bash
php -S 127.0.0.1:8123 -t /tmp/latihan-php

Selama server hidup, setiap permintaan dicatat di terminal:

CodeTEXT
[Sat Nov 14 22:16:44 2026] PHP 8.4.27 Development Server (http://127.0.0.1:8123) started
[Sat Nov 14 22:16:47 2026] 127.0.0.1:55238 [200]: GET /hello.php
[Sat Nov 14 22:16:50 2026] 127.0.0.1:55254 [200]: GET /versi.php

Alamat 127.0.0.1 berarti server hanya bisa dibuka dari komputer sendiri. Untuk menguji dari ponsel di jaringan yang sama, ganti dengan 0.0.0.0:8123, dan ingat bahwa folder yang dilayani menjadi terbuka bagi perangkat lain di jaringan tersebut.

Kesalahan kedua: port sudah dipakai

Menjalankan server kedua pada port yang sama menghasilkan kegagalan:

CodeTEXT
[Sat Nov 14 22:16:47 2026] Failed to listen on 127.0.0.1:8123 (reason: Address already in use)

Pesan Address already in use berarti port 8123 sudah dipegang proses lain, biasanya sesi server yang lupa ditutup. Ada 2 jalan keluar: hentikan proses lama, atau pakai port lain seperti 8124. Pada Linux, proses pemegang port bisa dicari dengan ss -ltnp | grep 8123, lalu dihentikan dengan kill memakai nomor PID yang muncul.

Di Windows, perintah pencariannya berbeda: netstat -ano | findstr :8123. Nomor terakhir pada baris hasil pencarian adalah PID, dan prosesnya dihentikan lewat Task Manager atau taskkill /PID <nomor> /F.

Mengubah pengaturan tanpa menyunting berkas

Untuk percobaan cepat, nilai php.ini bisa ditimpa saat menjalankan perintah, memakai tanda -d:

BashBASH
php -d memory_limit=128M -r 'echo ini_get("memory_limit"), PHP_EOL;'

Keluaran:

CodeTEXT
128M

Tanpa -d, perintah yang sama mencetak nilai dari php.ini, yang pada mesin ini -1. Cara ini berguna untuk menguji skrip yang membutuhkan memori lebih besar tanpa mengubah konfigurasi global. Perubahan permanen tetap harus ditulis di php.ini, pada baris memory_limit.

Satu pengaturan lain yang perlu diketahui sejak awal adalah expose_php. Nilainya On pada pemasangan bawaan, dan itulah sebabnya header X-Powered-By: PHP/8.4.27 muncul di bab sebelumnya. Pada server yang bisa diakses publik, nilai ini biasanya diubah menjadi Off agar versi PHP tidak dibagikan ke pengunjung.

Memilih cara pemasangan

Ada 3 cara memasang PHP, dan pilihannya memengaruhi kemudahan di awal serta kebiasaan yang terbentuk kemudian.

Cara pertama adalah paket resmi sistem operasi, misalnya apt pada Ubuntu dan brew pada macOS. Cara ini menghasilkan PHP yang dipanggil dari terminal, tanpa panel kendali, dan cocok kalau kamu ingin memahami bagian dasarnya. Semua perintah di buku ini menganggap pemasangan jenis ini.

Cara kedua adalah paket siap pakai seperti XAMPP atau Laragon, yang memasang PHP, Apache, MySQL, dan phpMyAdmin sekaligus, lengkap dengan tombol start dan stop. Cara ini mempercepat hari pertama, tetapi lokasi berkas konfigurasi dan versi PHP menjadi urusan paket tersebut, sehingga pembaruan dan pencarian masalah bisa membingungkan.

Cara ketiga adalah container, misalnya image resmi php lewat Docker. Cara ini menjaga versi PHP tetap sama di setiap komputer dan memudahkan percobaan beberapa versi sekaligus, dengan biaya berupa satu lapisan tambahan yang harus dipahami. Untuk belajar dari nol, container sebaiknya dipakai setelah kamu nyaman dengan perintah php di terminal.

Folder yang dilayani dan berkas index.php

Server pengembangan menerima 2 keterangan penting: alamat port dan folder yang dilayani lewat tanda -t. Kalau tanda itu tidak ditulis, folder yang dilayani adalah folder tempat perintah dijalankan.

Permintaan ke alamat utama tanpa nama berkas dicarikan index.php di folder tersebut. Untuk membuktikannya, simpan berkas index.php berisi satu baris, lalu minta alamat utama:

PHPPHP
<?php

echo "Halaman utama";
BashBASH
curl -s http://127.0.0.1:8124/
CodeTEXT
Halaman utama

Status balasannya 200, sama seperti permintaan ke berkas bernama. Aturan ini menjelaskan mengapa alamat http://127.0.0.1:8124/ bisa menampilkan halaman utuh tanpa nama berkas di belakangnya: web server menambahkan index.php sendiri.

Kalau index.php tidak ada dan folder tidak mengizinkan daftar isi, permintaan ke alamat utama dijawab dengan 404. Menyimpan index.php di setiap folder latihan membuat alamat utama selalu bisa dibuka.

Ringkasan

Instalasi PHP dianggap selesai kalau php -v mencetak versi, php --ini menunjukkan berkas konfigurasi yang dipakai, dan php -m memuat ekstensi mbstring serta pdo_mysql.

Server pengembangan dijalankan dengan php -S alamat:port -t folder, dan setiap permintaan tercatat di terminal. 2 kesalahan setup yang paling sering muncul adalah perintah php tidak ditemukan karena PATH, dan port yang sudah dipakai proses lain.

Pengaturan dibaca dari php.ini dan bisa ditimpa sementara dengan -d saat menjalankan perintah, sehingga percobaan tidak perlu mengubah konfigurasi global.

Referensi

  1. PHP Documentation Group. Installation and Configuration.
  2. PHP Documentation Group. Built-in web server.
  3. PHP Documentation Group. The configuration file.