Namespaces dělí začínajícího programátora od mírné pokročilého. Co vše to obnáší?

Přiblížení jmenných prostorů

Namespaces, česky jmenné prstory, v podstatě fungují jako jakési imaginární složky pro kód. Do nich patří jednotlivé třídy. Jestli programuješ v Javě nebo v C#, budou ti důvěrně známé, protože v PHP se používají velmi podobně. Namespaces přibyly ve verzi 5.3 a byla to jedna z nejdůležitějších změn v této verzi.

Výhody použití namespaces jsou stejné jako při používání složek pro soubory v normálním systému - najednou nemusíš mít hromadu souborů na jedné hromadě, ale je možné je mít roztřídené do logických složek. Pro tři soubory v projektu to asi nemá význam, pro tři sta tříd už je to velmi zajímavé.

V různých namespaces lze používat stejně pojmenované třídy i funkce, stejně jako je možné mít stejné soubory v počítači v různých složkách. Tuto vlastnost oceníš zejména když začneš používat cizí kód - najednou můžeš přestat řešit, že si někdo pojmenoval funkci stejně jako ty, což se klidně může stát a není to nutně chyba. Pro provoz aplikace to ovšem bývá fatální.

Namespaces jsou v PHP hierarchické, můžeš je tedy vnořovat navzájem do sebe.

S namespaces úzce pracují standardy PSR-0 (zastaralý) a PSR-4. Tyto standardy určují, jak namespaces používat a vyplatí se o nich aplespoň vědět, když už ne rovnou používat.

Použití

Namespace musí být definovaný na vrchu PHP souboru, takže například jako:

<?php

namespace ApplicationOne;

// code ...

Takový soubor teď celý patří do namespacu pojemnovaného ApplicationOne. V rámci souboru je není možné zanořovat, lze ale mít více namespaces v jednou souboru, jako třeba:

<?php

namespace ApplicationOne;
// stuff

namespace DifferentOne;
// different stuff

nebo:

<?php

//alternative syntax
namespace ApplicationOne {
	// stuff
}

namespace DifferentOne {
	// different stuff
}

Takovéto řešení namespaces bych nedoporučoval, ale lze to.

Hierarchie

Používat vnořené namespaces lze třeba takto:

<?php

namespace ApplicationOne\Service;

function functionService() {
	// service stuff
}

namespace ApplicationOne\Service\Database;

class Connector {
	public static function functionStuff() {
		// stuff
	}
}

Globální namespace

Všechny třídy, funkce, proměnné a konstanty, které nemají daný namespace, jsou alokovány v globálním namespace:

<?php

// funkce v globálním namespace
function functionOne() {
	// stuff
}

Ten je dostupný pomocí znaku zpětného lomítka - \. Opět se podívej na příklad:

<?php

namespace ApplicationOne;

// volání globálního namespace v pojmenovaném namespace
\functionOne();

Volání

Když voláš třídu nebo funkci z namespace, při jejím použití musíš předsadit správný namespace se zpětným lomítkem. Příklad volání pro minulý kód:

<?php

\ApplicationOne\Service\functionService();
\ApplicationOne\Service\Database\Connector::functionStuff();

Pokud danou funkci nebo třídu potřebuješ často, je velmi nepraktické opisovat dlouhé řetězce vnořených namespaces. Proto se může používat use pro import často používaných namespaces. Příklad výše by se dal přepsat následujícím způsobem:

<?php

use ApplicationOne\Service;
use ApplicationOne\Service\Database\Connector;

Service\functionService();
Connector::functionStuff();

Tento import pomocí use se může i pojmenovat, takže je to potom spíše zkrácení názvu. Opět příklad:

<?php

use ApplicationOne\Service as Sr;
use ApplicationOne\Service\Database\Connector as C;

Sr\functionService();
C::functionStuff();

Alternativy

Pokud z nějakého důvodu nechceš používat namespaces (třeba že používáš PHP verze 5.2 nebo nižší), moc jiných možností není. Jednu z variant používá například Wordpress, který všechny své funkce pojmenovává s prefixem wp_ a tím se vyhne souběhu jmen.

Jinou možností je pečlivě si kontrolovat všechny třídy a funkce, že žádná nepoužívá stejné jméno, s čím by mohlo pomoci kvalitní IDE. V případě větších projektů se ale tato kontrola stává nezvladatelnou.

Další materiál pro studium

Pěkný třídílný souhrn v angličtině najdeš na SitePointu, delší článek na blogu Daylera Reese a vyčerpávající popis klasicky v PHP manuálu.

Too Long, Didn’t Read?

Namespaces fungují jako složky pro kód. Mohou být hirearchické. A pokud máš alespoň dvě minuty času, zkus kouknout na tutoriál z Knup univerzity.