Namespace-urile organizează codul PHP și previn coliziunile de nume între clase, funcții și constante — esențiale pe măsură ce aplicațiile cresc și folosesc pachete terță parte. Funcționează ca directoare pentru nume de clase și se integrează cu autoîncărcarea Composer (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();
}
}
O fișier declară namespace-ul și alte fișiere folosesc use (import) pentru clase pentru a le referi prin nume scurt. Numele pe deplin calificat (\App\Models\User) este unic la nivel global.
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-urile sunt esențiale pentru organizarea codului PHP modern și sunt fundamentale pentru funcționarea întregului ecosistem.
Înțelegerea lor este importantă pentru că rezolvă problema critică a coliziunilor de nume — fără namespace-uri, clasele tale ar intra în conflict între ele și cu numeroasele pachete terță parte pe care le folosește o aplicație reală (două clase User nu pot coexista), ceea ce face imposibile aplicațiile mari și ecosistemele de pachete.
Namespace-urile dau fiecărei clase un nume unic pe deplin calificat, iar importurile use te lasă să referi clase prin nume scurt, curat.
Cel mai important, namespace-urile se integrează cu autoîncărcarea Composer prin PSR-4, unde structura namespace-ului reflectă structura directoarelor, astfel încât clasele sunt încărcate automat la cerere — aceasta este baza structurii proiectelor PHP moderne și a managementului dependențelor.
Întrucat fiecare framework PHP modern, pachet și aplicație este organizată cu namespace-uri (și nu poți folosi pachete Composer fără a le înțelege), cunoașterea modului de declarare a namespace-urilor, importarea claselor cu use și modul în care se mapează la directoare pentru autoîncărcare este cunoștințe fundamentale, zilnice pentru orice dezvoltare PHP modernă.
Namespace-urile, Composer și autoîncărcarea PSR-4 definesc împreună modul în care sunt structurate proiectele PHP contemporane.