Clean code adalah pendekatan penulisan kode yang menekankan keterbacaan, konsistensi, dan kemudahan perawatan. Dalam pengembangan aplikasi PHP, clean code menjadi faktor penting karena sebagian besar waktu developer dihabiskan untuk membaca dan memelihara kode, bukan menulisnya.

Artikel ini membahas tips clean code PHP yang praktis dan relevan untuk pengembangan aplikasi skala kecil hingga besar.

Gunakan Penamaan Variabel yang Jelas

Nama variabel harus menggambarkan tujuan data yang disimpan.

Kurang baik:

$x = 150000;

Lebih baik:

$totalPrice = 150000;

Penamaan yang jelas mengurangi kebutuhan komentar berlebihan.

Hindari Fungsi Terlalu Panjang

Satu fungsi sebaiknya hanya memiliki satu tanggung jawab.

function calculateTotalPrice(array $items): int
{
    return array_sum(array_column($items, 'price'));
}

Fungsi yang pendek lebih mudah diuji dan digunakan kembali.

Terapkan Prinsip Single Responsibility

Satu class sebaiknya mengerjakan satu tugas.

class InvoiceCalculator
{
    public function calculate(array $items): int
    {
        return array_sum(array_column($items, 'price'));
    }
}

Pisahkan logika bisnis dari logika presentasi.

Konsisten dengan Format Kode

Gunakan standar seperti PSR-12:

if ($userIsActive) {
    sendNotification();
}

Konsistensi format membuat kode lebih nyaman dibaca oleh tim.

Gunakan Type Hinting

Type hinting membantu mencegah bug sejak awal.

function getUserName(int $userId): string
{
    return 'Akbar';
}

PHP modern sangat mendukung penulisan kode yang lebih aman dengan tipe data.

Hindari Magic Number dan Magic String

// Kurang baik
if ($status === 1) {}

// Lebih baik
const STATUS_ACTIVE = 1;

if ($status === self::STATUS_ACTIVE) {}

Konstanta membuat kode lebih mudah dipahami.

Minimalkan Penggunaan Komentar

Komentar sebaiknya menjelaskan kenapa, bukan apa.

// Validasi tambahan untuk mencegah data duplikat
checkDuplicateEmail($email);

Jika kode sudah jelas, komentar tidak lagi dibutuhkan.

Gunakan Early Return

if (!$user) {
    return false;
}

return $user->isActive();

Early return mengurangi nested code dan meningkatkan keterbacaan.

Manfaatkan Dependency Injection

class UserService
{
    public function __construct(
        protected UserRepository $repository
    ) {}
}

Dependency injection membuat kode lebih fleksibel dan mudah diuji.

Validasi Input Secara Konsisten

if (empty($email)) {
    throw new InvalidArgumentException('Email wajib diisi');
}

Validasi yang konsisten meningkatkan stabilitas aplikasi.

Gunakan Struktur Folder yang Jelas

Pisahkan file berdasarkan tanggung jawab:

app/
 ├── Services/
 ├── Repositories/
 ├── Controllers/
 └── Models/

Struktur yang baik mempermudah kolaborasi tim.

Hindari Duplikasi Kode

function formatCurrency(int $amount): string
{
    return number_format($amount, 0, ',', '.');
}

DRY (Don't Repeat Yourself) adalah prinsip penting dalam clean code.

Penutup

Clean code PHP bukan hanya soal estetika, tetapi investasi jangka panjang untuk kualitas aplikasi. Dengan menerapkan prinsip-prinsip clean code, developer dapat mempercepat pengembangan, meminimalkan bug, dan memudahkan maintenance.

Tips-tips dalam artikel ini dapat diterapkan secara bertahap dan konsisten untuk meningkatkan kualitas kode PHP secara signifikan.