Vollständige Yii2 Advanced Installation

Der Aufbau moderner Webanwendungen mit getrennten Architekturen für Frontend und Admin-Panel erfordert ein solides Fundament. Die Yii2 Advanced Template ist eine strukturierte Lösung, die genau das bietet, komplett mit einem umfassenden Benutzerverwaltungssystem. Dieser umfassende Leitfaden führt Sie durch die Installation, Konfiguration und Optimierung Ihrer Entwicklungsumgebung für diese Vorlage.

Bei der Entwicklung von Webanwendungen mittlerer bis großer Größe ist die Wahl des richtigen Frameworks entscheidend. Die Yii2 Advanced Template erweist sich als eine robustere Lösung im Vergleich zur Basic-Version. Diese Vorlage wurde speziell für Projekte entwickelt, die eine klare Trennung der Geschäftslogik zwischen dem Frontend (Endbenutzer-Anwendung) und dem Backend (Administrator-Dashboard) erfordern.

Der Hauptgrund, warum Entwickler zur Yii2 Advanced Template wechseln, ist die Verfügbarkeit eines umfassenden und einsatzbereiten Benutzerverwaltungssystems. Dies umfasst Funktionen für Registrierung, Login, Logout, E-Mail-Verifizierung und Passwort-Zurücksetzung, alle mit guten Sicherheitsstandards implementiert. Darüber hinaus ermöglicht die modulare Architektur eine spätere Erweiterung, wie das Hinzufügen separater Anwendungen für Moderator-, Manager-Rollen oder isolierte API-Dienste.

Auch lesen: Wie man HTTP/2 im Apache XAMPP aktiviert

Erforderliche Vorbereitungen vor der Installation

Bevor Sie mit der Installation der Yii2 Advanced Template beginnen, stellen Sie sicher, dass Ihre Entwicklungsumgebung alle technischen Anforderungen erfüllt. Gründliche Vorbereitung verhindert Fehler und spart Zeit.

• Webserver: Sie benötigen einen lokalen Server wie XAMPP (Windows), Laragon (Windows), MAMP (Mac) oder LAMP (Linux). Stellen Sie sicher, dass PHP Version 7.4.0 oder höher installiert ist. PHP 8.0+ wird für die neueste Leistung und Sicherheit dringend empfohlen. Laden Sie die neueste XAMPP-Version von der offiziellen Apache Friends-Website herunter.
• Composer: Dies ist ein PHP-Abhängigkeitsmanager, der obligatorisch ist. Stellen Sie sicher, dass Composer global auf Ihrem System installiert ist. Überprüfen Sie dies durch Ausführen des Befehls composer --version in der Eingabeaufforderung oder im Terminal. Falls nicht, installieren Sie ihn von GetComposer.org.
• PHP-Erweiterungen: Stellen Sie sicher, dass die folgenden Erweiterungen in Ihrer php.ini-Datei aktiv sind: pdo, pdo_mysql (oder pdo_pgsql für PostgreSQL), mbstring, openssl und intl. Diese sind in XAMPP-Paketen normalerweise standardmäßig aktiviert.
• Datenbank: Bereiten Sie einen Datenbankserver vor (MySQL/MariaDB empfohlen) und erstellen Sie eine leere Datenbank, die von der Yii2-Anwendung verwendet wird.

Schritt 1: Installation von Yii2 Advanced via Composer

Der Installationsprozess mit Composer ist die empfohlene Methode, da er alle Bibliotheksabhängigkeiten automatisch und strukturiert verwaltet.

1. Öffnen Sie die Eingabeaufforderung (Windows) oder das Terminal (Mac/Linux).
2. Navigieren Sie (cd) in das htdocs-Verzeichnis Ihres lokalen Servers (z.B. cd C:\xampp\htdocs oder cd /Applications/MAMP/htdocs).

3. Führen Sie den folgenden Installationsbefehl aus. Dieser Befehl erstellt einen neuen Ordner namens yii2-advanced, der den gesamten Vorlagencode enthält.

composer create-project --prefer-dist yiisoft/yii2-app-advanced yii2-advanced

4. Warten Sie, bis der Prozess abgeschlossen ist. Composer lädt alle erforderlichen Pakete herunter, einschließlich des Yii2-Frameworks selbst, SwiftMailer und anderer unterstützender Bibliotheken. Dieser Vorgang erfordert eine stabile Internetverbindung und kann einige Minuten dauern.

Wichtiger Hinweis für Composer 2.x: Im Gegensatz zu älteren Tutorials müssen Sie den Befehl composer global require "fxp/composer-asset-plugin:~1.1.1" nicht mehr ausführen. Dieses Plugin wird nicht mehr unterstützt und wurde durch native Methoden in Composer Version 2 ersetzt. Daher können Sie den create-project-Befehl direkt ausführen.

Auch lesen: RESTful API mit Yii2 erstellen: Kompletter Leitfaden für Anfänger

Schritt 2: Initialisierung und Grundkonfiguration

Sobald die Vorlagendateien erfolgreich heruntergeladen wurden, besteht der nächste Schritt darin, die Umgebung zu initialisieren und die Anwendung zu konfigurieren.

