> ## Documentation Index
> Fetch the complete documentation index at: https://kawax.biz/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Anleitung zur Installation von Laravel und zur Einrichtung einer PHP-Umgebung.

## Voraussetzungen

Bevor Sie mit Laravel starten, benötigen Sie folgende Umgebung:

* **PHP 8.3 oder höher**
* **Composer** (der Paketmanager für PHP)
* **Laravel Installer** (optional, aber empfohlen)

<Info>
  Node.js/npm oder Bun benötigen Sie zusätzlich, um Frontend-Assets zu kompilieren.
</Info>

## PHP und Laravel Installer installieren

Der einfachste Weg, PHP, Composer und den Laravel Installer gemeinsam zu installieren, ist die Ausführung des für Ihr Betriebssystem passenden Befehls.

<CodeGroup>
  ```shell macOS theme={null}
  /bin/bash -c "$(curl -fsSL https://php.new/install/mac/8.4)"
  ```

  ```powershell Windows (als Administrator ausführen) theme={null}
  Set-ExecutionPolicy Bypass -Scope Process -Force; [System.Net.ServicePointManager]::SecurityProtocol = [System.Net.ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System.Net.WebClient).DownloadString('https://php.new/install/windows/8.4'))
  ```

  ```shell Linux theme={null}
  /bin/bash -c "$(curl -fsSL https://php.new/install/linux/8.4)"
  ```
</CodeGroup>

Starten Sie nach Ausführung des Befehls Ihre Terminal-Sitzung neu.
Wenn Sie PHP und Composer bereits installiert haben, können Sie nur den Laravel Installer über Composer installieren.

```shell theme={null}
composer global require laravel/installer
```

<Tip>
  Wenn Sie ein grafisches PHP-Managementwerkzeug bevorzugen, sehen Sie sich auch [Laravel Herd](#installation-mit-laravel-herd) an.
</Tip>

## Eine neue Laravel-Anwendung erstellen

Sobald PHP, Composer und der Laravel Installer bereitstehen, legen Sie eine neue Laravel-Anwendung an.
Der Installer fragt nach dem Testframework, der Datenbank und dem Starter Kit.

```shell theme={null}
laravel new example-app
```

Nach dem Anlegen der Anwendung starten Sie den Entwicklungsserver über das Composer-Script `dev`.

```shell theme={null}
cd example-app
npm install && npm run build
composer run dev
```

Sobald der Entwicklungsserver läuft, öffnen Sie im Browser [http://localhost:8000](http://localhost:8000).

<Info>
  Ein Starter Kit erzeugt automatisch ein Grundgerüst mit Authentifizierung. In Laravel 13 wählen Sie zwischen vier Varianten: React, Vue, Svelte und Livewire.
</Info>

### Starter-Kit-Optionen

Wenn Sie `laravel new` ausführen, wählen Sie eines der folgenden Starter Kits.

<AccordionGroup>
  <Accordion title="React">
    Starter Kit mit React-Frontend über [Inertia](https://inertiajs.com). Setzt auf React 19, TypeScript, Tailwind und [shadcn/ui](https://ui.shadcn.com) und bietet eine moderne Kombination aus SPA und Server-Routing.
  </Accordion>

  <Accordion title="Vue">
    Starter Kit mit Vue-Frontend über [Inertia](https://inertiajs.com). Verwendet die Vue Composition API, TypeScript, Tailwind und [shadcn-vue](https://www.shadcn-vue.com/).
  </Accordion>

  <Accordion title="Svelte">
    Starter Kit mit Svelte-Frontend über [Inertia](https://inertiajs.com). Baut auf Svelte 5, TypeScript, Tailwind und [shadcn-svelte](https://www.shadcn-svelte.com/) auf.
  </Accordion>

  <Accordion title="Livewire">
    Starter Kit mit [Laravel Livewire](https://livewire.laravel.com). Sie erstellen dynamische UIs allein mit PHP – ideal für Teams, die primär mit Blade arbeiten. Verwendet Tailwind und [Flux UI](https://fluxui.dev).
  </Accordion>
</AccordionGroup>

<Tip>
  Wenn Sie unsicher sind, welche Variante am besten passt, lesen Sie zuerst [Frontend](/de/frontend) und vergleichen Sie Blade, Livewire, Inertia und SPA.
</Tip>

## Installation mit Laravel Herd

[Laravel Herd](https://herd.laravel.com) ist eine native Laravel-/PHP-Entwicklungsumgebung für macOS und Windows.
Sie installiert PHP, Nginx und die Laravel CLI in einem Paket.

### macOS

1. Laden Sie den Installer von der [Herd-Website](https://herd.laravel.com) herunter.
2. Nach Ausführung des Installers ist PHP automatisch konfiguriert.
3. Das Verzeichnis `~/Herd` ist als „Parked"-Verzeichnis eingerichtet.

```shell theme={null}
cd ~/Herd
laravel new my-app
cd my-app
herd open
```

### Windows

1. Laden Sie den Windows-Installer von der [Herd-Website](https://herd.laravel.com/windows) herunter.
2. Nach der Installation starten Sie Herd und schließen das Onboarding ab.
3. `%USERPROFILE%\Herd` ist das „Parked"-Verzeichnis.

```shell theme={null}
cd ~\Herd
laravel new my-app
cd my-app
herd open
```

## Grundkonfiguration

### Umgebungskonfiguration

Viele Konfigurationswerte in Laravel unterscheiden sich je nach Umgebung.
Daher werden zentrale Werte in der Datei `.env` im Projekt-Root verwaltet.

<Warning>
  Committen Sie die `.env`-Datei nicht in die Versionskontrolle.
  Es besteht das Risiko, sensible Informationen preiszugeben.
</Warning>

### Datenbank konfigurieren

Standardmäßig ist Laravel für SQLite konfiguriert.
Wenn Sie MySQL oder PostgreSQL verwenden möchten, passen Sie die `.env`-Datei an.

```ini theme={null}
DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=root
DB_PASSWORD=
```

Wenn Sie eine andere Datenbank als SQLite verwenden, führen Sie anschließend die Migrationen aus, um die Tabellen anzulegen.

```shell theme={null}
php artisan migrate
```

## IDE-Unterstützung

<AccordionGroup>
  <Accordion title="VS Code / Cursor">
    Mit der offiziellen [Laravel VS Code Extension](https://marketplace.visualstudio.com/items?itemName=laravel.vscode-laravel) erhalten Sie Syntax-Highlighting, Snippets, Artisan-Integration sowie intelligente Autovervollständigung für Eloquent-Modelle.
  </Accordion>

  <Accordion title="PhpStorm">
    [PhpStorm](https://www.jetbrains.com/phpstorm/laravel/) bringt eingebaute Laravel-Unterstützung mit intelligenter Autovervollständigung für Blade-Templates, Eloquent-Modelle, Routen, Views und Übersetzungen mit.
  </Accordion>
</AccordionGroup>

## Nächste Schritte

<Card title="Verzeichnisstruktur" icon="folder-open" href="/de/directory-structure">
  Lernen Sie die wichtigsten Verzeichnisse und Dateien eines Laravel-Projekts kennen.
</Card>


## Related topics

- [Laravel Reverb](/de/reverb.md)
- [Laravel Console Starter](/de/packages/laravel-console-starter/index.md)
- [Laravel Boost](/de/boost.md)
- [Laravel Telescope](/de/telescope.md)
- [Laravel Prompts](/de/prompts.md)
