Przestrzenie nazw organizują kod PHP i zapobiegają kolizjom nazw między klasami, funkcjami i stałymi — są niezbędne w miarę wzrostu aplikacji i używania pakietów trzecich. Działają jak katalogi dla nazw klas i integrują się z autoloadingiem Composera (PSR-4).
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();
}
}
Plik deklaruje swoją namespace, a inne pliki używają use (import) do odnoszenia się do klas przez krótką nazwę. W pełni kwalifikowana nazwa (\App\Models\User) jest globalnie unikalna.
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)
Przestrzenie nazw są niezbędne do organizowania nowoczesnego kodu PHP i stanowią fundament działania całego ekosystemu.
Zrozumienie ich jest ważne, ponieważ rozwiązują krytyczny problem kolizji nazw — bez przestrzeni nazw Twoje klasy wchodziłyby w konflikt ze sobą nawzajem i z wieloma pakietami trzecich, które używa rzeczywista aplikacja (dwie klasy User nie mogą istnieć jednocześnie), co uniemożliwia duże aplikacje i ekosystemy pakietów.
Przestrzenie nazw nadają każdej klasie unikalną w pełni kwalifikowaną nazwę, a importy use pozwalają odwoływać się do klas przez krótkie nazwy w czysty sposób.
Co ważniejsze, przestrzenie nazw integrują się z autoloadingiem Composera przez PSR-4, gdzie struktura przestrzeni nazw odzwierciedla strukturę katalogów, dzięki czemu klasy są ładowane automatycznie na żądanie — to jest fundament nowoczesnej struktury projektu PHP i zarządzania zależnościami.
Ponieważ każdy nowoczesny framework PHP, pakiet i aplikacja są zorganizowane z przestrzeniami nazw (i nie możesz używać pakietów Composera bez ich zrozumienia), wiedza o tym, jak deklarować przestrzenie nazw, importować klasy za pomocą use i jak mapują się one na katalogi do autoloadingu, jest fundamentalną, codzienną wiedzą dla każdego nowoczesnego developera PHP.
Przestrzenie nazw, Composer i autoloading PSR-4 razem definiują sposób, w jaki zorganizowane są współczesne projekty PHP.