1. Führen Sie das Init-Skript aus: Wechseln Sie in das Projektverzeichnis (cd yii2-advanced). Führen Sie darin die Datei init.bat (Windows) oder init (Linux/Mac) im Terminal aus. Wählen Sie die Option [0] Development für den Entwicklungsmodus. Wenn eine Bestätigung angefordert wird, geben Sie yes ein.
2. Datenbank konfigurieren: Öffnen Sie die Datei common/config/main-local.php mit Ihrem bevorzugten Texteditor. Suchen Sie den Abschnitt components['db'] und passen Sie die Details Ihrer Datenbankverbindung an.

'db' => [
    'class' => 'yii\db\Connection',
    'dsn' => 'mysql:host=localhost;dbname=Ihr_Datenbankname',
    'username' => 'root', // Ihr Datenbank-Benutzername
    'password' => '', // Ihr Datenbank-Passwort
    'charset' => 'utf8',
],

3. Datenbank-Migration ausführen: Führen Sie im Terminal, weiterhin im Projektverzeichnis, den folgenden Befehl aus, um automatisch die Tabellenschemata (einschließlich der Tabelle user) zu erstellen.

php yii migrate

Drücken Sie Yes, wenn Sie zur Bestätigung der Migration aufgefordert werden. Dieser Vorgang erstellt alle erforderlichen Tabellen, einschließlich derjenigen für die Benutzerverwaltung, Protokolle und andere.

Schritt 3: Virtuellen Host konfigurieren (Empfohlen)

Um auf Frontend und Backend mit sauberen, separaten URLs zuzugreifen (z.B. yii2-frontend.test und yii2-backend.test), wird die Konfiguration eines virtuellen Hosts in Apache dringend empfohlen. Dies repliziert eine Produktionsumgebung und erleichtert die Entwicklung.

1. httpd-vhosts.conf bearbeiten: Öffnen Sie die Datei C:\xampp\apache\conf\extra\httpd-vhosts.conf (passen Sie den Pfad an, wenn sich Ihr XAMPP woanders befindet). Fügen Sie die folgende Konfiguration am Ende der Datei hinzu:

<VirtualHost *:80>
    ServerName yii2-frontend.test
    DocumentRoot "C:/xampp/htdocs/yii2-advanced/frontend/web"
    <Directory "C:/xampp/htdocs/yii2-advanced/frontend/web">
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
        # Routing-Konfiguration für Yii2 (URL Rewrite)
        RewriteEngine on
        RewriteCond %{REQUEST_FILENAME} !-f
        RewriteCond %{REQUEST_FILENAME} !-d
        RewriteRule . index.php
    </Directory>
</VirtualHost>

<VirtualHost *:80>
    ServerName yii2-backend.test
    DocumentRoot "C:/xampp/htdocs/yii2-advanced/backend/web"
    <Directory "C:/xampp/htdocs/yii2-advanced/backend/web">
        Options Indexes FollowSymLinks
        AllowOverride All
        Require all granted
        # Dieselbe Routing-Konfiguration für das Backend
        RewriteEngine on
        RewriteCond %{REQUEST_FILENAME} !-f
        RewriteCond %{REQUEST_FILENAME} !-d
        RewriteRule . index.php
    </Directory>
</VirtualHost>

2. Hosts-Datei bearbeiten: Öffnen Sie die Datei C:\Windows\System32\drivers\etc\hosts als Administrator (verwenden Sie Editor „Als Administrator ausführen“). Fügen Sie diese beiden Zeilen am Ende der Datei hinzu:

127.0.0.1   yii2-frontend.test
127.0.0.1   yii2-backend.test

3. Starten Sie Apache neu über das XAMPP-Control-Panel.

Zugriff und Test der Yii2-Anwendung

Nachdem Sie alle oben genannten Schritte abgeschlossen haben, können Sie auf Ihre Installation der Yii2 Advanced Template zugreifen und sie testen.

Auch lesen: Yii2 Login mit CAPTCHA gegen Brute-Force sichern

• Zugriff auf das Frontend: Öffnen Sie Ihren Browser und besuchen Sie http://yii2-frontend.test. Sie sehen die Startseite der Anwendung.
• Zugriff auf das Backend: Öffnen Sie http://yii2-backend.test. Sie werden zur Login-Seite des Admin-Panels weitergeleitet.

Um die Benutzerverwaltungsfunktionen zu testen, klicken Sie auf den Link „Registrieren“ auf der Frontend-Seite. Füllen Sie das Registrierungsformular mit einer E-Mail-Adresse, einem Benutzernamen und einem Passwort aus. Nach erfolgreicher Registrierung können Sie sich sofort anmelden. Testen Sie auch die Funktion „Passwort zurücksetzen“, um sicherzustellen, dass ihr Workflow korrekt funktioniert.

Fazit und nächste Schritte

Indem Sie dieser Anleitung folgen, haben Sie die Yii2 Advanced Template erfolgreich in Ihrer lokalen Entwicklungsumgebung installiert und konfiguriert. Diese Vorlage bietet eine sehr solide Grundlage für den Aufbau komplexer, skalierbarer und sicherer Webanwendungen.

Die logischen nächsten Schritte nach der Installation sind das Erlernen der in Yii2 integrierten Rollenbasierten Zugriffskontrolle (RBAC) für eine detailliertere Berechtigungsverwaltung im Backend, die Konfiguration des E-Mail-Versands für Verifizierungsfunktionen und das Verständnis der Verzeichnisstrukturen common, console, frontend und backend für eine optimale Funktionsentwicklung.