Namespace PHP: namespace, use, dan Alias

Namespace PHP menempatkan class, fungsi, dan konstanta di bawah sebuah prefix agar namanya tidak bisa bentrok dengan milik orang lain. Kamu mendeklarasikannya dengan namespace App\Models; sebagai pernyataan pertama sebuah file, lalu file lain merujuk class itu sebagai \App\Models\User, atau meng-import-nya dengan use App\Models\User; dan cukup menulis User.

<?php
namespace App\Models;

class User
{
    public function __construct(public string $name) {}
}

function greet(User $u): string
{
    return "Hello, {$u->name}";
}

$u = new User('Ada');
echo greet($u), "\n";
echo User::class, "\n";
echo __NAMESPACE__, "\n";
echo get_class($u), "\n";

Di dalam namespace, User berarti App\Models\User. User::class memberi nama lengkapnya sebagai string tanpa membuat apa pun, yang berguna untuk logging dan untuk autoloader.

Dua namespace dalam satu file

Proyek sungguhan menaruh satu namespace di setiap file. Untuk demo yang berdiri sendiri, satu file boleh berisi beberapa namespace jika masing-masing dibungkus kurung kurawal. Kode yang tidak termasuk namespace mana pun ditaruh di namespace { }:

<?php
namespace Shop {
    class Order
    {
        public function label(): string { return 'shop order'; }
    }
}

namespace Kitchen {
    class Order
    {
        public function label(): string { return 'kitchen ticket'; }
    }
}

namespace {
    // Global code: use the fully qualified names
    $a = new \Shop\Order();
    $b = new \Kitchen\Order();
    echo get_class($a), ': ', $a->label(), "\n";
    echo get_class($b), ': ', $b->label(), "\n";
}

Dua class bernama Order bisa berdampingan karena nama lengkapnya berbeda. Itulah tepatnya masalah yang diselesaikan namespace begitu kamu memasang library: Order milikmu, Order milik library pembayaran, dan Order milik library PDF tidak lagi bentrok.

Import dengan use, dan alias dengan as

Menulis \Shop\Order di mana-mana terasa berisik. use di bagian atas file (atau blok namespace) meng-import sebuah nama agar kamu bisa memakai bentuk pendeknya. Saat dua import akan berakhir dengan nama pendek yang sama, as memberi salah satunya nama yang berbeda:

<?php
namespace Shop {
    class Order { public string $kind = 'shop'; }
    class Invoice { public string $kind = 'invoice'; }
}

namespace Kitchen {
    class Order { public string $kind = 'kitchen'; }
}

namespace App {
    use Shop\Order;
    use Shop\Invoice;
    use Kitchen\Order as KitchenOrder;

    $orders = [new Order(), new KitchenOrder(), new Invoice()];
    foreach ($orders as $o) {
        echo get_class($o), ' -> ', $o->kind, "\n";
    }
    echo KitchenOrder::class, "\n";
}

use hanya membuat nama pendek untuk sisa file. Pernyataan ini tidak memuat file atau menjalankan kode, dan bekerja dengan cara yang sama entah class-nya sudah ada atau belum. Import berkelompok juga diperbolehkan: use Shop\{Order, Invoice};.

use function dan use const

Fungsi dan konstanta di dalam namespace di-import dengan use function dan use const:

<?php
namespace Utils\Text {
    const ELLIPSIS = '...';

    function shorten(string $s, int $max): string
    {
        return mb_strlen($s) > $max ? mb_substr($s, 0, $max) . ELLIPSIS : $s;
    }
}

namespace App {
    use function Utils\Text\shorten;
    use const Utils\Text\ELLIPSIS;

    echo shorten('Namespaces keep names apart', 10), "\n";
    echo 'Marker: ', ELLIPSIS, "\n";
    echo \Utils\Text\shorten('Fully qualified call works too', 15), "\n";
}

Class global butuh backslash

