Imenske prostore organizirajo PHP kodo in preprečujejo trke imen med razredi, funkcijami in konstantami — bistveno je za rastejo aplikacije, ki uporabljajo zunanjedostave. Delujejo kot direktoriji za imena razredov in so integrirani s Composer avtomatskim nalaganjem (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();
}
}
Datoteka deklarira svoj namespace, druge datoteke pa use (uvozijo) razrede, da se nanje nanašajo s krajšim imenom. Polno kvalificirano ime (\App\Models\User) je globalno edinstveno.
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)
Imenske prostore so nujni za organiziranje sodobne PHP kode in so temeljni za delovanje celotnega ekosistema.
Razumevanje njih je pomembno, ker rešijo kritičen problem trkov imen — brez imenskih prostorov bi se vaši razredi med seboj in s številnimi zunanjimi paketi, ki jih prava aplikacija uporablja, košili (dva razreda User ne moreta sočasno obstajati), kar bi naredilo velike aplikacije in ekosistem paketov nemogoče.
Imenske prostore dajejo vsakemu razredu edinstveno polno kvalificirano ime, use uvozni stavki pa vam omogočajo, da se na razrede neposredno nanašate s krajšimi imeni.
Se pravi, imenske prostore so integrirani s Composer avtomatskim nalaganjem prek PSR-4, kjer struktura imenskega prostora odražava strukturo direktorija, tako da se razredi avtomatsko naložijo na zahtevo — to je temelj sodobne strukture PHP projektov in upravljanja odvisnosti.
Ker je vsak sodoben PHP okvir, paket in aplikacija organizirana z imenskimi prostori (in ne morete uporabljati Composer paketov, ne da bi jih razumeli), je poznavanje, kako deklarirati imenske prostore, uvazati razrede z use in kako se preslikujejo na direktorije za avtomatsko nalaganje, temeljna, vsakodnevna znanja za kateri koli sodoben razvoj PHP.
Imenske prostore, Composer in PSR-4 avtomatsko nalaganje skupaj določajo, kako so sodobni PHP projekti strukturirani.