DEBI PRAHARADIKA
← Back to Blog Index
Development2025-06-0910 min read

Best Practices PHP Modern

Pedoman penulisan kode PHP yang efisien, aman, dan mudah dipelihara sesuai standar modern.

Ekosistem PHP telah berubah secara drastis, jauh melampaui era skrip prosedural yang tidak terstruktur. Dengan rilisnya PHP 8.x, bahasa ini telah menjadi bahasa pemrograman berorientasi objek tingkat enterprise yang sangat strict, cepat (JIT Compiler), dan elegan.

Artikel ini merangkum best practices PHP modern ke dalam empat bab dan ditulis khusus untuk memfasilitasi pengembangan perangkat lunak berskala besar yang aman, memiliki performa tinggi, dan mudah dipelihara (maintainable) oleh tim engineering.

Fondasi & Arsitektur Kode

Bagian ini adalah tentang bagaimana kita membangun kerangka dasar aplikasi. Kode yang baik dimulai dari desain arsitektur yang solid, struktur folder yang rapi, dan penerapan type system yang ketat.

Layered Architecture Blueprint Blueprint 1: Pemisahan lapisan tanggung jawab (Layered Architecture) dari Controller, Service, hingga Repository.

1.1 Lingkungan & Versi Modern

  • Gunakan PHP versi terbaru yang stabil (minimal PHP 8.1+, idealnya 8.2/8.3). Anda dapat memanfaatkan JIT compiler, enum, readonly properties, dan fibers.
  • vlucas/phpdotenv untuk konfigurasi environment. Jangan pernah melakukan hardcode credentials. Simpan pengaturan environment pada file .env.
  • Aktifkan error_reporting(E_ALL) di development, dan matikan display_errors di production (log ke file, jangan tampilkan ke user).

1.2 Standar Penulisan & Type System

  • Ikuti PSR (PHP Standards Recommendations): Gunakan PSR-1 (Basic), PSR-12 (Coding Style), PSR-4 (Autoloading), dan PSR-7 (HTTP Message).
  • Gunakan declare(strict_types=1); di baris pertama setiap file untuk menegakkan tipe data yang ketat.
  • Type hinting absolut di semua parameter dan return type. 
    public function calculateScore(int $score, string $comment): array
  • Manfaatkan Enums & Readonly (PHP 8.1+): Gunakan readonly properties untuk data immutable (tidak bisa diubah) dan enum untuk representasi nilai tetap menggantikan class constant.
    enum SurveyType: string {
    case NPS = 'nps';
    case CSAT = 'csat';
    case CES = 'ces';
}

1.3 Pemodelan OOP & Desain Sistem

  • Prinsip SOLID: Fokus pada Single Responsibility, Open/Closed, Liskov Substitution, Interface Segregation, dan Dependency Inversion.
  • Layered Architecture & Repository Pattern: Pisahkan Controller, Service, Repository, dan Model. Controller tidak boleh memuat logika bisnis (Service Layer). Abstraksikan akses data dengan Repository.
  • Dependency Injection: Jangan membuat objek (new Object()) secara hardcode di dalam kelas. Selalu inject dependensi via constructor.
    class SurveyService {
    public function __construct(
        private readonly SurveyRepositoryInterface $repository
    ) {}
}

Manajemen Data & Keamanan

Performa dan keamanan tidak bisa ditambahkan di akhir proyek, keduanya harus menjadi pertimbangan utama (by design) sejak arsitektur database dibuat hingga endpoint. Berikut beberapa praktik terbaik yang perlu diterapkan dalam manajemen data dan keamanan:

Data Security & Optimization Blueprint Blueprint 2: Optimasi siklus data menggunakan kombinasi OPcache dan Redis Cache Layer.

2.1 Akses Database Optimal

  • Prepared Statements mutlak: Cegah SQL Injection dengan selalu menggunakan parameter binding, hindari konkatenasi string query manual.
    $stmt = $pdo->prepare('SELECT * FROM surveys WHERE id = :id');
$stmt->execute(['id' => $id]);
  • Hindari N+1 Query Problem: Saat menggunakan ORM (seperti Eloquent atau Doctrine), gunakan fitur eager loading (seperti with()) saat mengambil relasi data.
  • Gunakan Database Transactions: Pastikan operasi multi-langkah yang saling berkaitan dibungkus dalam blok transaction agar konsistensi data terjaga.

