Namespaces organizam código PHP e previnem conflitos de nomes entre classes, funções e constantes — essencial conforme as aplicações crescem e usam pacotes de terceiros. Eles funcionam como diretórios para nomes de classe e se integram com o carregamento automático do 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();
}
}
Um arquivo declara seu namespace, e outros arquivos use (importam) classes para se referir a elas pelo nome curto. O nome totalmente qualificado (\App\Models\User) é globalmente único.
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)
Namespaces são essenciais para organizar código PHP moderno e são fundamentais para como todo o ecossistema funciona.
Entendê-los é importante porque resolvem o problema crítico de conflitos de nomes — sem namespaces, suas classes entrariam em conflito umas com as outras e com os muitos pacotes de terceiros que uma aplicação real usa (duas classes User não podem coexistir), tornando grandes aplicações e ecossistemas de pacotes impossíveis.
Namespaces dão a cada classe um nome totalmente qualificado único, e os imports use permitem que você referencie classes por nomes curtos de forma limpa.
Mais importante ainda, namespaces se integram com carregamento automático do Composer via PSR-4, onde a estrutura de namespace espelha a estrutura de diretórios para que as classes sejam carregadas automaticamente sob demanda — essa é a base da estrutura de projeto PHP moderno e do gerenciamento de dependências.
Como todo framework PHP moderno, pacote e aplicação é organizado com namespaces (e você não pode usar pacotes do Composer sem entendê-los), saber como declarar namespaces, importar classes com use e como eles mapeiam para diretórios para carregamento automático é conhecimento fundamental e do dia a dia para qualquer desenvolvimento PHP moderno.
Namespaces, Composer e carregamento automático PSR-4 juntos definem como projetos PHP contemporâneos são estruturados.