Namespace & Autoloading

Tujuan Pembelajaran

Setelah mengikuti pertemuan ini, mahasiswa diharapkan mampu memahami dan mengimplementasikan konsep pengelolaan kode dalam skala besar. Fokus utama kita meliputi:

• Memahami masalah Tabrakan Nama (Naming Collision) dan solusinya menggunakan Namespace.
• Menerapkan keyword namespace, use, dan aliasing di PHP.
• Mengidentifikasi tantangan Include Manual pada proyek kompleks.
• Mengimplementasikan Autoloading menggunakan fungsi standar PHP.
• Memahami dan menerapkan standar industri PSR-4 untuk Autoloading.

Prolog ini sangat penting agar kita memiliki organisasi kode yang rapi, mudah dirawat, dan skalabel layaknya blueprint arsitektur yang profesional.

Masalah: Tabrakan Nama (Naming Collision)

Seiring bertambahnya ukuran proyek, kita sering kali membuat class, fungsi, atau konstanta dengan nama yang sama, terutama jika menggunakan library pihak ketiga.

Contoh masalah: Jika kita `include` dua file berbeda yang sama-sama mendefinisikan `class User`, program akan meledak.

Solusi PHP untuk masalah ini adalah Namespace.

1. Apa itu Namespace?

Namespace adalah sebuah bilik isolasi atau kotak pengaman yang mengelompokkan class, fungsi, dan konstanta dalam satu wadah logis. Ini mirip dengan direktori folder di sistem operasi Anda.

Deklarasi & Penggunaan di PHP

Gunakan keyword namespace di bagian paling atas file PHP (sebelum kode PHP apa pun, kecuali deklarasi `use untuk menginisialisasi atau memanggilnya.

// 📁 File: app/Core/User.php
<?php
namespace App\Core;

class User {
    public function __construct() {
        echo "Blueprint User dari App\Core berhasil dibuat!";
    }
}

Memanggil Class User di file lain:

// 📁 File: public/index.php
<?php
// include kedua file yang tabrakan
include '../app/Core/User.php';
// include '../app/Toko/User.php';

// Cara 1: Memanggil lengkap (Qualified Name)
$objCore = new \App\Core\User();

// Cara 2: Menginisialisasi (Importing)
use App\Core\User as UserCore;
$objCore2 = new UserCore();

Masalah Pemuatan: Include Manual

Jika kita punya ratusan class dalam ratusan file PHP, mengelola Namespace dan melakukan `include`/`require` satu per satu di file utama akan menjadi mimpi buruk.

Contoh masalah: Jika kita lupa melakukan `include` satu file, program akan meledak dengan Fatal Error saat objek class tersebut diinstansiasi.

Solusi PHP untuk masalah pemuatan manual ini adalah Autoloading.

2. Apa itu Autoloading?

Autoloading adalah mekanisme di mana PHP memuat file class secara otomatis dari memori, persis pada saat program mencoba menginstansiasi (menggunakan) class tersebut untuk pertama kalinya.

Implementasi spl_autoload_register()

PHP menyediakan fungsi maut: spl_autoload_register(). Fungsi ini mendaftarkan sebuah 'penangkap' yang akan dijalankan otomatis saat PHP mencari class yang belum termuat.

// 📁 File: autoload.php
<?php
spl_autoload_register(function ($className) {
    // Parameter $className berisi nama lengkap class beserta Namespace-nya
    // Misal: "App\Core\User"

    // Aturan standar (PSR-4): Ubah Namespace jadi path directori
    // App\Core\User ➔ /app/Core/User.php
    $path = __DIR__ . '/../' . str_replace('\\', '/', $className) . '.php';
    
    // Pemuatan file otomatis
    if (file_exists($path)) {
        include $path;
    }
});

Integrasi & Standar PSR-4

Agar Autoloading berjalan ajaib, kita wajib menaati standar industri PHP, yaitu **PSR-4**.

Simulasi: "Inisialisasi & Autoloading Ajaib"

Pilih class yang ingin Anda muat, tekan tombol "Load Class" untuk melihat bagaimana mekanisme autoloading PHP bekerja secara otomatis di balik layar.

// 📁 File: public/index.php (DI BELAKANG LAYAR)
<?php
// include autoloader sekali
include '../app/autoload.php';

// Instansiasi memicu autoloading
$obj = new \App\Core\User();

Tugas Mandiri (Minggu 10): Kreativitas Autoloading