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

2.5 KiB

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:

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:
git clone https://github.com/michaelschiemer/framework.git my-project
cd my-project
  1. Installieren Sie die Abhängigkeiten:
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:
cp .env.example .env
  1. Generieren Sie einen Anwendungsschlüssel:
php console.php app:key-generate
  1. Konfigurieren Sie Ihre Datenbankverbindung in der .env-Datei.

  2. Führen Sie die Migrationen aus:

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:

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:

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:

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 fortfahren und dann die ersten Schritte unternehmen, um Ihre erste Anwendung zu erstellen.