Namespace'ler PHP kodunu organize eder ve sınıflar, fonksiyonlar ve sabitler arasında adlandırma çatışmalarını önler — uygulamalar büyüdükçe ve üçüncü taraf paketleri kullandıkça gereklidir. Sınıf adları için dizinler gibi çalışırlar ve Composer autoloading'i (PSR-4) ile entegre olurlar.
Without namespaces, two classes named `User` (yours and a library's) would COLLIDE
("cannot redeclare class"). Namespaces give each a unique fully-qualified name.
<?php
// declare a namespace at the top of the file (matches the directory, PSR-4)
namespace App\Models;
class User { // fully-qualified name: App\Models\User
// ...
}
<?php
namespace App\Controllers;
use App\Models\User; // IMPORT a class so you can use its short name
use App\Services\Mailer as MailService; // import with an ALIAS
class UserController {
public function index() {
$user = new User(); // short name works thanks to the `use` import
// or use the fully-qualified name: new \App\Models\User();
}
}
Bir dosya namespace bildirir ve diğer dosyalar sınıflara kısa isim ile başvurmak için use (import) yaparlar. Tam nitelikli isim (\App\Models\User) global olarak benzersizdir.
Namespace File path
App\Models\User → src/Models/User.php
App\Services\Mailer → src/Services/Mailer.php
→ PSR-4 autoloading: the namespace structure mirrors the folder structure, so
Composer can find and load each class automatically (no manual require).
use function App\Helpers\format; // import a function
use const App\Config\VERSION; // import a constant
\strlen("x"); // a leading \ = the GLOBAL namespace (built-in functions)
Namespace'ler modern PHP kodunu organize etmek için gereklidir ve tüm ekosisteminin nasıl çalıştığının temelini oluştururlar.
Bunları anlamak önemlidir çünkü adlandırma çatışmalarının kritik sorununu çözerler — namespace'ler olmadan, sınıflarınız birbirleriyle ve gerçek bir uygulamanın kullandığı birçok üçüncü taraf paketi ile çatışırdı (iki User sınıfı bir arada var olamaz), bu da büyük uygulamaları ve paket ekosistemlerini imkansız hale getirirdi.
Namespace'ler her sınıfa benzersiz bir tam nitelikli isim verir ve use import'ları sınıflara kısa isimlerle temiz bir şekilde başvurmanızı sağlar.
En önemlisi, namespace'ler Composer autoloading'i PSR-4 aracılığıyla ile entegre olur; burada namespace yapısı dizin yapısını yansıtır, böylece sınıflar talep üzerine otomatik olarak yüklenir — bu, modern PHP proje yapısının ve bağımlılık yönetiminin temelini oluşturur.
Her modern PHP framework'ü, paketi ve uygulaması namespace'ler ile organize edildiğinden (ve Composer paketlerini namespace'leri anlamadan kullanamazsınız), namespace'leri declare etmeyi, use ile sınıfları import etmeyi ve autoloading için dizinlere nasıl eşlendiğini bilmek, modern PHP geliştirmesinde her gün kullanılan temel bilgidir.
Namespace'ler, Composer ve PSR-4 autoloading birlikte çağdaş PHP projelerinin nasıl yapılandırıldığını tanımlarlar.