Di dalam namespace, nama class tanpa prefix diselesaikan relatif terhadap namespace itu, jadi new DateTime() di dalam namespace App; mencari App\DateTime. Fungsi dan konstanta berbeda: jika App\strlen tidak ada, PHP kembali ke strlen global. Class tidak pernah kembali ke global.

<?php
namespace App;

echo strlen('works'), "\n";        // functions fall back to global
echo PHP_INT_SIZE, "\n";               // so do constants

try {
    $d = new DateTime('2026-03-14');
} catch (\Error $e) {
    echo $e->getMessage(), "\n";
}

$d = new \DateTime('2026-03-14');  // leading backslash: the global class
echo $d->format('D, d M Y'), "\n";

catch (\Error $e) juga butuh backslash karena alasan yang sama: tanpanya PHP akan mencari App\Error, tidak pernah cocok dengan error yang sebenarnya, dan script berhenti dengan Error yang tidak tertangkap. Perbaiki dengan backslash di depan, seperti di atas, atau dengan use DateTime; di bagian atas file. Hal yang sama berlaku untuk \Exception, \Throwable, dan setiap class bawaan lainnya; lihat try catch untuk cara menangkapnya.

Autoloading dan PSR-4

Di sebuah proyek, setiap class berada di file-nya sendiri, dan path file-nya mengikuti namespace. PSR-4 adalah konvensinya: prefix namespace dipetakan ke folder dasar, dan sisa namanya menjadi path. Autoloader yang didaftarkan dengan spl_autoload_register() lalu memuat file class pada saat class itu pertama kali dipakai. Blok ini menulis dua file class ke disk lalu memuatnya secara otomatis:

<?php
// Create src/Models/User.php and src/Services/Mailer.php
is_dir('src/Models') || mkdir('src/Models', 0777, true);
is_dir('src/Services') || mkdir('src/Services', 0777, true);
file_put_contents('src/Models/User.php', '<?php
namespace App\Models;
class User { public function __construct(public string $email) {} }
');
file_put_contents('src/Services/Mailer.php', '<?php
namespace App\Services;
use App\Models\User;
class Mailer { public function welcome(User $u): string { return "Welcome mail to {$u->email}"; } }
');

// A minimal PSR-4 autoloader: App\ maps to src/
spl_autoload_register(function (string $class) {
    $prefix = 'App\\';
    if (!str_starts_with($class, $prefix)) {
        return;
    }
    $file = __DIR__ . '/src/' . str_replace('\\', '/', substr($class, strlen($prefix))) . '.php';
    echo "autoload: $class\n";
    require $file;
});

$mailer = new App\Services\Mailer();
echo $mailer->welcome(new App\Models\User('ada@example.com')), "\n";

Setiap file class dimuat sekali, tepat saat class itu pertama kali dibutuhkan. Di proyek sungguhan, kamu tidak menulis fungsi ini sendiri: Composer membuatnya dari beberapa baris di composer.json:

{
    "autoload": {
        "psr-4": {
            "App\\": "src/"
        }
    }
}

Setelah composer dump-autoload, satu baris require __DIR__ . '/vendor/autoload.php'; di awal script utamamu memuat setiap class App\... saat dibutuhkan.

Aturan namespace yang menyebabkan error

• namespace harus menjadi pernyataan pertama di file. Hanya declare(strict_types=1); dan komentar yang boleh ada sebelumnya.
• Import use berlaku per file. Meng-import class di index.php tidak membuat nama pendeknya berfungsi di file yang di-include; setiap file butuh baris use-nya sendiri.
• use ditulis di level teratas file atau blok namespace. Di dalam body class, use punya arti lain: memasukkan sebuah trait.
• String tidak pernah diselesaikan: $class = 'User'; new $class(); mencari User global. Simpan nama lengkapnya, sebaiknya dengan User::class.

Aturan terakhir layak dicek dengan cepat:

<?php
namespace App\Models {
    class User {}
}

namespace App {
    use App\Models\User;

    $short = 'User';
    var_dump(class_exists($short));         // looks for global User
    var_dump(class_exists(User::class));    // App\Models\User

    $class = User::class;
    echo get_class(new $class()), "\n";
}