2.2 Performa Caching & Asynchronous

  • Aktifkan OPcache di Production: Sangat krusial. Menyimpan kompilasi bytecode PHP di memori untuk menghindari parsing ulang pada setiap permintaan.
  • Implementasi Caching Layer: Gunakan Redis atau Memcached untuk data yang sering diakses namun jarang berubah.
  • Sistem Queue (Antrean): Gunakan Message Broker untuk operasi lambat (kirim email, pembuatan laporan PDF) agar tidak memblokir respon HTTP pengguna.

2.3 Standar Keamanan Aplikasi

  • Filter In, Escape Out: Validasi semua masukan pengguna dan bersihkan (escape) output sesuai konteks sebelum merendernya (misal dengan htmlspecialchars() untuk HTML).
  • Manajemen Kredensial: Hash password menggunakan password_hash() (dengan algoritma bcrypt atau argon2), dan lindungi semua form dengan token CSRF.
  • Rate Limiting & Header Keamanan: Lindungi endpoint publik/sensitif dengan batasan request, paksa jalur koneksi HTTPS, dan atur header seperti CSP dan HSTS.

Reliabilitas & Pengujian

Sistem yang handal adalah sistem yang tidak pernah gagal tanpa diketahui (silent failure) dan memiliki safety net sebelum kode mencapai server produksi. Berikut beberapa praktik terbaik yang perlu diterapkan:

Reliability & Testing Blueprint Blueprint 3: Visualisasi integrasi pengujian kode dan pencatatan log tersentralisasi.

3.1 Penanganan Error (Exception Handling)

  • Haramkan Return Boolean/Null untuk Error: Gunakan Exception (Throw) dibandingkan melempar false jika fungsi gagal menyelesaikan tugas esensialnya.
  • Custom Exceptions: Buat domain-specific error class agar mudah ditangkap (contoh: SurveyNotFoundException).
  • Global Error Handler: Daftarkan penangkap eksepsi tingkat puncak (top-level) dengan Sentry atau Bugsnag untuk melacak stack trace di production. Jangan log data sensitif (password, PII) di log file!

3.2 TDD & Pengujian Otomatis

  • Unit Test (PHPUnit): Uji logika bisnis secara terisolasi. Gunakan teknik mocking untuk mensimulasikan koneksi basis data atau API eksternal.
  • Pola Arrange-Act-Assert: Gunakan pola ini agar test case terstruktur dengan jelas dan eksplisit.
    public function test_nps_score_is_calculated_correctly(): void
{
    // Arrange
    $responses = [9, 10, 6, 8];
    
    // Act
    $result = $this->npsCalculator->calculate($responses);
    
    // Assert
    $this->assertEquals(25, $result);
}

Ekosistem & Siklus Hidup

Mengembangkan ekosistem modern juga berarti melibatkan tools yang sesuai dengan standar industri, mulai dari dependensi pihak ketiga hingga strategi peluncuran. Berikut beberapa praktik terbaik yang perlu diterapkan:

CI/CD Pipeline Blueprint Blueprint 4: Alur pengiriman berkelanjutan (CI/CD) dari repositori lokal hingga lingkungan produksi.

4.1 Dependency Management (Composer)

  • Komit composer.lock Anda: File ini menjamin bahwa seluruh tim pengembang (termasuk CI server) memasang versi pustaka pihak ketiga yang persis sama.
  • Pisahkan Dependencies: Gunakan --dev saat memasang alat bantu testing agar ukuran vendor di production tetap ramping dan aman dari eksploitasi fitur debugging.
  • Audit Rutin: Biasakan mengeksekusi perintah composer audit untuk memverifikasi ada/tidaknya celah kerentanan (vulnerability) yang sudah dipublikasikan.

4.2 Desain API Modern

  • Response Format Konsisten: Semua keluaran API (terutama JSON) harus memiliki skema pembungkus yang baku baik saat sukses maupun gagal.
    {
    "success": true,
    "data": {...},
    "message": null
}
  • Versioning: Tambahkan parameter versi pada URI (/api/v1/...) sejak hari pertama untuk menjamin backward compatibility di masa depan.

4.3 Deployment & CI/CD Pipeline

  • Automated Pipeline: Konfigurasikan Bitbucket Pipelines, GitHub Actions, atau GitLab CI untuk mengeksekusi test suite secara otomatis sebelum melakukan build.
  • Zero-Downtime Deployment: Transisi ke rilis versi baru menggunakan symlink (seperti pola Envoyer) atau Blue-Green Deployment untuk menghindari penolakan lalu-lintas jaringan ketika pembaruan sedang berlangsung.

Kita tidak hanya menulis kode PHP yang berfungsi, tetapi juga menciptakan sebuah sistem yang tahan uji waktu (future-proof) serta dapat dibaca oleh rekan engineer kita.

← Back to Blog Index