Files
michaelschiemer/docs/getting-started/installation.md
Michael Schiemer 55a330b223 Enable Discovery debug logging for production troubleshooting
- Add DISCOVERY_LOG_LEVEL=debug
- Add DISCOVERY_SHOW_PROGRESS=true
- Temporary changes for debugging InitializerProcessor fixes on production
2025-08-11 20:13:26 +02:00

109 lines
2.5 KiB
Markdown

# Installation
Diese Anleitung führt Sie durch den Installationsprozess des Frameworks.
## Systemanforderungen
Bevor Sie mit der Installation beginnen, stellen Sie sicher, dass Ihr System die folgenden Anforderungen erfüllt:
- PHP 8.1 oder höher
- Composer 2.0 oder höher
- Node.js 16 oder höher (für Frontend-Assets)
- MySQL 8.0 oder höher (optional, wenn Sie MySQL als Datenbank verwenden)
- SQLite 3 (für Entwicklung und Tests)
## Installation über Composer
Die einfachste Methode zur Installation ist über Composer:
```bash
composer create-project michaelschiemer/framework my-project
cd my-project
```
## Manuelle Installation
Alternativ können Sie das Framework auch manuell installieren:
1. Klonen Sie das Repository:
```bash
git clone https://github.com/michaelschiemer/framework.git my-project
cd my-project
```
2. Installieren Sie die Abhängigkeiten:
```bash
composer install
npm install
```
## Konfiguration nach der Installation
Nach der Installation müssen Sie einige grundlegende Konfigurationen vornehmen:
1. Erstellen Sie eine Kopie der `.env.example`-Datei und benennen Sie sie in `.env` um:
```bash
cp .env.example .env
```
2. Generieren Sie einen Anwendungsschlüssel:
```bash
php console.php app:key-generate
```
3. Konfigurieren Sie Ihre Datenbankverbindung in der `.env`-Datei.
4. Führen Sie die Migrationen aus:
```bash
php console.php db:migrate
```
## Überprüfung der Installation
Um zu überprüfen, ob die Installation erfolgreich war, können Sie den eingebauten Entwicklungsserver starten:
```bash
php console.php serve
```
Öffnen Sie dann Ihren Browser und navigieren Sie zu `http://localhost:8000`. Sie sollten die Startseite des Frameworks sehen.
## Fehlerbehebung
### Häufige Probleme
#### Composer-Fehler
Wenn Sie Probleme mit Composer haben, versuchen Sie, den Cache zu leeren:
```bash
composer clear-cache
```
#### Berechtigungsprobleme
Stellen Sie sicher, dass die folgenden Verzeichnisse für den Webserver beschreibbar sind:
- `storage/`
- `cache/`
- `logs/`
Sie können die Berechtigungen mit dem folgenden Befehl ändern:
```bash
chmod -R 775 storage cache logs
```
#### Datenbank-Verbindungsprobleme
Überprüfen Sie Ihre Datenbankverbindungseinstellungen in der `.env`-Datei. Stellen Sie sicher, dass der Datenbankbenutzer die richtigen Berechtigungen hat.
## Nächste Schritte
Nachdem Sie das Framework erfolgreich installiert haben, können Sie mit der [Konfiguration](configuration.md) fortfahren und dann die [ersten Schritte](first-steps.md) unternehmen, um Ihre erste Anwendung zu erstellen.