Wie funktionieren Namespaces in PHP?

Question

Accepted Answer

**Namespaces** organisieren PHP-Code und verhindern **Namenskollisionen** zwischen Klassen, Funktionen und Konstanten — das ist essentiell, da Anwendungen wachsen und Pakete von Drittanbietern nutzen. Sie funktionieren wie Verzeichnisse für Klassennamen und integrieren sich mit Composers Autoloading (PSR-4).

## Das Problem, das Namespaces lösen

```text
Without namespaces, two classes named `User` (yours and a library's) would COLLIDE
("cannot redeclare class"). Namespaces give each a unique fully-qualified name.
```

## Namespaces deklarieren und verwenden

```php
<?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
<?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();
    }
}
```

Eine Datei deklariert ihren `namespace`, und andere Dateien `use` (importieren) Klassen, um auf sie mit Kurzname zu verweisen. Der vollständig qualifizierte Name (`\App\Models\User`) ist global eindeutig.

## Namespaces werden auf Verzeichnisse abgebildet (PSR-4)

```text
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).
```

## Funktionen, Konstanten und den globalen Namespace importieren

```php
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)
```

## Warum es wichtig ist

Namespaces sind essentiell für die Organisation moderner PHP-Code und grundlegend dafür, wie das gesamte Ökosystem funktioniert.

Sie zu verstehen ist wichtig, da sie das kritische Problem von **Namenskollisionen** lösen — ohne Namespaces würden Ihre Klassen untereinander und mit vielen Drittanbieter-Paketen, die eine echte Anwendung nutzt, kollidieren (zwei `User` Klassen können nicht nebeneinander existieren), was große Anwendungen und Paket-Ökosysteme unmöglich macht.

Namespaces geben jeder Klasse einen eindeutigen vollständig qualifizierten Namen, und die **`use` Importe** lassen Sie Klassen mit Kurzname sauber referenzieren.

Am wichtigsten ist, dass Namespaces mit **Composers Autoloading via PSR-4** integrieren, wobei die Namespace-Struktur die Verzeichnisstruktur widerspiegelt, sodass Klassen automatisch bei Bedarf geladen werden — dies ist die Grundlage der modernen PHP-Projektstruktur und Dependency Management.

Da jedes moderne PHP-Framework, jedes Paket und jede Anwendung mit Namespaces organisiert ist (und Sie Composer-Pakete nicht ohne sie verstehen können), ist es Grundlagenwissen für jede moderne PHP-Entwicklung, wie man Namespaces deklariert, Klassen mit `use` importiert und wie sie sich auf Verzeichnisse für Autoloading abbilden.

Namespaces, Composer und PSR-4 Autoloading definieren zusammen, wie zeitgenössische PHP-Projekte strukturiert sind.