Wie man GEMVC installiert

15 minutes ANFÄNGER

GEMVC in wenigen Minuten auf Ihrem System installieren. Wir behandeln Systemanforderungen, die Docker Installation (empfohlen) und manuelle Setup Optionen.

What You'll Learn

Systemanforderungen

Was Sie vor der Installation brauchen

Docker Installation

Schnelles Setup mit Docker (empfohlen)

Watch Tutorial

Installieren Sie mit Composer und beginnen Sie mit dem Bau Ihrer API. Sie erhalten eine vollständige und sofort einsatzbereite Container Entwicklungsumgebung mit einfacher optionaler Kommandozeilen Einrichtung ( PHP, MySQL, Redis, PHPMyAdmin und mehr) auf Ihrem lokalen Rechner und der Wahl des Webservers ( Apache, Nginx oder OpenSwoole).

Voraussetzungen

Grundkenntnisse in PHP und Kommandozeile
Ein Computer mit Internetverbindung
Texteditor oder IDE (VS Code, PHPStorm usw.)

Systemanforderungen für Ihre Entwicklungsumgebung

Mindestanforderungen

PHP Version

PHP 8.1 oder höher

installiertes Docker Desktop

Abhängig vom Betriebssystem (Windows, macOS, Linux) auf Ihrem lokalen Rechner

Composer

Neueste Version

Hinweis: Für OpenSwoole Unterstützung sind PHP 8.2+ und die OpenSwoole Erweiterung nötig, wenn Sie nicht Docker verwenden.

Anforderungen prüfen (Empfohlen)

Warum Docker? Es bietet eine konsistente Umgebung mit allen vorkonfigurierten Abhängigkeiten. Es stellt NICHT NUR sicher, "dass es auf meinem Rechner funktioniert", sondern Docker garantiert, dass es überall funktionieren wird!

Installieren Sie Docker Desktop, falls Sie es nicht auf Ihrem lokalen Rechner installiert haben

Laden Sie Docker Desktop von docker.com herunter
Installieren und starten Sie Docker Desktop
Überprüfen Sie die Installation durch Ausführen von:

Terminal

docker --version

Composer prüfen

Führen Sie diesen Befehl aus, um zu prüfen, ob Composer installiert ist:

Terminal

composer --version

Wenn Sie Composer nicht installiert haben, können Sie Composer von getcomposer.org herunterladen und installieren.

Projekt initialisieren

Schritt 1.1: Neuen Ordner erstellen

Erstellen Sie ein neues Verzeichnis für Ihr Projekt (überall auf Ihrem PC, wo Sie möchten), zum Beispiel "my-gemvc-project", und navigieren Sie dorthin:

Terminal

mkdir my-gemvc-project
cd my-gemvc-project

Schritt 1.2: GEMVC Bibliothek über Composer herunterladen

Führen Sie diesen Befehl aus, um die GEMVC Bibliothek im Stammverzeichnis Ihres Projekts herunterzuladen:

Terminal

composer require gemvc/library

Schritt 1.3: Projekt initialisieren

Gemvc wird mit einem leistungsstarken Initialisierungsbefehl geliefert. Dieser erstellt die Projektstruktur und eine .env Datei, sowie eine Docker Datei und eine Dockercompose Datei für Ihr Projekt mit Standardeinstellungen, basierend auf Ihrer Wahl des Servertyps (Apache, Nginx oder OpenSwoole).

Befolgen Sie einfach die Anweisungen im Terminal, nachdem Sie den Befehl ausgeführt haben. Sie können zwischen Apache, Nginx oder OpenSwoole als Servertyp wählen.

Terminal

php vendor/bin/gemvc init

Wenn Sie sehen, dass das Projekt erfolgreich initialisiert wurde, herzlichen Glückwunsch! 🎉 Das Projekt ist jetzt initialisiert und bereit für Docker!

Installation abschließen

Schritt 4.1: Ihre Anwendung "dockerisieren"

Prüfen Sie, ob Docker Desktop läuft, und führen Sie dann den folgenden Befehl aus:

Terminal

docker compose up -d --build

Sie können auf Ihre API unter http://localhost:9504 zugreifen, wenn Sie OpenSwoole gewählt haben, oder unter http://localhost:80, wenn Sie Apache oder Nginx als Servertyp während der Initialisierung gewählt haben.

Wenn Sie sehen, dass GEMVC läuft, herzlichen Glückwunsch! 🎉 GEMVC ist jetzt erfolgreich installiert!

Schritt 3.3: Datenbank initialisieren

Gemvc wird mit einer MySql Datenbank geliefert, die in Ihrer docker-compose.yml Datei definiert ist, und mit Datenbank Anmeldeinformationen in Ihren .env Dateien, die sich im Stammverzeichnis Ihres Projekts befinden. Sie können Ihre Datenbank einfach initialisieren, indem Sie nach dem Ausführen von Schritt 4.1 den folgenden Befehl in Ihrem Terminal ausführen:

Terminal

php vendor/bin/gemvc db:init

Dieser Befehl erstellt die Datenbank und macht sie bereit, die Tabellen in Ihrer Datenbank zu erstellen.

Sie sollen im Terminal sehen, dass die Datenbank erfolgreich initialisiert wurde, nachdem Sie den Befehl ausgeführt haben.

🎉 Installation abgeschlossen!

Super gemacht! Sie haben GEMVC erfolgreich installiert und die Datenbank initialisiert. Jetzt bauen wir Ihre erste API!

Weiter: Ihre erste CRUD API Zurück zum Lernzentrum Technische Dokumentation anzeigen

Häufige Probleme & Lösungen

Port 8000 ist bereits belegt

Ändern Sie den Port in Ihrem Befehl:

Terminal

php -S localhost:8080 -t public

Composer Befehl nicht gefunden

Stellen Sie sicher, dass Composer installiert ist und sich in Ihrem System PATH befindet. Laden Sie es herunter von:

https://getcomposer.org

Datenbankverbindung fehlgeschlagen

Überprüfen Sie die Datenbank Anmeldeinformationen Ihrer .env Datei und stellen Sie sicher, dass MySQL/PostgreSQL läuft.

Terminal

# Testen Sie die MySQL Verbindung
mysql -u root -p