İsim alanlarının kullanımı: İthal/Rumuz

    (PHP 5 >= 5.3.0, PHP 7, PHP 8)

    Dış kaynaklı tamamen nitelenmiş bir isme bir takma adla veya ithal ederek başvurma yeteneği isim alanlarının önemli bir özelliğidir. Bu özellik, Unix dosya sistemlerinin bir dizin veya dosyaya bir sembolik bağ oluşturma yeteneğine benzer.

    PHP sabitler, işlevler, sınıflar, arayüzler, nitelikler, sayılamalar ve isim alanlarına takma ad verilmesini ve ithalini destekler.

    Takma ad kullanımı use işleci üzerinden sağlanır. Aşağıda 5 çeşidin de ithal örneğine yer verilmiştir:

    Örnek 1 - use işleci ile ithal/takma ad kullanımı

    <?php
    namespace fan;
    use     Bir\Tam\Sınıfadı as BirBaşkası;

    // use Bir\Tam\iAadı as iAadı ile aynıdır
    use Bir\Tam\iAadı;

    // küresel bir sınıfın ithali
    use DiziNesnesi;

    // bir işlevin ithali
    use function Bir\Tam\işlevAdı;

    // bir işleve takma ad
    use function Bir\Tam\işlevAdı as func;

    // bir sabitin ithali
    use const Bir\Tam\SABİT;

    $nesne = new namespace\BirBaşkası; // fan\BirBaşkası sınıfını örnekler
    $nesne = new BirBaşkası; // Bir\Tam\Sınıfadı sınıfını örnekler
    iAadı\altia\işlev(); // Bir\Tam\iAadı\altia\işlev işlevini çağırır
    $a = new DiziNesnesi(array(1)); // DiziNesnesi sınıfını örnekler
    // "use DiziNesnesi" olmasaydı fan\DiziNesnesi sınıfını örneklerdik
    func(); // Bir\Tam\işlevAdı işlevini çağırır
    echo SABİT; // Bir\Tam\SABİT değerini basar
    ?>
    İsim alanlı adlar için baştaki terbölü gereksiz olup önerilmediği gibi bunlar geçerli isim alanına göre işlenmezler. İthal edilen isimler ise tamamen nitelenmiş olmalıdır. (Tamamen nitelenmiş isimler Fan\Fin şeklinde isim alanı ayracı içermelerine karşın küresel isimler FanFin şeklinde isim alanı ayracı içermezler.)

    PHP bunlara ek olarak çok sayıda use deyiminin aynı satırda kullanılmasına imkan veren bir kısayola da sahiptir.

    Örnek 2 - use işleci ile rumuz/ithal, çoklu use kullanımı

    <?php
    use Bir\Tam\Sınıfadı as BirBaşkası, Bir\Tam\iAadı;

    $nesne = new BirBaşkası; // Bir\Tam\Sınıfadı sınıfını örnekler
    iAadı\altia\işlev(); // Bir\Tam\iAadı\altia\işlev işlevini çağırır
    ?>

    İthal işlemi derleme sırasında yerine getirilir ve dolayısıyla dinamik sınıf, işlev ve sabit isimlerini etkilemez.

    Örnek 3 - İthal işlemi ve dinamik isimler

    <?php
    use Bir\Tam\Sınıfadı as BirBaşkası, Bir\Tam\iAadı;

    $nesne = new BirBaşkası; // Bir\Tam\Sınıfadı sınıfını örnekler
    $a = 'BirBaşkası';
    $nesne = new $a; // BirBaşkası sınıfını örnekler
    ?>

    Bunlara ek olarak, ithal işlemi sadece nitelenmemiş ve nitelenmiş isimleri etkiler. Tamamen nitelenmiş isimler mutlak olup ithal işleminden etkilenmez.

    Örnek 4 - İthal işlemi ve tamamen nitelenmiş isimler

    <?php
    use Bir\Tam\Sınıfadı as BirBaşkası, Bir\Tam\iAadı;

    $nesne = new BirBaşkası; // Bir\Tam\Sınıfadı sınıfını örnekler
    $nesne = new \BirBaşkası; // BirBaşkası sınıfını örnekler
    $nesne = new BirBaşkası\birşey; // Bir\Tam\Sınıfadı\birşey sınıfını örnekler
    $nesne = new \BirBaşkası\birşey; // BirBaşkası\birşey sınıfını örnekler
    ?>

    İthal etki alanı kuralları

    use anahtar sözcüğü bir dosyanın en dış etki alanında veya isim alanı bildirimleri içinde kullanılmalıdır. Bunun sebebi ithal işleminin çalışma zamanında değil derleme sırasında yapılmasıdır, dolayısıyla bir bloğun etki alanında olamaz. Aşağıdaki örnekte uygun olmayan use kullanımı gösterilmiştir:

    Örnek 5 - Usülsüz ithal kuralı

    <?php
    namespace Languages;

    function     toGreenlandic()
    {
    use     Languages\Danish;

    // ...
    }
    ?>

    Bilginize:

    İthal kuralları dosyaya özeldir, yani içerilen dosyalar içeren dosyanın ithal kurallarını miras alMAyacaktır.

    Gruplu use bildirimleri

    Aynı isim alanından ithal edilen sınıflar, işlevler ve sabitler tek bir use deyiminde gruplanabilir.

    <?php

    use some\namespace\ClassA;
    use     some\namespace\ClassB;
    use     some\namespace\ClassC as C;

    use function     some\namespace\fn_a;
    use function     some\namespace\fn_b;
    use function     some\namespace\fn_c;

    use const     some\namespace\ConstA;
    use const     some\namespace\ConstB;
    use const     some\namespace\ConstC;

    // aşağıdaki gruplandırılmış use bildirimine eşdeğerdir
    use some\namespace\{ClassA, ClassB, ClassC as C};
    use function     some\namespace\{fn_a, fn_b, fn_c};
    use const     some\namespace\{ConstA, ConstB, ConstC};
    To Top