İsim Alanlarına Giriş

Coddy'nin PHP Journey'sinin Nesne Yönelimli Programlama bölümünün bir parçası — ders 10 / 91.

PHP projeleriniz büyüdükçe birçok sınıf oluşturacaksınız. İki sınıf aynı isme sahip olduğunda ne olur?

Örneğin, blogunuz için bir User sınıfına ve mağazanız için başka bir User sınıfına sahip olabilirsiniz. Ad alanları (Namespaces), sınıfları mantıksal gruplar halinde düzenleyerek bu sorunu çözer.

Bir namespace, sınıflarınız için bir klasör gibidir. Bunu PHP dosyanızın en üstünde namespace anahtar kelimesini kullanarak bildirirsiniz:

<?php
namespace Blog;

class User {
    public $name;
    
    public function __construct($name) {
        $this->name = $name;
    }
}

Artık farklı bir namespace içinde başka bir User sınıfına sahip olabilirsiniz:

<?php
namespace Shop;

class User {
    public $email;
    
    public function __construct($email) {
        $this->email = $email;
    }
}

Ad alanlı (namespaced) bir sınıfı kullanmak için, ters eğik çizgi kullanarak onu tam yoluyla referans alırsınız:

<?php
$blogUser = new \Blog\User("Alice");
$shopUser = new \Shop\User("alice@example.com");

echo $blogUser->name . "\n";
echo $shopUser->email . "\n";

Çıktı:

Alice
alice@example.com

Ters eğik çizgi \, bir dosya yolundaki klasörleri ayıran eğik çizgilere benzer şekilde ad alanı seviyelerini ayırır. Ayrıca, daha derin bir organizasyon için App\Models\Blog gibi iç içe geçmiş ad alanları da oluşturabilirsiniz.

Önemli Nokta: Ad alanları (namespaces) ad çakışmalarını önler ve kodunuzun düzenli kalmasını sağlar. Dosyanızdaki diğer tüm kodlardan önce (declare ifadeleri hariç) her zaman ad alanını bildirin.

Görev

Kolay

Aynı isme sahip sınıflar arasındaki adlandırma çakışmalarını önlemek için ad alanlarını (namespaces) kullanarak küçük bir uygulama düzenleyelim.

Hem araçları hem de hayvanları yöneten bir sistem oluşturduğunuzu hayal edin. Her iki alanın da Car adında bir varlığı var — biri gerçek bir otomobili temsil ederken, diğeri "Car" adında evcil bir kedi (evet, bazı insanlar kedilerine bu ismi veriyor!).

Üç dosya oluşturacaksınız:

Vehicle/Car.php — Vehicle ad alanı içinde, public $brand özelliğine sahip bir Car sınıfı tanımlayın. Kurucu metod (constructor) marka adını kabul etmeli ve atamasını yapmalıdır. "Vehicle: [brand]" değerini döndüren bir describe() metodu ekleyin.
Animal/Car.php — Animal ad alanı içinde bir Car sınıfı tanımlayın (bu, Car adındaki bir kedidir!). public $age özelliğine sahip olmalıdır. Kurucu metod yaşı kabul eder ve atamasını yapar. "Cat named Car, age: [age]" değerini döndüren bir describe() metodu ekleyin.
main.php — require_once kullanarak her iki sınıf dosyasını dahil edin. Tam ad alanı yollarını kullanarak her ad alanından birer nesne oluşturun, ardından her nesne üzerinde describe() metodunu çağırmanın sonucunu yazdırın (her biri kendi satırında).

main.php dosyasında şunları oluşturun:

Markası "Toyota" olan bir Vehicle\Car
Yaşı 3 olan bir Animal\Car

Nesneleri oluştururken ad alanlı sınıflara tam yollarıyla başvurmak için ters eğik çizgi \ kullanmayı unutmayın.

Kopya kağıdı

Ad alanları (Namespaces), sınıfları mantıksal gruplar halinde düzenler ve birden fazla sınıf aynı adı paylaştığında ad çakışmalarını önler.

Bir PHP dosyasının en üstünde namespace anahtar kelimesini kullanarak bir ad alanı bildirin:

<?php
namespace Blog;

class User {
    public $name;
    
    public function __construct($name) {
        $this->name = $name;
    }
}

Farklı ad alanlarında aynı isme sahip sınıflara sahip olabilirsiniz:

<?php
namespace Shop;

class User {
    public $email;
    
    public function __construct($email) {
        $this->email = $email;
    }
}

Ad alanına sahip bir sınıfı kullanmak için, ters eğik çizgi \ kullanarak tam yoluyla referans verin:

<?php
$blogUser = new \Blog\User("Alice");
$shopUser = new \Shop\User("alice@example.com");

echo $blogUser->name . "\n";
echo $shopUser->email . "\n";

Ters eğik çizgi, klasör yollarına benzer şekilde ad alanı seviyelerini ayırır. App\Models\Blog gibi iç içe geçmiş ad alanları oluşturabilirsiniz.

Önemli: Ad alanını her zaman dosyanızdaki diğer kodlardan önce bildirin (declare ifadeleri hariç).

Kendin dene

<?php
// Sınıf dosyalarını dahil edin
require_once 'Vehicle/Car.php';
require_once 'Animal/Car.php';

// YAPILACAK: "Toyota" markalı bir Vehicle\Car nesnesi oluşturun
// Ters eğik çizgi ile tam ad alanı yolunu kullanmayı unutmayın

// YAPILACAK: 3 yaşında bir Animal\Car nesnesi oluşturun
// Ters eğik çizgi ile tam ad alanı yolunu kullanmayı unutmayın

// YAPILACAK: Her nesne için describe() sonucunu yazdırın (her biri kendi satırında)

?>